weichen
15f0da6374
Why: Foundation task T0 of the UI/interaction base (proposal 2026-09-30, D25-D33): add the new UI component library and command-bus ecosystem repos, extend build/test/pin orchestration to twelve submodules. Evidence: make test green on the pinned combo (core + backend 13 pkgs + frontend 9 + ui 6 tests); make build produces bin/agent-system with combo version string including ui; make contracts now generates to frontend and ui with submodules staying clean; renderer/tokens migration verified CSS-rule-identical (zero behavior change). Impact: New modules/ui and deps/agent-command gitlinks; frontend consumes ui via source alias; backend vendors agent-command (replace only, no import yet); follows provider-first merges (ui PR#1/#2, agent-command PR#1, documents PR#8, frontend PR#2, backend PR#6). Refs: modules/documents docs/proposals/2026-09-30-ui-inbox-command-workspace.md
40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
# 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`。
|
||
|
||
## 常用命令
|
||
|
||
```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 决策记录）。
|