# Agent-System-Dev 项目事实

- 用途：独立功能仓的开发与固定组合入口；非分发单元。
- 组合：组件身份见 components.json；应用/规范/资料提交见 components.lock.json，Go/npm 库版本由消费方语言锁决定。按需源码位于被忽略的 .workspace/。
- 部署：非容器；Releases 仓从本仓固定提交导出版本。

## 方向与规划入口

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

- [版本化依赖与按需源码工作区改造任务](.task/feature-dependency-workspace.md)：
  已批准方案和实施计划由固定 Documents 的 `docs/proposals/2026-10-13-versioned-dependencies-and-workspaces.md`
  与对应 `-implementation-plan.md` 保存。用户授权重构与自检连续推进，特别要求在途分支平稳过渡；
  实施进展和命令证据见任务卡，正式验收、共享部署及发布仍按原审批边界。
  [项目依赖与过渡规则](policy/dependencies.md) 是具体工作入口。

- [用户、职位角色与分层权限统一方案 r1](.workspace/Agent-System-Documents/docs/proposals/2026-10-13-identity-role-permission-plan.md)：用户已批准，首批仅 I1（U1–U2）；
  [权限合同](.workspace/Agent-System-Documents/docs/proposals/2026-10-13-iam-i1-permission-contract.md) 冻结边界，
  [I1 实施候选与评审记录](.workspace/Agent-System-Documents/docs/proposals/2026-10-13-iam-i1-review.md) 维护实际结果与剩余限制；后续单元须另行授权。

- [快慢通道展示与动态工作摘要方案 r1.1](.workspace/Agent-System-Documents/docs/proposals/2026-10-12-fast-slow-channel-display.md)：
  对话即时答复、后台动态发现与来源、四层阅读、真实状态、并发/恢复及 U1–U4；
  2026-10-12 方案设计已批准（阶段 1–4），首批仅 U1；
  [U1 实施计划](.workspace/Agent-System-Documents/docs/proposals/2026-10-12-fast-slow-channel-display-u1-plan.md) 待阶段 5 批准后启动业务代码；
  业务实施、模型实验、运行验收与部署 NOT_RUN。

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

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

- [RDM 两树一网集成、完善与追溯审计展示方案](.workspace/Agent-System-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 团队存储独立后续；运行验收属部署环境。

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

- [RDM 最终目标核对与完整交付方案 r1](.workspace/Agent-System-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](.workspace/Agent-System-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 其余未批条款仍待人工评审。

- [svc 统一部署与一次性登录 Key 方案 r1](.workspace/Agent-System-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)。

## 验证

规范修订：[最终验证与合入调度 r1](policy/merge-queue.md) 及[U1–U6 实施计划](.workspace/Agent-System-Documents/docs/proposals/2026-10-13-merge-queue-implementation-plan.md)已批准。通用规范与计划已分别经 PR 合入，本候选组合固定实际合入 SHA，见[采纳记录](policy/adoption.md)。同步幂等化、显式局部恢复和源码外证据基础已实施；Dev 最新组合验收及平台调度模式启用仍按各自门禁办理。

`make setup` 启用钩子。新 clone 无需递归克隆；启动门禁提供固定规则，
`make workspace-prepare` 准备固定应用与资料。`make component-edit NAME=Agent-Native`
按消费方实际版本创建功能仓编辑分支并生成本地 go.work；解除用 `make component-unlink`。

`make test` / `make build` 在隔离目录使用已提交的清单、应用源码、语言依赖和前端包，
关闭 Go 开发覆盖，拒绝本地 replace/link，构建 frontend dist 后装配 backend embed。
输出 bin/resolved-manifest.json，含实际来源、解析版本及资产摘要；工作区本地覆盖不会改变正式候选。

`make test-governance` 在临时真实仓库验证启动、任务同步、证据、迁移保留和拒绝路径；
`make test-pins` 在新布局核验固定来源，历史提交仍执行旧 gitlink 检查。
公开边界与架构检查使用组合器的固定来源映射，详细操作见 [开发门禁](policy/governance.md)。

RDM 从自身 go.mod 消费远端 Backend，`COMPOSITION_ROOT=<已提交 Dev 根目录> make product`
隔离 vendor 并注入固定前端资产，随产物记录其实际 Backend 版本；不改模块缓存。
`product-smoke` 的临时运行验证与正式验收、共享部署分开记录。真实 PG/Redis、生命周期等
专项门禁保持原环境要求；未提供环境不会由本地组合测试冒充通过。

- [渐进工作台界面重设计 r0.2](.workspace/Agent-System-Documents/docs/proposals/2026-10-12-work-companion-ui-design.md)：用户已授权连续实施；[计划 r1](.workspace/Agent-System-Documents/docs/proposals/2026-10-12-work-companion-ui-plan.md)覆盖任务摘要、对话/输入、窄屏和真实状态投影；进展见对应任务卡。

- [系统项目、成员工作入口与私域协作闭环 r1](.workspace/Agent-System-Documents/docs/proposals/2026-10-13-system-project-membership.md)：2026-10-13 用户批准阶段 1–9 连续推进；统一全局项目身份与名称、成员个人会话、每项目两树一网和私域权限；当前组合验证/CI/tag 消费推进中，部署与线上修复未授权。