Agent-System/.doc/status/FEATURE-MATRIX.md

模块与功能完成度（SSOT）

更新: 2026-09-20（模块开发规范与耦合审计已合入文档；批次 A–G 仍为 planned，不改 production_ready） production_ready: yes（权威来源：gap-matrix；本表不推导发布门禁） 发布缺口: ../remediation/gap-matrix.md 协作焦点: ../ops/CURRENT.md 连续性审计: ../audit/2026-09-16-feature-matrix-production-readiness-audit.md 整改计划: ../remediation/2026-09-16-feature-matrix-production-readiness-plan.md

本表描述能力成熟度；上线 blocker 见 gap-matrix。二者正交：能力行不必全部 done 才能发布；partial/deferred 不得自动回退 production_ready。

2026-09-19 深度审计的 critical/high 已分四批合入 dev（数据一致性、鉴权、SSE/事件、前端 XSS）。不改 production_ready。未做项在 long-term。

---

状态契约

字段	含义
声明范围	本行冻结的能力边界；done 只对该边界负责
状态	done | partial | planned | deferred | blocked | removed（已下线，仅留历史证据）
发布关系	与当前首发/已签门禁的关系：non_blocker / 补证 / 加固 / deferred_enhancement
关闭条件	何时可将本行升为 done（或关闭 partial）；stub/SKIP/fallback 不得冒充
证据	可追溯到报告/commit/环境/schema；代码或 artifact 变化后须重验
mutex	并行认领互斥键（见 CURRENT）

状态判定

• done：声明范围内能力已达生产验收证据；不表示该领域永无后续。新增增强须拆行或进 backlog。
• partial：已交付可用子集，关闭条件仍未满足。
• planned：方案存在，尚未开始实施。
• deferred：明确不进当前路线，且不是发布 blocker（除非盘点确认违规 → 升 gap-matrix）。
• blocked：本行目标无法继续，须写明 blocker 与恢复条件。
• production_ready：只由 gap-matrix 发布门禁决定。

重验触发器

授权谓词/owner port、schema/迁移/compose/镜像/环境晋升、flag 升级、PI Runner/model/protocol、event consumer/writer、浏览器持久化边界变化时，受影响行须重验；历史 PASS 不能单独证明新 artifact。

禁止

• 靠缩小声明范围制造 done（须保留 before/after 与义务迁移）。
• 用 stub、SKIP、deterministic fallback 冒充真实 PI / 完整叙事闭环。
• 无真实 blocker 变化时改写 gap-matrix / production_ready。

---

完成度矩阵

