ai-delivery-workflow 0.2.2 → 0.4.0

package/docs/VIEWER-MAINTENANCE.zh-CN.md

@@ -1,373 +1,150 @@
-# 工作流物料查看器维护指南
+# 工作流管理器维护指南
 
-> 适用对象：维护 `ai-delivery-workflow` 发行仓库的开发者和 AI  
-> 目标：下次修改查看器时，能够快速定位权威源码、理解契约并完成验证  
-> 配套使用文档：[VIEWER-USER-GUIDE.zh-CN.md](VIEWER-USER-GUIDE.zh-CN.md)
+AI 或脚本操作正式管理器前，先读取 [Workflow Manager Agent Interface](agents/workflow-manager-agent-interface.md)，并以运行时 `contracts` 资源为动作 Schema 的唯一事实源。
 
-## 1. 下次修改前先读这里
+> 本文件保留旧 Viewer 维护指南的路径。现行产品是 Workflow Manager；旧 Viewer 和独立 Prototype Review Server 的源码、CLI 与安装契约均已退役。
 
-查看器的权威源码只有：
+## 1. 仓库身份和权威源码
+
+本仓库是 `ai-delivery-workflow` 的维护与发行源码仓库，不是安装后的业务项目。Manager 的权威位置是：
 
 ```text
-skills/ai-delivery-orchestrate/
-  assets/project-template/
-    .workflow/tools/viewer/
+lib/workflow-manager.mjs
+lib/workflow-manager-facts.mjs
+lib/workflow-manager-governance.mjs
+lib/workflow-manager-prototypes.mjs
+lib/workflow-manager-systems.mjs
+lib/workflow-manager-mock.mjs
+manager/src/
+lib/workflow-manager-public/
+skills/ai-delivery-orchestrate/assets/project-template/.workflow/tools/manager/
+verification/workflow-manager*.test.mjs
 ```
 
-以下位置都是派生副本，不得作为发行源码修改：
-
-- 任意业务项目的 `.workflow/tools/viewer/`；
-- 本仓库 `.tmp/viewer-demo/.workflow/tools/viewer/`；
-- AppData、`/tmp` 或系统临时目录中的 QA 项目；
-- `.workflow/delivery/runtime/backups/` 中的历史副本。
-
-修改后由 `lib/project-installer.mjs` 把权威目录复制到目标项目。只修改已安装副本会导致下一次 `init --force` 丢失改动。
+React/Vite 源码位于 `manager/src/`；`npm run manager:build` 生成发行静态资源到 `lib/workflow-manager-public/`。安装模板中的 `manager.mjs` 和启动脚本是项目内入口，不是另一个业务实现。
 
-开始任务时建议先向 AI 提供：
+## 2. 架构和边界
 
 ```text
-请先阅读 docs/VIEWER-MAINTENANCE.zh-CN.md 和
-docs/VIEWER-USER-GUIDE.zh-CN.md，再修改项目内工作流物料查看器。
-权威源码位于 skills/ai-delivery-orchestrate/assets/project-template/
-.workflow/tools/viewer/，不要修改 `.tmp/viewer-demo` 或业务项目中的派生副本。
-完成后执行维护指南中的完整验证清单。
+CLI / HTTP / React UI
+        |
+        v
+workflow-manager.mjs application service
+        |
+        +-- formal delivery state and facts
+        +-- prototype review and change requests
+        +-- project systems and initialization scripts
+        +-- Mock definitions and synchronization
+        +-- decisions, relationships and settings
 ```
 
