# Agent-System-Dev 项目事实

- 用途：开发集成父仓（gitlink 权威）；非分发单元。
- 组合：modules/{core,backend,frontend,ui,documents} + deps/{development-guidelines,agent-native,agent-squad,agent-intent,agent-command,error-code-system,logging-system}。
- 部署：非容器；Releases 仓从本仓固定提交导出版本。

## 方向与规划入口

长期方向、目标及跨任务规划从过程仓的 [项目方向与规划索引](modules/documents/docs/proposals/INDEX.md)
查找主记录、里程碑和关联任务；原始正文沿用 [方案与规划目录](modules/documents/docs/proposals/)。
确立或调整具体方向时，在本入口维护其主记录链接；正文、确认依据和进展仍以该主记录为准。
目录中的既有文档不因被收录而自动成为已批准规划。记录、任务关联及收尾建议按
[交付规范的长期方向与任务衔接](policy/delivery.md#长期方向与任务衔接) 执行。

新增方向：[Generative UI 调研与插件方案 r2](modules/documents/docs/proposals/2026-10-10-generative-ui-plugin.md)。
2026-10-11 用户裁定首试点（对话内分析页）、可信编译插件交付与试验参数；U1 受控试验当日完成
（结构分化 6/6、生成走工具参数通道、首期自研 renderer，详见方案「U1 结果与 r2 修订」）；
U2 起实施与部署分别评审。

- [多人协作存储与分布式演进方案](modules/documents/docs/proposals/2026-10-11-collaboration-storage-and-distribution.md)：
  10–100 人、多项目、多会话并行；PostgreSQL 团队档、迁移恢复与多实例执行。方案 r1 已批准
  （2026-10-11，用户指示「按方案开始改造」），实施自首选增量 U1+U2 启动。

- [RDM 两树一网集成、完善与追溯审计展示方案](modules/documents/docs/proposals/2026-10-11-rdm-two-trees-trace-audit-integration.md)：
  每项目一套笔记树、文档树与追溯网；项目绑定与读取授权闭环、原子事件历史、统一审计读服务
  与四入口工作区。方案 r1 已获用户评审通过（2026-10-11，五阶段一并，KTD4 双层管理员裁定）；
  U1、U2、U3 已实施合入（RDM PR #195、#197、#201，2026-10-11；超管槽待基座能力
  接线，申请见 RDM 仓 docs/proposals/2026-10-11-u1-base-extension-requests.md）；
  U4–U5 与运行验收未启动。

- [RDM 模板与两树一网对话文档生成方案 r1.1](modules/documents/docs/proposals/2026-10-11-rdm-template-dialog-generation.md)：69 类历史资产盘点、模板版本与章节实例化、持久提案、文档级审签及 DOCX；待用户评审，业务实施与运行验收 NOT_RUN。 首批项目建议书/竞品分析、随后扩展全部文档已确认（2026-10-11），其余方案与实施仍待评审。

- [RDM 最终目标核对与完整交付方案 r1](modules/documents/docs/proposals/2026-10-11-rdm-final-target-completion.md)：系统级项目、上限内权限覆盖、私域协作、全部文档三权与完整业务链；34 UR／68 SR／10 F 逐条映射；方案已随 #340 合入（2026-10-11），U1 需求基线核对经 RDM #199/#200 落地，U2 起未启动。

## 验证

`make test` 先核对子模块工作树与固定指针，再运行治理脚本、公开边界、跨仓指针、库及各模块
测试。实际目标以根 Makefile 为准。`make test-governance` 可独立检查开发门禁，使用临时
真实仓库，不访问生产数据；操作与证据要求见 [开发门禁](policy/governance.md)。

`make build` 在 backend 模块内编译，replace 指向该模块自己的 `deps/`；
`scripts/check-pins.sh` 核对这些 gitlink 与 Dev 顶层指针，`make test-worktree` 另核对
真正被测的组件工作树。两者分别验证固定组合与实际检出，不能相互替代。

未加 go.work：工作区最小版本选择会抬高 backend 单独构建使用的部分 `golang.org/x` 版本。
发布消费方须从固定 Dev 提交递归物化后运行 `make build`，再核验制品与实际运行状态。