模块	声明范围	状态	发布关系	证据	剩余工作 / 关闭条件	mutex
Agent worktree 治理自动化	主目录保护、任务 worktree、机器认领、候选集成、dev 部署与安全清理	planned	non_blocker	方案；调研	工作规范 已采纳；人工显式校验立即执行。自动注册表、队列、脚本守卫、部署闭环和权限隔离仍待实施，不能宣称自动强制已完成	agent-workflow-governance
意图识别 L1	18 类 Intent、三分支消解、写/只读分流、双标签 DOC_BUSY、intent 纯依赖边界	done	non_blocker	intent-recognition；审计；报告；双标签；U1–U3	边界 before：含 U9–U12 叙事混入 → after：U9–U12 迁至「多意图扩面」行。关闭：纯依赖边界回归即重开	intent
多意图持久计划（U1–U8 基线）	app/intentflow 生命周期、HITL、默认 legacy、U1–U8 代码与安全基线	partial	non_blocker（默认 legacy）	设计；U1–U8；Wave2 真 PI；2026-09-20 复核	legacy 有限只读多意图仍默认启用；新持久计划生产组合根仍使用 Fake query owner，confirm 后缺可靠调度，typed 参数/目标版本不足。原 U1–U8 测试证据保留，但不足以证明升 auto_read/confirm 可用。关闭条件见整改方案 Foundation 1 与 Track I	intent-plan
多意图扩面（U9–U12）	U9 LLM 分段实验；U10 mutate；U11 docgov；U12 workflow/run-control	partial	deferred_enhancement	设计；go/no-go GO；脚手架；U9；U10；U11；U12；2026-09-20 复核	U9 proposer 已实现和注入但未进入生产聊天分段调用；提议请求已带 reasoning profile。U10–U12 当前为 dry-run/validated-only adapter。历史直接调用/PI 测试继续有效，不代表 live 接线。逐域实现和验收，禁止以 full 一次放量	intent-plan
对话 / ctxmgr baseline	多轮上下文、刷新/重登/重启恢复、授权同集正文与计数、U10 端口化停止扩面	done	non_blocker	multi-turn；刷新审计；U10；门禁 B3（项目 6359）	before：语义摘要误标 D5 混入 → after：摘要迁「语义摘要 D3」；D7 数据治理独立。U10 停止扩面	chat
语义摘要（D3）	授权后可见集合上的语义摘要；shadow → 可选替换 deterministic	partial	deferred_enhancement	chat-agent-p6-backlog；go/no-go GO；pu6；脚手架；W2 真 PI；2026-09-20 复核	shadow 默认 off。00058 增加 chat_summaries，写入失败不再伪装成功；运行中的库仍是 schema 53。摘要请求已带 tool_profile=reasoning（argv 为 --no-tools），当前容器要等镜像或 dev 挂载更新后才生效。授权可见集 digest 仍空。SEMANTIC_SUMMARY_REPLACE 未接线。	chat
对话数据治理（D7）	留存/删除口径、库·备份·日志控制、敏感字段加密边界	deferred	deferred_enhancement（违规则升 blocker）	计划 Scope Boundaries；收口 §7.1；D7 ADR 草案；W7 盘点；报告；D7-TRACE	after W7：只读盘点完成（sessions/messages/KB/日志/备份/event）。未发现已确认基线违规，未写发布 blocker。口径仍 pending-compliance-signoff；禁止按 365/180/30 物理删除。追踪索引另定为 record（设计 §9），不把本行升 done	chat
智能体小队	角色-任务-工作区-黑板	done	non_blocker	agent-squad；test 2026-09-07	非关键步骤降级(A5/A6)属 backlog	squad
工作流治理	三正式工作流、设置页/DutyMode、动作级鉴权、真实 PI 三工作流 E2E、full/none 混合长链	done	non_blocker	三工作流整改；409/职责；鉴权；PI E2E；Wave2 full/none	full 跨用户审批 + none 免审批不阻塞已签。纯软件自举仍独立 planned	workflow
研发设计控制（rdev）	医疗第 4 工作流：13×60 manifest/模板、squad.rdev_doc.v1 kind 编排、main-completed 硬 precheck、StageKey 动态化；不含前端/真 PI/键名空间化	partial	deferred_enhancement	设计；short-term；模板深度；S0+S1 首批报告；S1 续批报告；写作规范；backlog	P0+P1 done。模板深度 S0+S1 首批 + S1 续批 done：60/60 模板已补强；真 PI 抽样 PASS（含 rd_planning_review + rd_design_vv，项目 6446）。剩余：S3 overlay 与 R2/R3 已接。P2 名称匹配、阶段折叠、批量审批已接。选中 rdev 时显示与服务端相同的 CDO 前置说明（workflowPrerequisite.test.ts）。P4 键名空间化已接：发布清单用 bd_/pm_/tm_/sw_，旧键仍走同一套步骤和模板，旧 doc_id 仍可查（keyspace_test.go）。P3 三样本已在 dev 真 PI 上跑过（项目 6533）：rd_sw_plan 规划期关闭；rd_proposal completed 但未对齐模板标题；rd_planning_review 当时质量门禁 score 20，是把同节后一张法规表算进问题行。门禁已只读第一张表；保存的终稿不再报「问题行缺少」。建议书标题仍未对齐模板。没有新的真 PI。见 P3 报告。nightly 未扩成四工作流。	workflow-def / rdev-templates
纯软件项目自举	软件项目创建、Bootstrap、Delivery、受控工程交接	partial	deferred_enhancement（明确不挡首发）	设计；ADR；L1 报告；W5a	before：L1 + UI 仍克隆医疗模板。after W5a：catalog 驱动创建、软件不挂医疗 key、docs_only 真 PI 建议 delivery 且不自动激活。SWBOOT-10 仍 stub（W5b）；本行不升 done	workflow-design
IAM / 鉴权	项目级 API 鉴权 + RBAC；会话/阶段授权	done	加固	v3 full inventory；session 中断；fail-closed；410 策略；R13	全路由 inventory + session 中断负例 + 410 冻结 + R13 基线已签	authz
文档治理	法定文档生命周期 + 租约 + 受控正文读取	done	non_blocker	docgov；正文 UI；canonical hash；键统一	项目 143 只读；不终止。doc_proj* 同一发布键不能再并存	docgov
文档版本 baseline	账本、人工修订、确定性 diff+lineage、运行时 UI、负责人通知	done	non_blocker	管理；Round20 UI；ADR；proposed/authoritative	before：完整 PI narrative 混入 → after：迁「PI change-report 叙事」。fallback 报告是本行内显式行为，不是缺口。lineage GET 已按 URL 项目和文档可见性裁剪。test_manager 血缘的下游/上游版本改读文档版本，不再写死 1。Agent 候选报告为 proposed，正式提交才写 authoritative 后继并挂到版本；拒绝、替代后旧报告不能再出建议。人工修订、导入和聊天卡仍未分开预估与正式报告，见 T1。项目追踪索引见下一行	docgov
阶段回溯与影响闭环	五表追踪索引、影响报告、L1 文档修订、L2 阶段再打开、待复核软标记、对话修订提案	done	deferred_enhancement（不挡首发）	设计；Track T；对话化报告	已合入 dev。常驻「需求与影响」面板已退役，新待复核与下游影响改走已有项目会话。dev schema 59。test/main 未升。阶段推进确认门禁仍在。不签 D7 对话 ADR，不改 production_ready	trace-index
PI change-report 叙事	只读消费 diff+lineage 的 PI 叙事；失败全量降级 fallback	partial	deferred_enhancement	Round20；go/no-go GO；pu7；脚手架；W3 真 PI；2026-09-20 复核；最小化输入	flag 默认 off。facts.json 含截断后的 hunk 前后文和影响说明，以及完整 hunk/impact 计数与省略数；摘要 digest 仍不含正文。叙事请求已带 tool_profile=reasoning。运行中的 runner 尚未切到 --no-tools。不打开开关	docgov
前端工作台	三栏 + 块文档 + SSE；错误卡/进度/busy；版本冲突信封；demo seed 默认关；终止 preview	done	non_blocker	workbench；双标签；demo；B4（项目 6363）	before：空「缺口」却 partial → after：本行 done。其他 409 消费方信封复用另列 hardening backlog	web
PI Runner / 配置链	pi-agent + MiniMax + typed-result-v1	done	non_blocker	piagent；container-env；typed-result	文档生成仍使用读写和搜索工具。tool_profile=reasoning 的 argv 是 --no-tools 且不加载搜索扩展；未知 profile 拒绝启动。dev 挂载了 pi-args.mjs，但本轮未重启容器	pi-agent
三环境运维	dev/test/main + 共享 KB；对话/业务库隔离	done	non_blocker	PROJECT.md §4；CURRENT 环境快照 dev/test schema 48、main 47	—	infra
CI / E2E	PR CI、PG 集成、治理 PG、已签真实 PI 门禁；nightly schedule/workflow_dispatch + infra/product 分类 receipt	done	加固（阻止下一次晋升，不自动否定已发布）	BUG-08；PI 三工作流；Wave2B；Wave2C；W1 green + receipt 6e2476f0…	before：partial（FullNone product_fail / secrets 文案过时）→ after：secrets 已配；duplicate goose 00048 已清；FullNone+U8 nightly verdict=pass	ci
Artifact 同 digest 晋升	候选 commit 一次构建、按 digest 晋升、promotion receipt	done	加固	计划 PU5B；Wave2B；Wave2C	关闭：same-image pin（candidate-images-* + PINNED_IMAGE_MODE + promote --require-digests）。声明：单机 retag/digest pin；远程 registry 推送另立任务	infra
可靠事件核心	PG dispatcher、notify/advance/projection live、生产闭包 hook 退出、Phase2 选择性解耦已合入	done	non_blocker	E0A–E2 等；复盘；shared live；phase2 closeout	before：与 FAV off 混成 partial → after：FAV 独立行。选择性后续解耦按收益触发	architecture-docs / events
模块开发规范	窄端口、领域事件、wire DTO 三种契约；故障隔离红线；新增模块/表/事件流程。不含批次 A–G 的代码整改	done	non_blocker	规范；审计；ADR	文档入口已立。代码整改不在本行	module-decoupling-spec
模块解耦批次 A–G	server 端口装配、chat 解环、docgov 词汇、工作流单向依赖、巨型文件、前端 api client、21 条例外清零	planned	non_blocker	分批计划；审计	各批独立 short-term 与验收后另拆行升 done。G1 例外 2026-09-28 到期，到期前须迁走或书面延期。禁止把本行标成进行中来代表七批都已开工	module-decoupling-spec
Final Artifact Vault（FAV）	不可变终态制品库；FAV_DEGRADED_READ=false	partial	deferred_enhancement	Track E 复盘；U7 报告；W6 shadow；short-term	after W6：subscriber ObserveShadow 只计算 intended outcome，不写副作用。仍禁止整支 merge；FAV_DEGRADED_READ 默认 false；live 未放量（staging→artifact→publication 各 ≥7 天观察窗）	events
系统管理台	全屏系统级管理视图（总览/KB/特性开关/系统设置/工作流/角色/用户/文档 8 分组）；/api/v1/admin/system/*；system_settings 白名单可写；吸收下线 AdminSettingsModal	done	non_blocker	short-term；测试报告；commit f1404d5/0eaca61、merge dc7c31e（dev）；dev 冒烟 schema 49 + 四端点 + 写读回环 PASS	二期：Playwright 实跑、细粒度 system:* 权限、设置审计日志、KB 运维动作、白名单项接消费方	web + sysadmin
个人工程中控台（已移出）	原本地只读看板与后来的 Control Center 都不再属于本仓库	removed	进度管理改由独立项目承担	历史设计；历史报告	2026-09-19 删除 cmd/control-center、internal/controlcenter、control-center/web、deploy/control-center。不恢复 engineering-dashboard	—

---

Wave 0 边界 lineage（收口摘要）

行	before 状态/口径	after	原义务去向	现有证据是否覆盖冻结边界
Intent L1	partial（混入 U9–U12）	done	U9–U12 → 多意图扩面	是（双标签 + 分流 + U1–U3）
Chat/ctxmgr	partial（混入语义摘要 D5 误标）	done	D3 摘要行；D7 治理行	是（B3 项目 6359）
Document revision	partial（混入完整 PI 叙事）	done	PI change-report 叙事行	是（Round20；fallback 为声明行为）
Frontend workbench	partial（缺口栏已空）	done	Wave 3 已收口 projectMembers/freeformDoc/taskRuns/chatSessions 结构化错误信封复用	是（B4 项目 6363）
可靠事件	partial（与 FAV 混行）	done	FAV 独立 deferred	是（E0–E2 + shared live）

---

更新规则

1. 模块状态变化时同步本表；仅当发布 blocker 出现或关闭时改 gap-matrix
2. 同一 mutex 同时仅一个 Agent in_progress（见 CURRENT）
3. 新能力行：复制 ../ops/templates/feature-matrix-row.md
4. 拆行/收口须保留 before/after 与义务迁移（见上表）；禁止缩口径假完成

2026-09-17 首次加载性能专项

首次加载与重启首访性能优化：partial（U2 静态交付已验收；U3 只做了登录壳拆包，未关闭）。审计 · 方案 · U2 报告。U2：自托管字体 + br/gzip。U3 进展（fix/audit-remainder-closeout）：导出、预览、管理台、块编辑器、Mermaid/公式改为点击或出现时再加载。入口包 index-*.js 由 2.83 MB / br 626 KB 降到 737 kB / br 170 KB（index-j0BIrjIR.js，包内无 katex）。公式在气泡或正文里出现时才加载，富文本复制同样延后。U3 的浏览器资源瀑布还没测，本行不关。U5：/auth/me 复用本请求已核过的用户，不再第二次解析会话；会话与用户状态合成一次 JOIN。没有锁等待证据，所以不节流 last_seen。TestAuthMe_LogoutNextRequestIs401。U1、U6、U7 未做。U4 进展：登录不再按项目数拉成员名册，只同步当前项目；其他项目先种入当前用户以保持会话可见，完整名册在打开成员面板时取。会话列表不再因项目数组变化而重拉，迟到响应用代次丢弃，同一项目的在途成员请求合并。src/data/initFanout.test.ts。2026-09-19 浏览器证据（e2e/initial-load-performance.spec.ts，n=20，本仓 Vite :3100 代理 :8080）：每次登录成员项目数 1、会话列表 GET 1，匿名与登录后资源路径均无 katex/mermaid/docx。同一探针在重建后的 :8080（index-DOO0-Yh7.js，schema 53，n=5）成员项目 1、会话列表 GET 1，匿名 JS 传输 172,417 B，首屏路径无 katex/mermaid/docx。重建前旧包 n=1 曾是 704/30。慢网 n=3、CPU 4 倍：10 Mbps 表单可见 558–604 ms，2 Mbps 1279–1296 ms，样本不足 20，U1 不关。U6 不加索引：测到的瓶颈是已消失的成员扇出，没有慢 SQL 证据。U7 已测未关：报告。Vite 监听约 0.3 s；314 个模块冷/热 1.45/1.11 s，不是历史十几秒。postgres+app 到 /ready 1.0–1.2 s。无头浏览器缺系统库，登录表单可见未测；不宣称较基线下降 50%。mutex web + static-delivery（U2 done）/ loading-performance-audit。

2026-09-17 文档编制人兼任方案

新增能力 done（U1–U6，已合入 dev@09a9921）：方案 · 源码核查 · U6 验收 · 收口交接。任务归档：archive/ops/2026-09-17-document-author-only-u{1..6}.md。总开关默认 off；test/main 晋升与开放授权另授。变更提案 HTTP 仍缺（audit）。mutex document-duty-policy。