Files
Agent-System-Dev/PROJECT.md
T
weichen a74318ab4b
ci / svc-realcombo (pull_request) Successful in 1m48s
ci / test (pull_request) Successful in 4m56s
ci / test-pg (pull_request) Successful in 7m20s
Record U3 r0.4 implementation plan for review
Why: preserve the approved design decision and a staged, verifiable plan before code work.

Evidence: six tasks and thirty steps self-reviewed; local links pass; make test passed with Documents 276f885 staged, receipt imported as SELF.

Impact: documentation, task card and Documents gitlink only; no model calls or production behavior changes.

Refs: modules/documents/docs/proposals/2026-10-14-fast-slow-u3-r04-reliable-first-checkpoint-implementation-plan.md; .task/feature-fast-slow-u2-u3-plan.md
2026-10-14 01:56:46 +00:00

8.6 KiB
Raw Blame History

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 仓从本仓固定提交导出版本。

方向与规划入口

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

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

  • 多人协作存储与分布式演进方案: 10–100 人、多项目、多会话并行;PostgreSQL 团队档、迁移恢复与多实例执行。方案 r1 已批准 (2026-10-11,用户指示「按方案开始改造」),实施自首选增量 U1+U2 启动。

  • RDM 两树一网集成、完善与追溯审计展示方案: 每项目一套笔记树、文档树与追溯网;项目绑定与读取授权闭环、原子事件历史、统一审计读服务 与四入口工作区。方案 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 团队存储独立后续;运行验收属部署环境。

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

  • RDM 最终目标核对与完整交付方案 r1:系统级项目、上限内权限覆盖、私域协作、全部文档三权与完整业务链;34 UR/68 SR/10 F 逐条映射;方案已随 #340 合入(2026-10-11),U1 需求基线核对经 RDM #199/#200 落地,U2 起未启动。

  • 服务重启与全量数据恢复方案 r3.1: 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 其余未批条款仍待人工评审。

  • svc 统一部署与一次性登录 Key 方案 r1: 二进制/源码统一部署、环境准备、无初始密码开户与账户恢复;一次性 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;本入口原链接仍指固定版。候选交接与核查见续审记录。

验证

规范修订:最终验证与合入调度 r1 及U1–U6 实施计划已批准。通用规范与计划已分别经 PR 合入,本候选组合固定实际合入 SHA,见采纳记录。同步幂等化、显式局部恢复和源码外证据基础已实施;Dev 最新组合验收及平台调度模式启用仍按各自门禁办理。

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

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

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