-## 2. 不可破坏的产品约束
-
-除非需求明确变更并同步更新测试、使用指南和安全评审，否则保持：
-
-1. `init` 自动安装查看器，用户不需要单独安装前端依赖。
-2. 不修改业务项目 `package.json`。
-3. 只使用 Node.js 18+ 标准库和浏览器原生 API。
-4. 默认监听 `127.0.0.1:4173` 并打开浏览器。
-5. 只读当前项目 `.workflow/`。
-6. 不提供写入、审批、归档、部署或生产操作 API。
-7. 自进化视图只读取 `.workflow/evolution/index.yaml` 和 Git 跟踪的治理物料；不得读取 runtime 原始反馈或提供扩展批准、启停和回退接口。
-7. 拒绝路径穿越，不跟随 `.workflow/` 中的符号链接。
-8. 文本预览上限 2 MiB，单次扫描上限 10,000 个文件。
-9. 桌面保留节点、物料表、详情三栏；移动端保留同一核心审阅流程。
-10. 面向用户的文案默认简体中文。
-
-## 3. 架构
-
-```mermaid
-flowchart LR
-    I["ai-delivery init"] --> P["project-installer.mjs"]
-    P --> V["目标项目 .workflow/tools/viewer"]
-    S["启动脚本"] --> N["server.mjs"]
-    N --> W["目标项目 .workflow"]
-    N --> A["只读 HTTP API"]
-    N --> R["public 静态资源"]
-    A --> B["浏览器 app.js"]
-    R --> B
-    B --> U["节点 / 表格 / 详情 / 预览"]
-```
-
-运行时没有数据库和构建步骤：
-
-1. 启动脚本执行同目录 `server.mjs`。
-2. 服务端根据启动位置确定默认项目根，也接受 `--project`。
-3. 浏览器加载 `index.html`、`styles.css` 和 `app.js`。
-4. `app.js` 请求 `/api/catalog`。
-5. 服务端即时扫描 `.workflow/`、计算元数据并返回目录。
-6. 用户选择物料后，前端按类型请求 `/api/document` 或 `/api/file`。
-
-## 4. 文件职责
-
-| 文件 | 职责 | 常见修改场景 |
-| --- | --- | --- |
-| `server.mjs` | 参数、扫描、元数据推导、安全边界、HTTP API、静态服务 | 新文件类型、新状态、节点映射、API、安全限制 |
-| `public/index.html` | 应用壳、可访问语义、控件和详情区 DOM | 新控件、新字段、新面板 |
-| `public/app.js` | 前端状态、筛选、渲染、关系跳转和预览 | 新交互、新预览器、新筛选字段 |
-| `public/styles.css` | 设计令牌、桌面/移动布局、状态和预览样式 | 视觉、密度、响应式、可访问状态 |
-| `start.cmd` | Windows CMD 入口 | 参数透传或 Node 启动兼容 |
-| `start.ps1` | PowerShell 入口 | PowerShell 启动兼容 |
-| `start.sh` | macOS/Linux 入口 | POSIX Shell 启动兼容 |
-| `lib/project-installer.mjs` | 安装、冲突检测、备份、清单和 doctor | 安装位置、受管文件、诊断规则 |
-| `verification/workflow-viewer.test.mjs` | 服务端、HTTP 边界和语法回归 | 每次行为变更必须同步 |
-
-相关文档入口：
-
-- `README.md`：最短启动入口；
-- `docs/PROJECT-MANUAL.zh-CN.md`：整体流程中的查看器定位；
-- `docs/VIEWER-USER-GUIDE.zh-CN.md`：完整用户操作；
-- `docs/FILE-REFERENCE.zh-CN.md`：发行文件职责。
-
-## 5. 安装生命周期
-
-`lib/project-installer.mjs` 将整个查看器目录视为受管目录：
+不可变边界：
 
-1. 目标不存在：复制权威目录。
-2. 目标摘要相同：不执行动作。
-3. 目标摘要不同且未传 `--force`：报告冲突并停止。
-4. 目标摘要不同且传入 `--force`：先备份，再整体替换。
-5. 安装清单记录 `viewer_root` 和三类 `viewer_start`。
-6. `doctor` 检查服务端、前端资源和三类启动脚本是否齐全。
+- UI、HTTP 和 CLI 调用同一资源查询与动作分派，不复制业务规则。
+- 正式节点状态来自 `state inspect.derived_node_states`；Manager 不提供直接状态写入口。
+- 所有写能力属于固定动作白名单；任意 shell、任意文件编辑、直接 YAML 编辑和 Gate 绕过均拒绝。
+- 原型审核绑定精确 Revision、Page/Scene 和 checksum；原型内容只通过受控路径和 sandbox iframe 提供。
+- 系统生命周期只执行 Registry 登记的当前分支 Docker Compose argv；初始化脚本只能位于声明目录。
+- 管理器只支持中文桌面界面，验收视口为 `1280x720` 和 `1440x900`，不承担移动端兼容。
 
-不要把运行日志、缓存、用户偏好或数据库写入受管查看器目录，否则会造成无意义的摘要冲突。当前查看器没有持久状态。
+## 3. 服务接口
 
