101 lines
11 KiB
Markdown
101 lines
11 KiB
Markdown
# 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#长期方向与任务衔接) 执行。
|
||
|
||
- [分层分支交付与规范精简 r1](modules/documents/docs/proposals/2026-10-18-delivery-model-v3.md)：2026-10-18 用户批准实施。固定两级分支、任务卡合入前折叠闭合、按层级分配门禁、任务分类通道与规范精简；由治理大任务 `feature/delivery-model-v3` 推进。
|
||
|
||
- [文档职责矩阵整改 r2](modules/documents/docs/proposals/2026-10-15-rdm-duty-matrix-rework.md)：项目设置的文档职责改为三视图分配，不创建文档、不执行审签。2026-10-15 按实施方案执行；部署与真实账号验收未授权。
|
||
|
||
- [svc 插件组合部署（--with）方案 r1](modules/documents/docs/proposals/2026-10-14-svc-plugin-compose-deploy.md)：待评审。部署时把登记插件与 Dev 基座编成一个二进制并校验激活。收录不构成批准。
|
||
|
||
- [用户、职位角色与分层权限统一方案 r1](modules/documents/docs/proposals/2026-10-13-identity-role-permission-plan.md)：用户已批准，首批仅 I1（U1–U2）；
|
||
[权限合同](modules/documents/docs/proposals/2026-10-13-iam-i1-permission-contract.md) 冻结边界，
|
||
[I1 实施候选与评审记录](modules/documents/docs/proposals/2026-10-13-iam-i1-review.md) 维护实际结果与剩余限制；后续单元须另行授权。
|
||
|
||
- [快慢通道展示与动态工作摘要方案 r1.1](modules/documents/docs/proposals/2026-10-12-fast-slow-channel-display.md)：
|
||
对话即时答复、后台动态发现与来源、四层阅读、真实状态、并发/恢复及 U1–U4；
|
||
2026-10-12 方案设计已批准（阶段 1–4），首批仅 U1；
|
||
[U1 实施计划](modules/documents/docs/proposals/2026-10-12-fast-slow-channel-display-u1-plan.md) 待阶段 5 批准后启动业务代码；
|
||
业务实施、模型实验、运行验收与部署 NOT_RUN。
|
||
|
||
新增方向：[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–U5 全部实施合入（RDM PR #195/#197/#201/#213；Dev PR #368，2026-10-11；超管槽待基座能力
|
||
接线，申请见 RDM 仓 docs/proposals/2026-10-11-u1-base-extension-requests.md）；
|
||
U6 团队存储独立后续；运行验收属部署环境。
|
||
|
||
- [DHF 模板接入 RDM 文档生成管线 r0.1](modules/documents/docs/proposals/2026-10-14-dhf-template-generation-plan.md)：2026-10-14 获用户批准开始实施；RDM 独立分支已保存 U1 资产合同与 44 份原件目录，E1 与获批追加试验共为 14 份 DOC 生成转换候选。owner 已分别接受项目建议书、F01、F02、设计输入规格书四份确切四哈希候选包，四份均未发布；设计输入规格书的动态 SR/子系统分组使用已裁定的 v2 内容块合同，原型和完整包分别获评审。F01/F02 为独立过程确认用途、默认阶段10，owner 兼任体系专员，公开字典与存量实例升级合同仍需独立评审。14 份 DOC 的 Word 保真待反馈。正式模板发布数为 0；U1 整体、U2–U6、正式浏览器验收、迁移和部署均未完成，复用在途两树合同并按阶段人工评审。
|
||
|
||
- [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 起未启动。
|
||
|
||
- [服务重启与全量数据恢复方案 r3.1](modules/documents/docs/proposals/2026-10-12-service-restart-data-recovery.md)：
|
||
svc 启停、异常进程/主机退出后的依赖、配置/数据身份、任务/HITL/副作用、文件与组合备份恢复；
|
||
r2 已批准。r3.1 增补 D1 实例身份收尾、D2 可回滚切换、D3 真实组合门禁，并记录 2026-10-12 rdmcand 数据归属：会话不在 dev 库的 rdmcand 窗口内，领域事件为空，不跨实例搬迁。
|
||
D1 与 D2 已合入 Backend #184、RDM #291、Dev #485。D3 的 `make test-lifecycle` 跑真实组合用例；登录仍是 NOT_RUN，依赖账户方案 U7/U5，不在本轮公共化账户 CLI。r3 其余未批条款仍待人工评审。
|
||
2026-10-12 用户批准 r3 新增（R11/R12、KTD13–15、U8）：SQLite 活动服务锁与耐久核验已实施，故障注入、部署与运行验收仍 NOT_RUN。
|
||
|
||
- [svc 统一部署与一次性登录 Key 方案 r1](modules/documents/docs/proposals/2026-10-12-svc-unified-deploy-and-login-key.md)：
|
||
二进制/源码统一部署、环境准备、无初始密码开户与账户恢复；一次性 Key 仅兑换设密受限会话；
|
||
2026-10-12 已批准；U1/U4 实施启动中；规格见 `docs/svc-deploy/`。
|
||
|
||
上述账户／恢复方案已有 U1/U4 与 recover/watchdog 基础源码。2026-10-12 的 dev 8788 续查形成账户 r2、恢复 r3 **候选草案**：帮助与能力发现、账户事务／审计／登录接线、SQLite 活动服务隔离及备份恢复增补。新增内容待人工评审；Documents 独立分支 `feature/svc-account-durability-plan` 仅本地保存，不推进本仓 gitlink；本入口原链接仍指固定版。候选交接与核查见[续审记录](docs/svc-deploy/2026-10-12-account-durability-plan-review.md)。U8 规格见 `docs/recovery/u8-sqlite-instance-guard.md`。
|
||
|
||
## 验证
|
||
|
||
多个分支向 Dev main 交付时按[合入调度](policy/delivery.md#合入调度)执行：等待分支不追 main，轮到后同步一次、固定候选、运行当前 HEAD 的完整 CI，再由智能体合入。实际采纳范围见[采纳记录](policy/adoption.md)。
|
||
|
||
`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`，再核验制品与实际运行状态。
|
||
|
||
- [渐进工作台界面重设计 r0.2](modules/documents/docs/proposals/2026-10-12-work-companion-ui-design.md)：用户已授权连续实施；[计划 r1](modules/documents/docs/proposals/2026-10-12-work-companion-ui-plan.md)覆盖任务摘要、对话/输入、窄屏和真实状态投影；进展见对应任务卡。
|
||
|
||
- [系统项目、成员工作入口与私域协作闭环 r1](modules/documents/docs/proposals/2026-10-13-system-project-membership.md)：2026-10-13 用户批准阶段 1–9 连续推进；统一全局项目身份与名称、成员个人会话、每项目两树一网和私域权限；当前组合验证/CI/tag 消费推进中，部署与线上修复未授权。
|
||
|
||
## 法规知识库组合
|
||
|
||
[法规知识库计划](docs/superpowers/plans/2026-10-18-regulations-knowledge-base-plan.md) U8 的固定组合：
|
||
|
||
- `modules/backend` 56a7f9f（EXT-20 法规检索/搜索扩展合同）、`modules/documents` 5bb4877（EXT-20 提案）、
|
||
`modules/frontend` 50ec836 与 `modules/ui` 5c2b103（法规引用渲染）。
|
||
- RDM ece91da（含 kbreg 组合）与 KB-Regulations 5dddad2，固定在
|
||
`tests/integration/regulations-kb/components.pin`；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`。真实搜索/嵌入/MinerU 调用 NOT_RUN，待 owner 批准。
|
||
|
||
部署、版本发布与业务/法务验收是后续独立门禁，本组合门禁通过不代表其中任何一项完成。
|