weichen
2cea785eee
ci / test (pull_request) Successful in 1m55s
Why: The submodule pull requests landed as merge commits, and the parent pin must include those tips so the composed tree keeps both this fix and the commits that arrived on submodule main. Evidence: Frontend main is 8be98b4 (contains e4ca2ac); Backend main is 28ccb74 (contains 51b1ff6). Impact: Dev #161 now pins the commits that are already on each submodule main. Refs: Frontend #38, Backend #54, Dev #161
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 系统文档与过程记录
modules/ui Agent-System-UI UI 组件库（词汇渲染器/设计令牌/收件箱卡片工作区组件）
deps/development-guidelines 开发规范（gitlink 固定版本）
deps/agent-native deps/agent-squad deps/agent-intent 生态执行/编排/意图
deps/agent-command Agent-Command 命令总线基础库（spec/注册表/危险分级/审计信封）
deps/error-code-system deps/logging-system 基础设施
plugins/ 示例插件与插件开发参考（P4 起填充）
父仓 gitlink 是各组件源码版本的权威；构建、审核与发布固定提交，不执行 submodule update --remote。
常用命令
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 决策记录）。
本机服务管理（后端/前端/数据库部署、生命周期、备份克隆）：docs/svc.md（scripts/svc.sh）。