-## 6. 服务端契约
-
-### 6.1 启动参数
-
-| 参数 | 环境变量 | 默认值 |
-| --- | --- | --- |
-| `--host` | `AI_DELIVERY_VIEWER_HOST` | `127.0.0.1` |
-| `--port` | `AI_DELIVERY_VIEWER_PORT` | `4173` |
-| `--project` | 无 | 查看器目录向上两级 |
-| `--no-open` | 无 | 默认自动打开 |
-
-端口必须是 `1..65535` 的整数。
-
-### 6.2 HTTP API
-
-所有接口只接受 `GET`。
-
-| 路径 | 返回 | 边界 |
-| --- | --- | --- |
-| `/api/health` | 服务状态和项目根 | 不读取文档正文 |
-| `/api/catalog` | 项目、版本、发布、分组节点、物料、生产/研发线摘要和计数 | 每次请求重新扫描 |
-| `/api/document?path=...` | UTF-8 文本内容 | 仅 `.workflow/`，最大 2 MiB，扩展名白名单 |
-| `/api/file?path=...` | 图片二进制 | 仅 `.workflow/`，仅 GIF/JPEG/PNG/WebP |
-| `/` 及静态路径 | 内置前端 | 只能读取 `public/` 内文件 |
-
-新增 API 时必须继续满足：
-
-- 默认拒绝非 `GET`；
-- 使用结构化 JSON 错误；
-- 对所有文件路径同时检查前缀和解析后的真实边界；
-- 不把项目根之外的绝对路径返回为可读取资源；
-- 不放宽 CSP 来规避前端实现问题。
-
-### 6.3 目录数据
-
-`/api/catalog` 当前 `schema_version` 为 `1`，顶层字段为：
+版本化资源：
 
 ```text
-schema_version
-scanned_at
-project
-iterations
-nodes
-documents
-counts
-truncated
+manager, facts, prototypes, systems, mock, settings
 ```
 
-每个 `document` 的稳定字段包括：
+HTTP 接口：
 
 ```text
-path, title, file_name, extension, type,
-node_id, iteration_id, status, declared_status,
-version, artifact_id, standards,
-modified_at, size_bytes, checksum, git_status,
-preview_kind, previewable, inbound, outbound
+GET  /api/v1/manager
+GET  /api/v1/resources/<resource>
+POST /api/v1/actions/<action>
+GET  /api/v1/prototype-content/<frozen-relative-path>
 ```
 
-变更、删除或重命名字段属于前后端契约变更。必须同步修改 `app.js`、测试、文档，并评估是否提升 `schema_version`。
-
-## 7. 推导规则
-
-### 7.1 项目和迭代
-
-- 项目 ID、名称来自 `.workflow/delivery/project.yaml`；
-- 当前迭代优先读取 schema 2 的 `development_state.scope_id`，旧 schema 才回退到顶层 `iteration_id`；当前发布优先读取 `release_state.scope_id`；
-- 其次读取 `project.yaml` 的 `current_iteration_id`；
-- 最后回退到扫描结果中排序靠后的迭代 ID。
-- 当前生产版本、生产 release ID 和累计研发版本优先读取 `workflow-state.yaml` 的审计字段；`project.yaml` 同名字段只作旧项目兼容回退。
-
-### 7.2 节点
-
-已登记物料优先使用 `artifact-registry.yaml` 的 `node`。未登记文件再从 `.workflow/iterations/<iteration-id>/<node-id>/` 推导；长期产品、架构、体验、规范和治理目录有固定映射；最后才读取正文 `node`、`node_id`、`stage`。
-
-`walkWorkflow()` 必须忽略 `.gitkeep` 和整个 `.workflow/delivery/runtime/` 子树。占位文件只用于跨 clone 保留空目录；runtime 只保存本机活动状态、心跳、锁和安装备份。两者都不是交付物，也不得进入迭代、发布、节点数量或进度计算。
-
-研发、发布、历史节点定义和别名都在 `server.mjs` 顶部。增加流程节点时应同时检查：
-
-- `NODE_DEFINITIONS`；
-- `NODE_ALIASES`；
-- 总流程手册和编排 Skill；
-- 桌面进度轨密度和移动端横向节点栏；
-- 审计样例和节点数量断言。
-
-### 7.3 状态
-
-Git 变更优先显示为“已变更”。否则已登记物料使用 `artifact-registry.yaml` 的 `status`，未登记文件再读取：
+CLI 等价入口：
 
 ```text
-status
-decision
-version_status
-state
+manager inspect
+manager list|show|export --resource <resource>
+manager action <action-name> --input <json-file>
+manager serve [--port <port>] [--no-open]
 ```
 
