Agent-System-Dev/PROJECT.md

Agent-System-Dev 项目事实

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

验证

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

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 交付时按 合入调度 执行；实际采纳范围见 采纳记录。

法规知识库组合

• 计划：法规知识库计划（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。 该门禁通过不代表部署、版本发布或业务/法务验收完成。

方向与规划入口

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

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

• 分层分支交付与规范精简：两级分支、任务卡合入前闭合、分级门禁、任务分类通道与规范精简。
• 文档职责矩阵整改：项目设置的文档职责三视图分配。
• svc 插件组合部署（--with）：部署时把登记插件与 Dev 基座编成一个二进制并校验激活。
• 用户、职位角色与分层权限统一： I1 权限合同、 I1 实施候选与评审记录。
• 系统项目、成员工作入口与私域协作闭环：全局项目身份与名称、成员个人会话、每项目两树一网与私域权限。
• 快慢通道展示与动态工作摘要：对话即时答复、后台动态发现与来源、四层阅读、真实状态、并发/恢复； U1 实施计划。
• 渐进工作台界面重设计： 计划 覆盖任务摘要、对话/输入、窄屏和真实状态投影。
• 服务重启与全量数据恢复：svc 启停、异常退出后的依赖、配置/数据身份、任务/HITL/副作用、文件与组合备份恢复； U8 规格见 SQLite 实例守护。
• svc 统一部署与一次性登录 Key： 二进制/源码统一部署、环境准备、无初始密码开户与账户恢复；规格见 docs/svc-deploy/， 账户与恢复续审见 续审记录。
• Generative UI 调研与插件：对话内生成界面与可信编译插件交付。
• 多人协作存储与分布式演进：多项目、多会话并行；PostgreSQL 团队档、迁移恢复与多实例执行。
• 最新模板驱动的两树一网、成员上下文与完整可读审计：44 份新 DHF 模板接入、动态两树一网、成员工作上下文与人可读审计。
• RDM 两树一网集成、完善与追溯审计展示：每项目笔记树、文档树与追溯网，项目绑定与读取授权、原子事件历史、统一审计读服务与四入口工作区。
• DHF 模板接入 RDM 文档生成管线：DHF 模板资产合同与文档生成转换。
• RDM 模板与两树一网对话文档生成：历史资产盘点、模板版本与章节实例化、持久提案、文档级审签及 DOCX。
• RDM 最终目标核对与完整交付：系统级项目、权限覆盖、私域协作、全部文档三权与完整业务链的需求映射。
• 快慢通道 U2/U3 实施计划：r0.5 书面设计与实施计划已评审；r0.4 A01 FAIL，r0.5 真实 A01 NOT_RUN。r0.6 传输完成性设计与实施计划已获人工批准，零付费实施中；付费探针与 A01 须另行资源提案。八个 PR 仍为草稿，见核验报告。