# Agent-System-Dev 项目事实

- 用途：开发集成父仓（gitlink 权威）；非分发单元。
- 组合：`modules/`（产品组件）+ `deps/`（共享依赖）；完整组件清单以 [`.gitmodules`](.gitmodules) 为准。
- 部署：非容器；Releases 仓从本仓固定提交导出版本。

## 验证

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

`scripts/agent-exec validate --repo .` 核验 `AGENT-EXECUTION.md`，`scripts/dm governance check --repo .` 核验治理 kit 入口与采纳状态（只读）；二者均在 CI 中运行。

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

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

多个分支向 Dev main 交付时按 [合入调度](policy/delivery.md#合入调度) 执行；实际采纳范围见 [采纳记录](policy/adoption.md)。

## 法规知识库组合

- 计划：[法规知识库计划](docs/superpowers/plans/2026-10-18-regulations-knowledge-base-plan.md)（U8 固定组合）；进展与批准状态以该计划、任务卡与 PR 为准。
- 固定版本：Dev 侧模块以 gitlink 与 `.gitmodules` 为准；RDM 与 KB-Regulations 提交以
  `tests/integration/regulations-kb/components.pin`（`rdm_sha`、`kb_sha`）为准。KB 经 RDM 的
  `pins/agent-system-kb-regulations` gitlink 接入，门禁要求该 gitlink 是 `kb_sha` 的祖先。
- 凭据变量：`KBREG_DATABASE_URL`、`KBREG_EMBED_API_KEY`、`KBREG_SEARCH_ZHIPU_API_KEY`、`KBREG_MINERU_TOKEN`
  （测试库用 `KBREG_TEST_DATABASE_URL`）。按环境注入、轮换与撤销见 KB 仓 `docs/operations/runbook.md`；值不入仓、不回显。
- 门禁：`make test-regulations-kb` 需 `KBREG_TEST_DATABASE_URL`、`SVC_RDM_SRC_DIR`、`KB_SRC_DIR`，
  独立于 `make test`、不纳入其中；说明见 [tests/integration/regulations-kb/README.md](tests/integration/regulations-kb/README.md)。
  该门禁通过不代表部署、版本发布或业务/法务验收完成。

## 方向与规划入口

长期方向、目标及跨任务规划从过程仓的 [项目方向与规划索引](modules/documents/docs/proposals/INDEX.md)
查找主记录、里程碑和关联任务；原始正文沿用 [方案与规划目录](modules/documents/docs/proposals/)。
确立或调整具体方向时，在本入口维护其主记录链接；记录、任务关联及收尾建议按
[交付规范的长期方向与任务衔接](policy/delivery.md#长期方向与任务衔接) 执行。

下列条目只是主题索引：批准、进展、验收与部署状态一律以所链主记录、任务卡与 PR 为准，
本入口不复制；收录不构成批准。

- [分层分支交付与规范精简](modules/documents/docs/proposals/2026-10-18-delivery-model-v3.md)：两级分支、任务卡合入前闭合、分级门禁、任务分类通道与规范精简。
- [文档职责矩阵整改](modules/documents/docs/proposals/2026-10-15-rdm-duty-matrix-rework.md)：项目设置的文档职责三视图分配。
- [svc 插件组合部署（--with）](modules/documents/docs/proposals/2026-10-14-svc-plugin-compose-deploy.md)：部署时把登记插件与 Dev 基座编成一个二进制并校验激活。
- [用户、职位角色与分层权限统一](modules/documents/docs/proposals/2026-10-13-identity-role-permission-plan.md)：
  [I1 权限合同](modules/documents/docs/proposals/2026-10-13-iam-i1-permission-contract.md)、
  [I1 实施候选与评审记录](modules/documents/docs/proposals/2026-10-13-iam-i1-review.md)。
- [系统项目、成员工作入口与私域协作闭环](modules/documents/docs/proposals/2026-10-13-system-project-membership.md)：全局项目身份与名称、成员个人会话、每项目两树一网与私域权限。
- [快慢通道展示与动态工作摘要](modules/documents/docs/proposals/2026-10-12-fast-slow-channel-display.md)：对话即时答复、后台动态发现与来源、四层阅读、真实状态、并发/恢复；
  [U1 实施计划](modules/documents/docs/proposals/2026-10-12-fast-slow-channel-display-u1-plan.md)。
- [渐进工作台界面重设计](modules/documents/docs/proposals/2026-10-12-work-companion-ui-design.md)：
  [计划](modules/documents/docs/proposals/2026-10-12-work-companion-ui-plan.md) 覆盖任务摘要、对话/输入、窄屏和真实状态投影。
- [服务重启与全量数据恢复](modules/documents/docs/proposals/2026-10-12-service-restart-data-recovery.md)：svc 启停、异常退出后的依赖、配置/数据身份、任务/HITL/副作用、文件与组合备份恢复；
  U8 规格见 [SQLite 实例守护](docs/recovery/u8-sqlite-instance-guard.md)。
- [svc 统一部署与一次性登录 Key](modules/documents/docs/proposals/2026-10-12-svc-unified-deploy-and-login-key.md)：
  二进制/源码统一部署、环境准备、无初始密码开户与账户恢复；规格见 `docs/svc-deploy/`，
  账户与恢复续审见 [续审记录](docs/svc-deploy/2026-10-12-account-durability-plan-review.md)。
- [Generative UI 调研与插件](modules/documents/docs/proposals/2026-10-10-generative-ui-plugin.md)：对话内生成界面与可信编译插件交付。
- [多人协作存储与分布式演进](modules/documents/docs/proposals/2026-10-11-collaboration-storage-and-distribution.md)：多项目、多会话并行；PostgreSQL 团队档、迁移恢复与多实例执行。
- [最新模板驱动的两树一网、成员上下文与完整可读审计](modules/documents/docs/proposals/2026-10-14-rdm-two-trees-latest-templates.md)：44 份新 DHF 模板接入、动态两树一网、成员工作上下文与人可读审计。
- [RDM 两树一网集成、完善与追溯审计展示](modules/documents/docs/proposals/2026-10-11-rdm-two-trees-trace-audit-integration.md)：每项目笔记树、文档树与追溯网，项目绑定与读取授权、原子事件历史、统一审计读服务与四入口工作区。
- [DHF 模板接入 RDM 文档生成管线](modules/documents/docs/proposals/2026-10-14-dhf-template-generation-plan.md)：DHF 模板资产合同与文档生成转换。
- [RDM 模板与两树一网对话文档生成](modules/documents/docs/proposals/2026-10-11-rdm-template-dialog-generation.md)：历史资产盘点、模板版本与章节实例化、持久提案、文档级审签及 DOCX。
- [RDM 最终目标核对与完整交付](modules/documents/docs/proposals/2026-10-11-rdm-final-target-completion.md)：系统级项目、权限覆盖、私域协作、全部文档三权与完整业务链的需求映射。
- [快慢通道 U2/U3 实施计划](modules/documents/docs/proposals/2026-10-13-fast-slow-u2-u3-plan.md)：r0.5 [书面设计](modules/documents/docs/proposals/2026-10-14-fast-slow-u3-r05-terminal-evidence-and-fast-feedback-design.md)与[实施计划](modules/documents/docs/proposals/2026-10-14-fast-slow-u3-r05-terminal-evidence-and-fast-feedback-implementation-plan.md)已评审；r0.4 A01 FAIL，r0.5 真实 A01 NOT_RUN。r0.6 [传输完成性设计](modules/documents/docs/proposals/2026-10-14-fast-slow-u3-r06-transport-completeness-design.md)与[实施计划](modules/documents/docs/proposals/2026-10-14-fast-slow-u3-r06-transport-evidence-implementation-plan.md)已获人工批准，零付费实施中；付费探针与 A01 须另行资源提案。八个 PR 仍为草稿，见[核验报告](modules/documents/docs/reports/2026-10-13-fast-slow-u2-u3-validation.md)。