-状态映射位于 `STATUS_META` 和 `normalizeStatus()`。新增值时要明确 key、中文标签和语义色，不要只在前端添加颜色。
+动作输入必须是有大小限制的 JSON object。写动作按能力要求校验 `human:` 或 `agent:` actor、expected revision/checksum、幂等键和 plan checksum，并输出结构化 Receipt/Event。新增动作时必须同时更新白名单、CLI/HTTP 路由、应用服务测试、安装后 CLI 测试和用户文档。
 
-后端必须覆盖正式状态 CLI 可产生或正式物料可登记的全部状态。尤其是 `frozen`、`immutable`、`deployed`、`archived` 必须映射为成功；`review-draft`、`superseded` 为中性；`pending-approval`、`rolled-back` 为警告。回归测试应使用 `/api/catalog` 或 `buildCatalog()` 验证节点计数，而不是只检查前端颜色。
+## 4. 页面契约
 
-### 7.4 标题、版本和 ID
+`lib/workflow-manager.mjs` 的 `MANAGER_PAGES` 是 19 个固定 Page 的发行目录。Page ID 只追加，不重排、不复用；`P13` 标记为 contextual。业务项目 Prototype 的 Page/Review Scene 身份来自冻结 Revision，不得与 Manager Page 身份混用。
 
-- Markdown 标题优先使用第一个一级标题；
-- 已登记物料的版本和 ID 优先使用注册表，未登记文件再从结构化文本依次尝试已定义字段；
-- 没有值时回退为文件名；
-- 当前字段提取是面向多种文本格式的受控标量识别，不是完整 YAML/JSON 解析。
+页面数据来自资源投影：
 
-注册表使用安装在 `.workflow/tools/state/vendor/yaml/` 的结构化解析器；发行仓库测试回退到包依赖。其他正文仍采用受控标量识别。不能用复杂正则模拟完整数据格式。
+- P01/P02 使用 Manager 投影和正式状态派生事实。
+- P03/P04/P05/P06/P18/P19 使用 `facts` 与 governance 服务。
+- P07/P11-P17 使用 `prototypes` 服务。
+- P08 使用 `systems` 服务。
+- P09 使用 `mock` 服务。
+- P10 使用 `settings` 服务。
 
-### 7.5 上下游关系
+缺少事实时返回明确的 `not-registered` 或空集合，界面显示“尚未登记”。禁止用硬编码示例掩盖未登记状态。
 
-服务端只把正文中能解析且真实存在的文件路径登记为关系：
+## 5. 安装和升级
 
-- 以 `.workflow/` 开头的项目路径；
-- 以 `./` 或 `../` 开头的相对路径。
+`lib/project-installer.mjs` 将 Manager runtime、静态资源和跨平台启动脚本作为受管资产安装。新安装清单不包含 Viewer 字段。升级旧安装时：
 
-推导得到的正向引用是 `outbound`，反向索引是 `inbound`。自然语言中的物料名称不会自动建立关系。
+1. 预览中把旧 Viewer 列为 `remove`。
+2. 应用时先备份旧 Viewer，再删除并把 checksum、备份位置写入 Receipt。
+3. 回滚前验证正式事件树和受管资产未漂移，然后恢复旧 Viewer。
+4. Doctor 校验 Manager，不再把 Viewer 当可选能力。
 
-## 8. 前端状态和交互
+独立 Prototype Review Server 不进入 npm 包；`prototype-review-target.mjs` 和 `prototype-page-review.mjs` 仍是 Manager、前端守卫及审核凭证的内部模块。
 
-`app.js` 使用一个内存状态对象保存目录、物料、筛选结果、当前节点、选中文档和预览模式。
+## 6. 修改流程
 
