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:
weichen
2026-09-29 17:31:39 +00:00
commit 6eaa9b6bea
17 changed files with 150 additions and 0 deletions
+2
View File
@@ -0,0 +1,2 @@
/bin/
node_modules/
+30
View File
@@ -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
+9
View File
@@ -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「验证」节;完成声明须附实际命令输出证据。
+53
View File
@@ -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
+6
View File
@@ -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 仓从本仓固定提交导出版本。
+37
View File
@@ -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 决策记录)。
Vendored Submodule
+1
Submodule deps/agent-intent added at ad447c55de
Vendored Submodule
+1
Submodule deps/agent-native added at f735f18a73
Vendored Submodule
+1
Submodule deps/agent-squad added at b6ff0ab55f
Vendored Submodule
+1
Submodule deps/error-code-system added at dbeed2f1b6
Vendored Submodule
+1
Submodule deps/logging-system added at 2c5716fdcf
+1
Submodule modules/backend added at 6832b7f0da
Submodule
+1
Submodule modules/core added at f2fcc2f62e
+1
Submodule modules/documents added at e13eb5c38e
+1
Submodule modules/frontend added at a80fae7dc6
+3
View File
@@ -0,0 +1,3 @@
# plugins/
示例插件与插件开发参考(P4 起填充;插件开发指南见 modules/documents/docs/guides/)。