Assemble the dev integration repo: submodules, cross-repo Makefile, and repo guides
Details (original message): Assemble the dev integration repo: submodules, cross-repo Makefile, and repo guides.
This commit is contained in:
@@ -0,0 +1,2 @@
|
||||
/bin/
|
||||
node_modules/
|
||||
+30
@@ -0,0 +1,30 @@
|
||||
[submodule "modules/core"]
|
||||
path = modules/core
|
||||
url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Core.git
|
||||
[submodule "modules/backend"]
|
||||
path = modules/backend
|
||||
url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Backend.git
|
||||
[submodule "modules/frontend"]
|
||||
path = modules/frontend
|
||||
url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Frontend.git
|
||||
[submodule "modules/documents"]
|
||||
path = modules/documents
|
||||
url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Documents.git
|
||||
[submodule "deps/development-guidelines"]
|
||||
path = deps/development-guidelines
|
||||
url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Development-Guidelines.git
|
||||
[submodule "deps/agent-native"]
|
||||
path = deps/agent-native
|
||||
url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Native.git
|
||||
[submodule "deps/agent-squad"]
|
||||
path = deps/agent-squad
|
||||
url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Squad.git
|
||||
[submodule "deps/agent-intent"]
|
||||
path = deps/agent-intent
|
||||
url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Intent.git
|
||||
[submodule "deps/error-code-system"]
|
||||
path = deps/error-code-system
|
||||
url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Error-Code-System.git
|
||||
[submodule "deps/logging-system"]
|
||||
path = deps/logging-system
|
||||
url = ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Logging-System.git
|
||||
@@ -0,0 +1,9 @@
|
||||
# Agent 工作说明(Agent-System-Core)
|
||||
|
||||
本仓开发遵循 Development-Guidelines(见 Dev 仓 `development/guidelines`,gitlink 固定版本):
|
||||
核心规则与术语见其 `core/`,按任务触发阅读 `standards/` 专题;日常交付走 `workflows/delivery.md`。
|
||||
|
||||
仓内规则:
|
||||
- 模块边界、公开契约与隔离档位见 `policy/modules/`(如有)与 PROJECT.md。
|
||||
- 提交信息用英文祈使句一行;跨仓 gitlink 变更须经组合验证后在 Dev 仓推进。
|
||||
- 验证命令见 PROJECT.md「验证」节;完成声明须附实际命令输出证据。
|
||||
@@ -0,0 +1,53 @@
|
||||
# Agent-System-Dev 顶层编排
|
||||
# 用法:make sync && make build && make test
|
||||
# 部署约束:非容器化;默认产物为单二进制(见 modules/backend)。
|
||||
|
||||
SHELL := /bin/bash
|
||||
CORE := modules/core
|
||||
BACKEND := modules/backend
|
||||
FRONTEND := modules/frontend
|
||||
BIN := bin/agent-system
|
||||
EMBED_DIR := $(BACKEND)/web/dist
|
||||
|
||||
.PHONY: help sync status build frontend test test-backend test-frontend test-core dev release clean
|
||||
|
||||
help:
|
||||
@echo "make sync 物化全部 submodule(递归)"
|
||||
@echo "make build 构建单二进制 bin/agent-system(前端 embed + 静态链接)"
|
||||
@echo "make test 全量测试(core + backend + frontend)"
|
||||
@echo "make dev 开发模式说明(前后端分离热更新)"
|
||||
@echo "make status submodule 状态"
|
||||
|
||||
sync:
|
||||
git submodule update --init --recursive
|
||||
|
||||
status:
|
||||
@git submodule status
|
||||
|
||||
frontend:
|
||||
cd $(FRONTEND) && npm ci --no-fund --no-audit && npm run build
|
||||
rm -rf $(EMBED_DIR) && mkdir -p $(EMBED_DIR) && cp -r $(FRONTEND)/dist/* $(EMBED_DIR)/
|
||||
|
||||
build: frontend
|
||||
cd $(BACKEND) && CGO_ENABLED=0 go build -trimpath -ldflags "-s -w" -o ../../$(BIN) ./cmd/agent-system
|
||||
|
||||
test-core:
|
||||
cd $(CORE) && go test ./...
|
||||
|
||||
test-backend:
|
||||
cd $(BACKEND) && go test ./...
|
||||
|
||||
test-frontend:
|
||||
cd $(FRONTEND) && npm ci --no-fund --no-audit && npm test -- --run
|
||||
|
||||
test: test-core test-backend test-frontend
|
||||
|
||||
dev:
|
||||
@echo "开发模式(原生,非容器):"
|
||||
@echo " 1. make sync"
|
||||
@echo " 2. 终端 A:cd $(BACKEND) && go run ./cmd/agent-system serve --addr 127.0.0.1:8787 --data ./data"
|
||||
@echo " 3. 终端 B:cd $(FRONTEND) && npm ci && npm run dev # Vite 代理到 8787"
|
||||
@echo " 4. 浏览器打开 Vite 提示的地址;mock 对话不需要模型密钥。"
|
||||
|
||||
clean:
|
||||
rm -rf $(BIN) $(FRONTEND)/dist $(FRONTEND)/node_modules
|
||||
@@ -0,0 +1,6 @@
|
||||
# Agent-System-Dev 项目事实
|
||||
|
||||
- 用途:开发集成父仓(gitlink 权威);非分发单元。
|
||||
- 组合:modules/{core,backend,frontend,documents} + deps/{development-guidelines,agent-native,agent-squad,agent-intent,error-code-system,logging-system}。
|
||||
- 验证:make test(core+backend+frontend 全量);make build 产出 bin/agent-system。
|
||||
- 部署:非容器;Releases 仓从本仓固定提交导出版本。
|
||||
@@ -0,0 +1,37 @@
|
||||
# Agent-System-Dev
|
||||
|
||||
Agent-System 的开发集成仓(父仓):以 submodule 固定全部模块组合,承载跨仓构建、测试编排与原生(非容器)开发环境。**非分发单元**——发布物在 Agent-System-Releases。
|
||||
|
||||
## 组合结构
|
||||
|
||||
```
|
||||
modules/core Agent-System-Core 核心契约(领域模型/事件协议/插件 API/设置与 UI 词汇)
|
||||
modules/backend Agent-System-Backend 后端单二进制(内嵌前端与嵌入式 SQLite)
|
||||
modules/frontend Agent-System-Frontend 前端(React 19 + Vite + TS)
|
||||
modules/documents Agent-System-Documents 系统文档与过程记录
|
||||
deps/development-guidelines 开发规范(gitlink 固定版本)
|
||||
deps/agent-native deps/agent-squad deps/agent-intent 生态执行/编排/意图
|
||||
deps/error-code-system deps/logging-system 基础设施
|
||||
plugins/ 示例插件与插件开发参考(P4 起填充)
|
||||
```
|
||||
|
||||
父仓 gitlink 是各组件源码版本的权威;构建、审核与发布固定提交,不执行 `submodule update --remote`。
|
||||
|
||||
## 常用命令
|
||||
|
||||
```bash
|
||||
make sync # 物化全部 submodule(递归)
|
||||
make build # 构建单二进制 bin/agent-system
|
||||
make test # 全量测试
|
||||
make dev # 开发模式说明(前后端分离热更新)
|
||||
```
|
||||
|
||||
## 约束(全局)
|
||||
|
||||
- 非容器化部署:默认单二进制,必要时拆分多个原生二进制;不发布容器镜像。
|
||||
- 依赖方向:frontend→core←backend;插件只依赖 core;生态仓依赖纪律沿用各仓既有约定。
|
||||
- 开发规范:`deps/development-guidelines`(见各仓 AGENTS.md)。
|
||||
|
||||
## 文档
|
||||
|
||||
设计方案:`modules/documents/docs/proposals/2026-09-29-system-skeleton-design-and-plan.md`(含 D1–D16 决策记录)。
|
||||
+1
Submodule deps/agent-intent added at ad447c55de
+1
Submodule deps/agent-native added at f735f18a73
+1
Submodule deps/agent-squad added at b6ff0ab55f
+1
Submodule deps/development-guidelines added at 26b562d2e3
+1
Submodule deps/error-code-system added at dbeed2f1b6
+1
Submodule deps/logging-system added at 2c5716fdcf
Submodule
+1
Submodule modules/backend added at 6832b7f0da
Submodule
+1
Submodule modules/core added at f2fcc2f62e
Submodule
+1
Submodule modules/documents added at e13eb5c38e
Submodule
+1
Submodule modules/frontend added at a80fae7dc6
@@ -0,0 +1,3 @@
|
||||
# plugins/
|
||||
|
||||
示例插件与插件开发参考(P4 起填充;插件开发指南见 modules/documents/docs/guides/)。
|
||||
Reference in New Issue
Block a user