-核心调用顺序：
+1. 从正式原型基线 `wm-prototype-r33@f98e7595` 和对应需求确定 Page/Scene 行为。
+2. 为应用服务或 UI 行为先增加失败测试。
+3. 修改 `lib/workflow-manager*.mjs`、`manager/src/` 或安装入口。
+4. 执行 `npm run manager:build`，只保留最终 index 引用的哈希资源。
+5. 运行 Manager 全套测试和受影响的安装、状态、文档测试。
+6. 用真实安装项目从包内 CLI 启动，验证 CLI、HTTP 与 UI 返回一致事实。
+7. 在两个桌面视口检查页面身份、非空内容、框架错误覆盖层、控制台、交互、溢出和重叠。
+8. 执行新安装、升级、迁移、回滚与 npm 打包校验。
+9. 更新文档和 Gitee Issue 证据后才关闭任务。
 
-```text
-loadCatalog
-  -> initializeCatalog
-  -> applyFilters
-  -> renderTable / renderNodes / renderProgress
-
-selectDocument
-  -> 填充元数据与关系
-  -> 请求预览
-  -> renderPreview
-```
+原型需求发生变化时，先生成并批准新 Prototype Revision，再改正式 React 页面。不能以测试方便为由跳过这条顺序。
 
-修改交互时保持：
-
-- 筛选结果、左侧节点和进度统计使用同一目录状态；
-- 重新扫描时尽可能保留当前选择；
-- 文档切换存在异步请求时，旧响应不得覆盖新选择；
-- 所有文档正文在插入 HTML 前转义；
-- Markdown 支持是受控轻量预览，不执行文档中的 HTML 或脚本；
-- 控件有可见焦点，表格行支持键盘打开；
-- `hidden` 状态必须在 CSS 中保持互斥，避免空状态覆盖详情。
-
-## 9. 样式和响应式约束
-
-当前断点：
-
-| 范围 | 布局 |
-| --- | --- |
-| 大于 `1180px` | 完整三栏和顶部扫描信息 |
-| `901px..1180px` | 收窄节点栏、详情栏和搜索 |
-| `621px..900px` | 详情变为右侧抽屉，表格隐藏次要列 |
-| 小于等于 `620px` | 顶部两行 Grid、节点横向滚动、两列表格 |
-
-重要实现约束：
-
-- `.app-shell` 和 `.document-workspace` 必须使用 `minmax(0, 1fr)` 的可收缩列；
-- 固定格式区域使用稳定行列尺寸，避免动态文本改变布局；
-- 页面本身不得产生横向滚动；节点栏、表格或预览可在自身边界内滚动；
-- 详情空状态和正文状态不得同时显示；
-- 390px 宽度下刷新按钮、迭代、搜索、筛选和状态列必须可见；
-- 不使用营销页、装饰性卡片堆叠或与工作台无关的视觉元素。
-
-## 10. 按需求定位修改入口
-
-| 需求 | 主要文件 | 必须补充的验证 |
-| --- | --- | --- |
-| 增加物料字段 | `server.mjs`、`app.js`、`index.html` | catalog 单测、详情截图 |
-| 增加文件预览类型 | `server.mjs`、`app.js` | MIME/边界测试、真实预览 |
-| 增加筛选器 | `index.html`、`app.js`、`styles.css` | 筛选状态和移动端 |
-| 调整状态规则 | `server.mjs`、`styles.css` | 状态别名、色调和计数 |
-| 调整节点 | `server.mjs`、流程文档/Skill | 节点数量、进度轨和审计样例 |
-| 调整安全限制 | `server.mjs` | 路径穿越、方法、大小和类型测试 |
-| 调整安装位置 | `project-installer.mjs`、文档 | init、force 备份、doctor、manifest |
-| 视觉或响应式修改 | `styles.css`，必要时 HTML | 桌面、390px、详情打开状态 |
-
-## 11. 标准修改流程
-
-1. 阅读本指南、使用指南和相关源码。
-2. 明确需求是否改变只读、安全、安装或 catalog 契约。
-3. 只修改权威模板目录和发行源码。
-4. 先增加或更新 `verification/workflow-viewer.test.mjs`。
-5. 执行语法和自动化测试。
-6. 使用 CLI 初始化一个隔离项目，不能只从模板目录直接测试。
-7. 向隔离项目写入代表性的 `.workflow/` 物料。
-8. 执行 `doctor`。
-9. 从隔离项目实际运行 `start.cmd`、`start.ps1` 或 `start.sh`。
-10. 在桌面和 390px 移动视口验证加载、筛选、详情和预览。
-11. 检查控制台错误、页面溢出和路径读取边界。
-12. 更新 README、用户指南、维护指南和文件参考。
-13. 执行 npm 打包检查，确认新文件进入发行包。
-14. 删除临时项目、浏览器配置和诊断脚本；可保留最终截图作为审阅证据。
-
-## 12. 自动化验证
-
-仓库根目录执行：
+## 7. 验证命令
 
 ```powershell
-node --check skills/ai-delivery-orchestrate/assets/project-template/.workflow/tools/viewer/server.mjs
-node --check skills/ai-delivery-orchestrate/assets/project-template/.workflow/tools/viewer/public/app.js
-node --test verification/workflow-viewer.test.mjs
+node --test verification/workflow-manager*.test.mjs
+node --test verification/frontend-guard.test.mjs verification/delivery-state.test.mjs verification/documentation.test.mjs verification/project-installer.test.mjs
+npm run manager:build
 npm test
-node --test verification/checkpoint-task-state.test.mjs
-npm run audit:verify
-npm pack --dry-run --json --cache .tmp/npm-cache
-```
-
-安装验证：
-
-```powershell
-node bin/ai-delivery.mjs init E:\path\to\isolated-project
-node bin/ai-delivery.mjs doctor E:\path\to\isolated-project
-```
-
-升级冲突验证至少覆盖：
-
-```powershell
-node bin/ai-delivery.mjs init E:\path\to\isolated-project --dry-run
-node bin/ai-delivery.mjs init E:\path\to\isolated-project --force
+npm run skills:validate
+npm run pack:check
+git diff --check
 ```
 
