Files
Agent-System-Dev/README.md
T
weichen 15f0da6374 Wire Agent-System-UI and Agent-Command into the Dev combo
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
2026-09-30 05:56:08 +00:00

2.0 KiB
Raw Blame History

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 决策记录)。