-浏览器验证的最小流程：
-
-```text
-打开首页
--> 确认项目、迭代、节点和物料非空
--> 搜索一个已知标题
--> 打开唯一结果
--> 确认元数据、关系、checksum 和预览
--> 切换到 390x844
--> 确认无页面横向溢出，主要控件和状态列可见
--> 确认控制台没有相关错误
-```
-
-## 13. 完成定义
-
-一次查看器修改只有同时满足以下条件才算完成：
-
-- 权威模板而非派生副本已修改；
-- 新行为有自动化测试；
-- `init`、`doctor` 和启动脚本真实可用；
-- `.workflow/` 外文件仍不可读取；
-- 桌面与移动端核心流程均通过；
-- 控制台无未解释错误；
-- 文档和文件索引已同步；
-- npm dry-run 包含全部必要文件；
-- 临时 QA 资源已清理。
+发行候选还必须验证：
 
-## 14. 当前基线
+- 从 npm tarball 全新安装并启动 Manager；
+- 从旧安装升级，Receipt 包含旧 Viewer 的 `remove`；
+- 回滚恢复升级前受管字节；
+- `migrate --dry-run` 零写；
+- 包内不存在 Viewer 或独立 Prototype Review Server；
+- `doctor`、Manager CLI/API/UI 在安装后项目中可用。
 
-截至本指南建立时：
+## 8. 完成定义
 
-- 包版本：`0.2.0`；
-- 流程导航：治理、13 个研发节点、11 个发布节点和按需显示的历史兼容节点；
-- 支持预览：Markdown、CSV、JSON、YAML、JSONL、TOML、文本、HTML 原型源码和图片；
-- 文本预览限制：2 MiB；
-- 扫描限制：10,000 个文件；
-- 默认地址：`http://127.0.0.1:4173`；
-- 自动化基线：37 个仓库测试，其中 3 个查看器定向测试；
-- 视觉基线：桌面三栏工作台，移动端节点横栏、两列表格和详情抽屉。
+只有以下证据全部成立才算完成：
 
-若这些数字或契约发生变化，必须在同一次修改中更新本节。
+- 19 个 Page 都有真实实现，不含 planned placeholder；
+- P13 评论、截图、反复修改和审核动作持久化且 AI 可读；
+- P08 架构/列表分离，计划节点、Docker 文件、脚本导入/编辑和分支控制有效；
+- P09 协议与场景可读，受控同步保留 Receipt；
+- CLI、HTTP、UI 和安装后 runtime 使用同一事实与动作契约；
+- 两个桌面视口无横向溢出或关键面板重叠，控制台无未解释错误；
+- 全套测试、构建、Skill、打包、升级/回滚和目标项目 dry-run 通过；
+- 文档、安装清单和任务跟踪与发行包一致。