175 lines
34 KiB
Markdown
175 lines
34 KiB
Markdown
# 临时-产品形态阶段化重设计计划
|
||
|
||
- 版本：v1
|
||
- 更新日期：2026-05-23
|
||
- 目标读者：产品 / 架构 / 前端 / 后端 / 文档维护者
|
||
- 文档性质：本轮设计变更的流程约束和阶段管理文档，不替代正式产品、架构、流程或实现文档。
|
||
|
||
## 0. 本次讨论的流程约束
|
||
|
||
本轮目标是按阶段、按顺序重新设计 Muse 的产品形态和后续设计文档，不做一次性全量缝合。
|
||
|
||
必须遵守以下要求：
|
||
|
||
1. 当前阶段只修改当前阶段文档，不跨阶段顺手修改后续文档。
|
||
2. 讨论设计时，以已经修改并确认过的文档为准；后面阶段文档只能作为参考，不能反向压当前阶段。
|
||
3. 每进入下一阶段，必须承接前面阶段已经确定的产品形态、边界、术语、非目标和硬约束，不能遗漏前面阶段设计。
|
||
4. 如果后续参考文档和前面已确认设计冲突，先记录冲突并提出决策问题，不擅自缝合。
|
||
5. 每个阶段结束时，必须形成可追溯的阶段结论，再进入下一个阶段。
|
||
6. 本计划文档负责管理阶段、约束、决策记录和冲突记录；正式设计内容仍落在对应 owner 文档中。
|
||
|
||
## 1. 工作目标
|
||
|
||
通过分阶段设计，重新收口 Muse 的产品形态、功能边界、用户旅程、流程、架构和后续实现文档，使整套设计文档从上到下保持一致。
|
||
|
||
本轮变更的核心不是局部润色，而是先确定产品形态，再让后续文档按顺序继承，不允许后续文档各自维护一套旧口径。
|
||
|
||
## 2. 阶段顺序
|
||
|
||
| 阶段 | 目标文档 | 阶段目标 | 状态 |
|
||
|---|---|---|---|
|
||
| 阶段 0 | `design-docs/临时-产品形态阶段化重设计计划.md` | 建立本轮设计变更流程约束、阶段顺序和记录方式 | 已完成 |
|
||
| 阶段 1 | `design-docs/产品-01-产品定位与核心价值.md` | 确认产品定位、产品空间、目标用户、核心价值、非目标和成功指标 | 已完成 |
|
||
| 阶段 2.0 | `design-docs/产品-02-核心功能与交互边界.md` | 承接产品形态，重写功能边界、角色边界、交互规则和非谈判项，作为阶段 2 总纲 | 已完成 |
|
||
| 阶段 2.1 | `design-docs/产品-02A-统一功能规格模板与产品接口约定.md` | 建立详细功能规格、页面规格和产品接口的统一写法 | 已完成 |
|
||
| 阶段 2.2 | `design-docs/产品-02B-管理员控制台功能规格.md` | 明确管理员控制台的页面、数据、操作、权限和产品接口 | 已完成 |
|
||
| 阶段 2.3 | `design-docs/产品-02C-用户工作区与作品工作台功能规格.md` | 明确我的作品、作品工作台、写作台、规划、知识、导入导出等页面规格 | 已完成 |
|
||
| 阶段 2.4 | `design-docs/产品-02D-智能体工作台功能规格.md` | 明确智能体创建、配置、安装、替换槽位、试用、发布等功能规格 | 已完成 |
|
||
| 阶段 2.5 | `design-docs/产品-02E-知识库工作台功能规格.md` | 明确全局知识库、用户知识库、账户可用知识库、安装、绑定、处理状态和发布规格 | 已完成并提交 |
|
||
| 阶段 2.6 | `design-docs/产品-02F-市场功能规格.md` | 明确作品、智能体、知识库市场资产的发现、授权、安装、绑定、发布和治理规格 | 已完成并提交 |
|
||
| 阶段 2.7 | `design-docs/产品-02G-个人中心功能规格.md` | 明确个人资料、偏好、用量、权益、授权记录和发布记录总览规格 | 已完成并提交 |
|
||
| 阶段 3 | `design-docs/产品-03-用户旅程与操作流程.md` | 承接产品空间和功能边界，重写管理员、普通用户、智能体、市场等旅程 | 已完成并提交 |
|
||
| 阶段 4 | `design-docs/流程-01A-管理员操作流程(操作视角).md` / `design-docs/流程-01B-普通用户操作流程(操作视角).md` / `design-docs/流程-02A-管理员系统处理流程(系统视角).md` / `design-docs/流程-02B-普通用户系统处理流程(系统视角).md` | 按角色拆分操作流程和系统处理流程 | 已完成并提交 |
|
||
| 阶段 5 | `design-docs/架构-01-系统全貌与边界上下文.md` / `design-docs/架构-02-核心数据结构与双轨模型.md` / `design-docs/架构-04-状态机与约束清单.md` | 承接产品与流程，调整有界上下文、核心模型、状态机和约束清单 | 已完成并提交 |
|
||
| 阶段 6 | `design-docs/专题-*` | 按需要调整 AI 编排、质量门控、竞品取舍、正文建议接受等专题合同 | 已完成并提交 |
|
||
| 阶段 7 | `design-docs/前端-*` / `design-docs/后端-*` | 承接产品、流程、架构结论，更新工程结构、Schema、API 和实现约束 | 整体一致性修复完成，待复核确认 |
|
||
| 阶段 8 | `design-docs/00-文档大纲.md` / `design-docs/内容映射表.md` | 最后统一索引、文档 owner 和内容映射，清理过期引用 | 已开始；四仓工程架构索引已补 |
|
||
|
||
阶段 2 当前基线状态：
|
||
|
||
- `产品-02A~02G` 已按阶段完成、修复并提交，其中 `产品-02E~02G` 已通过本轮用户确认进入阶段 3 的输入基线。
|
||
- 阶段 3 以 `产品-01`、`产品-02`、`产品-02A~02G` 为前序事实来源，重写 `产品-03` 的用户旅程和操作流程。
|
||
- 后续流程、架构、专题、前端和后端文档只能承接阶段 1~3 已确认结论，不能反向修改当前阶段已确认边界。
|
||
|
||
| 分册 | 当前状态 | 是否纳入局部冻结基线 | 未闭合事项 |
|
||
|---|---|---|---|
|
||
| `产品-02A` | 已完成 | 是 | 作为统一模板继续约束 02E~02G |
|
||
| `产品-02B` | 已完成 | 是 | 市场分类/推荐/曝光具体 surface 由 02F 承接 |
|
||
| `产品-02C` | 已完成 | 是 | 知识库工作台、市场和个人中心跳转仍保留 pending 目标 |
|
||
| `产品-02D` | 已完成 | 是 | 市场审核结果、上架、下架和申诉由 02F/02B 承接 |
|
||
| `产品-02E` | 已完成并提交 | 是 | 作为知识库工作台旅程、绑定、处理状态和发布准备的输入基线；全局知识库治理 authority 仍归 02B |
|
||
| `产品-02F` | 已完成并提交 | 是 | 作为市场发现、授权、安装、handoff、发布提交和治理结果的输入基线；作品资产 owner 缺口仍由后续 02C/流程阶段承接 |
|
||
| `产品-02G` | 已完成并提交 | 是 | 作为个人中心账户总览、用量、权益、授权、发布记录和安全事件的输入基线；个人中心仍只是 read model 和跳转空间 |
|
||
|
||
## 3. 阶段门禁
|
||
|
||
每个阶段进入前，需要确认：
|
||
|
||
1. 上一阶段文档已经完成修改并被确认。
|
||
2. 本阶段要修改的文档 owner 明确。
|
||
3. 本阶段只处理当前 owner 文档的职责，不抢后续文档的精确归属。
|
||
4. 参考后续文档时，只抽取冲突和约束，不直接按后续文档反改当前阶段。
|
||
|
||
每个阶段结束前，需要确认：
|
||
|
||
1. 当前文档是否完整承接了前面阶段的已确认结论。
|
||
2. 是否留下与后续阶段有关但暂不修改的待承接事项。
|
||
3. 是否存在需要用户决策的冲突项。
|
||
4. 是否需要把阶段结论补充到本计划文档的决策记录中。
|
||
|
||
## 4. 设计讨论规则
|
||
|
||
讨论设计时，所有结论按以下优先级判断：
|
||
|
||
1. 已确认并已修改的前序阶段文档。
|
||
2. 当前阶段正在讨论和准备修改的目标文档。
|
||
3. 后续阶段文档中的参考信息。
|
||
4. 代码实现、旧文档、历史计划和外部竞品信息。
|
||
|
||
如果不同来源发生冲突：
|
||
|
||
- 前序阶段已确认内容优先。
|
||
- 后续阶段文档只能登记为待承接或待修正，不能反向否定前序阶段。
|
||
- 如果冲突会改变产品形态、权限边界、资产边界或数据模型，必须先提问确认。
|
||
|
||
## 5. 冲突记录
|
||
|
||
| 编号 | 发现阶段 | 冲突来源 | 冲突描述 | 处理方式 | 状态 |
|
||
|---|---|---|---|---|---|
|
||
| C-001 | 阶段 1 准备 | 新版 `产品-01` 与旧 `产品-02/03` | 新版引入智能体工作台、知识库工作台和市场空间，旧后续文档尚未承接 | 阶段 2 已由 `产品-02` 承接；阶段 3 继续由 `产品-03` 承接，不在阶段 2 跨文档修改 | 部分承接 |
|
||
| C-002 | 阶段 2.5~2.7 二轮复核 | `产品-02C` 局部冻结基线与 02F/02G 作品资产发布/使用需求 | 02F/02G 需要作品资产发布准备包和作品资产使用 owner，但当前不能跨阶段修改已冻结的 02C | 在 02F/02G 中标为后续阻断：02C 后续补齐 `work-publish-prep` 和作品资产使用预检前，作品资产不得提交发布、模板化、参考写入或进入 AI 上下文 | 待后续阶段承接 |
|
||
| C-003 | 阶段 3 review | `产品-03` 初稿与前序安全/资产边界 | 子代理 review 发现外部知识 lineage、保护节点不可开放、handoff 生命周期、知识库类型、市场授权/安装/绑定状态、管理员分权等边界需要补强 | 阶段 3 只修 `产品-03`，不反改 02 系列；将确认为流程/架构必须承接的不变式 | 已修复并确认 |
|
||
| C-004 | 阶段 4 review / 阶段 5 复核 | `产品-03` 与阶段 4 四分册 | 初次 review 认为 `产品-03` 中存在“已确认作品事实自动回滚”的旧口径残留；阶段 5 复核确认该短语位于“不能被解释为”列，不是旧口径 | 不需要跨阶段修改 `产品-03`；阶段 4 和阶段 5 均继续按“已确认事实不自动回滚，但受限来源不得继续进入新生成、新绑定、新导出许可范围或新的知识确认”处理 | 已复核，无需修改 |
|
||
| C-005 | 阶段 7 准备 | 旧 `前端-*` / `后端-*` 与当前 Muse 工程口径 | 旧前端文档把管理员后台和用户端都写成 Next.js 同一前端；旧后端文档按 `muse-*` 自研模块化单体描述，未承接 Yudao Cloud fork、Vben Admin 管理后台和独立 `muse-studio` 用户端的工程基线 | 阶段 7 已按新工程口径重写前后端架构：后端以 `muse-cloud/` fork 为底座，管理后台走 `muse-admin/`，用户端单独自研 `muse-studio/`；阶段 8 已补四仓工程架构索引 | 已承接，待确认 |
|
||
| C-006 | 阶段 7 整体 review 修复 | 已完成的产品、流程、架构、专题、前端、后端分册 | 多角度整体 review 发现 P0 跨文档冲突：MetaSchema logical owner 与物理落表混淆、Agent/Tool Grant/Runtime Permission 可被 AI runtime 自授权、Market handoff/precheck 抢目标 owner、Parse Job owner 冲突、动态字段泛写入口绕过事实 owner、SourceStatus/SourceEventType/Action Policy 命名不统一、Accept/Merge 缺 Candidate Decision Envelope 硬闸门、作品资产被提前写成可模板化/参考/进 AI 上下文 | 用户明确要求拆分独立任务并用子代理修复，因此本次作为 P0 一致性修复例外，打开受影响 owner 文档定点修复；阶段 8 已开始补索引，当前先补四仓工程架构 | 已修复，待复核 |
|
||
|
||
## 6. 决策记录
|
||
|
||
| 编号 | 日期 | 阶段 | 决策 | 影响范围 |
|
||
|---|---|---|---|---|
|
||
| D-001 | 2026-05-22 | 阶段 0 | 本轮设计变更采用按阶段、按顺序推进；当前阶段只改当前阶段文档；后续文档只作为参考 | 全部设计文档 |
|
||
| D-002 | 2026-05-22 | 阶段 1 | `产品-01` 锁定六个产品空间：管理员控制台、用户工作区、智能体工作台、知识库工作台、市场、个人中心；知识库作为可管理、可复用、可上架市场的一级资产 | `产品-01` 已修改；后续 `产品-02/03`、流程、架构、前后端文档必须按阶段承接 |
|
||
| D-003 | 2026-05-22 | 阶段 1 | 管理员元数据治理必须保留；大量 AI 能力是系统预编排功能链路，用户只能替换开放槽位中的子智能体；输入输出合规、拆分切块、入 RAG、语义安全围栏、静态检查等系统保护节点不可替换 | `产品-01` 已修改；阶段 2 需要在 `产品-02` 中细化可替换槽位和不可替换系统节点 |
|
||
| D-004 | 2026-05-22 | 阶段 1 | 子代理评审后补强 `产品-01` 的 P0/P1 边界：主产品楔子与六空间优先级、市场授权不等于所有权转移、第三方市场资产默认不可信、正文保存与知识入库分层、替换槽位合同、管理员治理分权、信任与合规指标 | `产品-01` 已修改；阶段 2 起必须继续承接这些边界，不能把后续功能设计成越权、自动污染作品事实或单点超级权限 |
|
||
| D-005 | 2026-05-22 | 阶段 2.0 | `产品-02` 按六个产品空间重构功能与交互边界，并明确系统功能编排、替换槽位合同、三类知识库、市场授权、Shadow/Canonical、stale guard、全书解析章节边界和非谈判项 | `产品-02` 已修改；阶段 2.1~2.7 和阶段 3 需要按这些边界继续细化，不反向修改阶段 1/2.0 结论 |
|
||
| D-006 | 2026-05-22 | 阶段 2.0 | 子代理评审后修复 `产品-02` 的 P1/P2 边界：no-config 主路径、authority/surface、管理员分权、工作流智能体工具授权、市场授权生命周期、作品资产使用入口、上下文外发、来源状态校验、全书解析两步确认、候选知识变更状态和渐进展示 | `产品-02` 已修改；阶段 2.1~2.7 和阶段 3/4/5 必须继续承接这些交互、流程、状态机和权限边界 |
|
||
| D-007 | 2026-05-22 | 阶段 2.1 | `产品-02` 不继续膨胀为单一大 PRD；阶段 2 拆为总纲 + `产品-02A~02G` 详细功能规格。详细规格必须能支撑前端 UI 原型，覆盖页面、可见数据、用户操作、状态、权限、异常和产品接口 | 新增 `产品-02A` 统一模板；后续按六个产品空间继续补 `产品-02B~02G` |
|
||
| D-008 | 2026-05-22 | 阶段 2.2 | 子代理评审后修复 `产品-02B` 的 P0/P1 缺口：补齐管理员控制台页面 ID、产品接口闭环、系统智能体配置、质量评估集与结果、质量效果观测、市场申诉、来源状态展示、分权防自批、上下文外发门禁、任务重验矩阵、New-API 调用日志归属和审计不可篡改边界 | `产品-02B` 已修改；阶段 2.2 仍待用户确认，确认后再进入 `产品-02C`，不跨阶段修改用户工作区、智能体工作台、知识库工作台、市场或个人中心分册 |
|
||
| D-009 | 2026-05-22 | 阶段 2.2 | 原型暴露 `产品-02B` 的 PRD 粒度和孤儿功能问题：删除管理员角色变更申请、New-API 复制式队列/差异/补偿、市场推荐分类等无当前业务发起人的功能；New-API 改为直接调用网关用户、订阅额度、余额和调用日志接口；日志拆为接口调用日志和业务审计日志；新增页面字段与查询条件规格和功能点合法性清单 | `产品-02B` 已修改；后续 `产品-02C~02G` 也必须按“页面字段 + 查询条件 + 操作反馈 + 业务发起人”粒度编写，避免只描述组件或制造孤儿功能 |
|
||
| D-010 | 2026-05-22 | 阶段 2.2 | 根据原型复审继续收敛 `产品-02B`：补充类似 yudao 的角色、权限组、菜单页面权限、操作权限和数据范围模型；新增“权限组与菜单页面权限”页面；删除通用私有正文查看入口；删除独立来源失效管理页，改为在引用来源处展示“来源已失效/已下架/授权已撤销/需重验” | `产品-02`、`产品-02A`、`产品-02B` 已做当前阶段一致性修正；后续分册只能承接来源状态展示和权限管控模型，不再恢复独立来源管理后台或通用私有正文访问入口 |
|
||
| D-011 | 2026-05-22 | 阶段 2.3 | `产品-02B` 本轮复核未发现阻断问题，仅修正当前文档内来源状态旧口径残留；阶段 2.3 进入 `产品-02C`，按 `产品-02A` 模板补齐用户工作区与作品工作台的页面、字段、操作、状态和产品接口 | 新增 `产品-02C`；阶段 2.3 待确认，确认后再进入 `产品-02D`，不跨阶段修改智能体工作台、知识库工作台、市场或个人中心分册 |
|
||
| D-012 | 2026-05-22 | 阶段 2.4 | 用户确认 `产品-02C` 通过后，阶段 2.4 进入 `产品-02D`；`产品-02D` 按 `产品-02A` 模板补齐智能体工作台的智能体列表、创建、配置型编辑、工作流编辑、试用、槽位兼容、作品槽位候选选择、已安装授权、发布准备、运行用量和产品接口 | 新增 `产品-02D`；已由 D-014 提交通过，不跨阶段修改知识库工作台、市场或个人中心分册 |
|
||
| D-013 | 2026-05-22 | 阶段 2.4 | 子代理评审后修复 `产品-02D` 的 P0/P1 缺口：补齐 handoff session 与 `precheckId` 原子消费、市场/第三方智能体信任模型、Prompt 注入与敏感信息治理、Tool Grant 合同、试用异步状态、幂等和快照消费、授权/版本/绑定传播矩阵、运行记录视图拆分、发布草稿到市场审核申请边界、页面状态矩阵和字段级规格 | `产品-02D` 与 02D 原型已修改；已由 D-014 提交通过，不跨阶段修改知识库工作台、市场或个人中心分册 |
|
||
| D-014 | 2026-05-22 | 阶段 2.4 -> 2.5 | 用户要求提交 `产品-02A~02D` 相关文档并进入下个阶段；`产品-02D` 视为当前阶段通过，阶段 2.5 开始处理知识库工作台规格 | `产品-02A~02D` 作为局部冻结基线；完整 02 系列仍需 02E~02G 完成后成立 |
|
||
| D-015 | 2026-05-22 | 阶段 2.4 修复 | 大厂级 PRD review 后修复 `产品-02A~02D` 的基线和原型问题：明确 02A~02D 只是局部冻结基线，补 HTML 原型验收合同、横切安全与数据治理合同、02C 页面/操作/接口覆盖表、02C 决策接口幂等与授权快照、02B/02C 指向 02D 的精确页面 ID，并修正 02C/02D 原型中失效来源可确认、功能平铺、暂缓备份和普通作者默认暴露资产作者入口等误导 | 只修复已提交的 02A~02D、阶段计划和既有原型；不推进 02E，不修改 02F~02G |
|
||
| D-016 | 2026-05-22 | 阶段 2.5 | 根据用户要求开始 `产品-02E`，新增知识库工作台详细规格初稿，覆盖知识库列表、创建、资料管理、处理状态、已安装授权、作品绑定、发布准备、使用记录、全局知识库视图和产品接口 | 当前只新增 `产品-02E` 并更新本计划记录；不修改 02F~02G、产品-03、流程、架构、前端或后端文档 |
|
||
| D-017 | 2026-05-22 | 阶段 2.5~2.7 并行初稿 | 用户纠正本轮并行目标为 `产品-02E/02F/02G`；启动三个子代理分别完善知识库工作台、市场、个人中心文档和对应 HTML 原型 | 新增或完善 `产品-02E/02F/02G` 与对应原型；仍不修改 `产品-03`、流程、架构、专题、前端或后端文档；后续需要对 02E~02G 做统一 review 和确认 |
|
||
| D-018 | 2026-05-23 | 阶段 2.5~2.7 review | 子代理 review 发现 02E/02F/02G PRD 仍有闭合缺口：02E 全局知识库 owner、删除/导出/处理检查/handoff；02F handoff、三类资产分型、发布材料、召回影响、申诉状态、PRD 验收混入执行项；02G AssetSummary、作品发布路径、安全导出、偏好操作、收藏摘要 | 进入定点修复；只改 02E/02F/02G PRD 和本计划，不改 HTML、产品-03、流程、架构、专题、前端或后端文档 |
|
||
| D-019 | 2026-05-23 | 阶段 2.5~2.7 修复 | 按 review 结果修复 02E/02F/02G PRD：收紧全局知识库 authority 到 02B；补处理检查、删除、导出和绑定 handoff；补市场三类资产可信信息、发布材料、治理影响、申诉状态和 handoff 不变式；补个人中心 AssetSummary、作品发布跳转、安全事件导出、偏好动作接口和收藏摘要边界 | 修复完成后待复核确认；确认前 02E~02G 不纳入局部冻结基线，不进入产品-03/流程/架构阶段 |
|
||
| D-020 | 2026-05-23 | 阶段 2.5~2.7 二轮 review | 子代理复核未发现 P0，但发现 P1/P2：02E 删除/导出任务闭合不足；02F 市场 owner 写入冲突、预检快照、发布检查快照、申诉撤回、治理处理 handoff 和作品资产 owner 缺失；02G 安全事件确认、测试通知口径、账户 ledger authority 和 02F/交易/02B owner 文案过宽 | 进入二轮定点修复；仍只改 02E/02F/02G PRD 和本计划，不改 HTML、产品-03、流程、架构、专题、前端或后端文档 |
|
||
| D-021 | 2026-05-23 | 阶段 2.5~2.7 二轮修复 | 修复二轮 findings：02E 补导出预检/任务/下载、取消删除和绑定 handoff 查询；02F 改为市场只生成安装/关联/绑定/治理 handoff，补 `agentSlotPrecheckId`、`kbBindPrecheckId`、`workAssetUsePrecheckId`、`marketPublishCheckId`、申诉撤回和作品资产 owner 阻断；02G 补安全事件本人确认、测试通知只面向已验证渠道、账户记录 read-model authority、02F/02B/交易分册边界和作品发布阻断 | 修复完成，待再次复核确认；后续架构阶段需承接 Marketplace/Asset、License/Installation、User Knowledge Asset、Account Ledger/Handoff 的 BC、authority、读模型和状态机边界 |
|
||
| D-022 | 2026-05-23 | 阶段 2.5~2.7 -> 3 | 用户要求提交 `产品-02E~02G` 并提交到 main 后进入 `产品-03`；`产品-02A~02G` 作为阶段 3 输入基线 | 阶段 3 可以重写 `产品-03`；仍不跨阶段修改流程、架构、专题、前端或后端文档 |
|
||
| D-023 | 2026-05-23 | 阶段 3 review | 子代理 review `产品-03` 初稿后确认大框架成立，但必须修复外部知识 lineage、保护节点注册表、handoff 生命周期、三类知识库口径、市场授权状态、管理员分权、no-config 长篇主路径、取消/任务/失败反馈等问题 | 阶段 3 进入定点修复；只改 `产品-03` 和本计划 |
|
||
| D-024 | 2026-05-23 | 阶段 3 修复 | 按 review 结果修复 `产品-03`：补外部来源 lineage、防知识洗白、保护节点注册表与 allowlist、管理员分权、New-API 最小权限和账务 owner 边界、智能体版本/工具授权快照、三类知识库 owner、市场授权/安装/绑定/使用/召回状态、作品资产 owner 阻断、handoff 生命周期、异步任务取消和失败反馈 | 修复完成，等待用户确认；确认前不进入阶段 4 的流程文档重写 |
|
||
| D-025 | 2026-05-23 | 阶段 3 提交 | 用户确认阶段 3 修复结果，要求更新阶段计划并提交 `产品-03` 与阶段计划 | 阶段 3 纳入已确认基线；下一阶段进入流程文档阶段，继续遵守不跨阶段修改约束 |
|
||
| D-026 | 2026-05-23 | 阶段 4 启动 | 用户要求进入下个阶段；阶段 4 处理流程文档，承接 `产品-01`、`产品-02`、`产品-02A~02G`、`产品-03` 的已确认基线 | 旧流程文档结构仅作为参考；本阶段不修改产品、架构、专题、前端或后端文档 |
|
||
| D-027 | 2026-05-23 | 阶段 4 拆分 | 用户要求阶段 4 拆成四个流程文档：管理员操作视角、普通用户操作视角、管理员系统处理流程、普通用户系统处理流程 | 阶段 4 最终交付四个分册；旧流程文档作为旧稿参考，不再作为最终承重文档 |
|
||
| D-028 | 2026-05-23 | 阶段 4 四分册初稿 | 创建 `流程-01A`、`流程-01B`、`流程-02A`、`流程-02B` 四个新分册，并将旧流程文档改为拆分导航页 | 四分册进入初稿校验和 review；本阶段仍不修改产品、架构、专题、前端或后端文档 |
|
||
| D-029 | 2026-05-23 | 阶段 4 review | 启动新子代理 review 四个分册，发现必须修复的问题：全书解析章节确认不能写正式知识、作品资产模板化/参考来源/AI 上下文当前必须阻断、外部来源不能通过“改写自有事实”洗白、handoff 绑定条件不足、来源传播目标不全、导出/下载和账户安全链路缺失、系统智能体发布与市场恢复缺高危门禁、New-API 和任务治理流程过粗 | 进入阶段 4 定点修复；只改四个流程分册和本计划，不修改产品、架构、专题、前端或后端文档 |
|
||
| D-030 | 2026-05-23 | 阶段 4 修复 | 按 review 结果修复四个分册：章节解析确认只产生待确认知识草稿；作品资产当前只允许阅读、收藏和授权记录；改写自有事实保留 lineage、授权快照和召回状态；补 handoff 绑定字段、导出安全链路、账户安全链路、来源传播对象全集、管理员脱敏边界、系统智能体影响预览/灰度/复核、市场恢复重检、New-API 最小权限与幂等补偿、任务类型治理矩阵 | 修复完成后进入校验和用户确认；确认前不进入阶段 5 架构文档 |
|
||
| D-031 | 2026-05-23 | 阶段 4 引用迁移 | 用户确认删除旧流程导航页，活跃文档引用全部迁移到 `流程-01A/01B/02A/02B` 四个分册 | 删除旧导航页；四个分册成为唯一流程入口；本次只做引用迁移和导航归属调整，不重写产品、架构、专题、前端或后端设计内容 |
|
||
| D-032 | 2026-05-23 | 阶段 5 启动 | 用户确认进入架构阶段；阶段 5 只修改 `架构-01`、`架构-02`、`架构-04` 和本计划，承接阶段 1~4 已确认的六产品空间、系统保护节点、用户知识库、市场授权、handoff、来源 lineage、全书解析章节确认和 New-API 边界 | `架构-01/02/04` 进入重写；产品、流程、专题、前端和后端文档不在本阶段顺手修改 |
|
||
| D-033 | 2026-05-23 | 阶段 5 初稿 | 重写 `架构-01/02/04`：`架构-01` 改为六产品空间与 BC owner 的架构边界，`架构-02` 补齐用户知识库、市场资产、智能体槽位、handoff、来源 lineage、授权快照、导出和账户用量模型，`架构-04` 重写候选、知识草稿、全书解析章节审阅、知识库、智能体、市场授权、handoff、来源传播、导出下载、New-API 和审计状态机 | 阶段 5 初稿已完成并进入校验；待 review 和用户确认后再提交，不修改专题、前端或后端文档 |
|
||
| D-034 | 2026-05-23 | 阶段 5 review | 子代理 review 未发现 P0，但发现需要修复的 P1/P2：正文 Canonical 来源承载、New-API 凭据安全、智能体运行时权限包、导出包安全、个人中心模型、作品/章节/规划正式态生命周期、市场发布检查快照、BC 落地矩阵、handoff owner/precheck、授权快照与来源状态事件合同、导出 owner 拆分、New-API 执行链与归属链拆分、状态命名一致性 | 进入阶段 5 定点修复；只改 `架构-01/02/04` 和本计划，不修改产品、流程、专题、前端或后端文档 |
|
||
| D-035 | 2026-05-23 | 阶段 5 修复 | 按 review 结果修复 `架构-01/02/04`：补 BC 落地矩阵、关键 authority 表、Handoff owner 合同、导出 owner 拆分、New-API 凭据和执行/归属链边界、文件导出安全；补 Block Source Attribution、Parse/Chapter Review、Source Status Event、Authorization Snapshot、Agent Runtime Permission Envelope、发布检查快照、个人中心与导出模型；补 Work/Chapter/Planning 生命周期、章节审阅状态、发布检查状态、来源传播任务、导出下载和审计约束 | 阶段 5 review 修复完成，进入校验和用户确认；确认前不进入专题、前端或后端阶段 |
|
||
| D-036 | 2026-05-23 | 阶段 5 -> 6 | 用户确认提交阶段 5 并进入下一个阶段；阶段 5 架构文档纳入已确认基线，阶段 6 开始处理 `专题-*` 文档 | 阶段 6 只能承接阶段 1~5 已确认的产品、流程和架构结论；本次提交不修改专题、前端或后端文档 |
|
||
| D-037 | 2026-05-23 | 阶段 6 初稿修复 | 检查专题文档后确认不能跳过：`专题-01` 仍有接受候选同步确认知识草稿的旧口径，`专题-03` 夹带旧 Proposal、默认超级管理员和 doc/dev 门禁口径，`专题-04` 为空文件且承接质量门控/创作健康度，`专题-02` 需要从实现态对标改为取舍参考 | 阶段 6 只修改 `专题-01/02/03/04` 和本计划；不修改产品、流程、架构、前端或后端文档 |
|
||
| D-038 | 2026-05-23 | 阶段 6 修复 | 修复专题文档初稿：`专题-01` 改为接受候选只写正文和候选归档、不自动确认知识草稿，并补 Block Source Attribution；`专题-03` 重写为 AI 编排、运行时权限包、上下文组装、检索、风险路由、质量评测输入和 New-API 边界合同；`专题-04` 补齐质量门控、创作健康度、关键维度、有限重写、质量策略、来源变化和验收清单；`专题-02` 轻量刷新为竞品取舍参考，不再承载旧实现态口径 | 初稿修复完成后进入校验和 review；确认前不进入前端/后端阶段 |
|
||
| D-039 | 2026-05-23 | 阶段 6 review | 子代理严格 review 发现阶段 6 专题仍有 P0/P1 闭合缺口：Accept 对 revoked/recalled/blocked/owner_missing 等正文来源未硬阻断；市场作品资产 feature gate 和 `workAssetUsePrecheckId` 缺失；离线质量评估缺私有内容边界；接口样例过细、幂等不足、`contentOverride` 可能洗白来源；AI 编排和质量门控的候选状态、风险合并、New-API 脱敏、Source Status Event 传播和 Writing Health owner 需要统一 | 进入阶段 6 定点修复；仍只改 `专题-01/02/03/04` 和本计划，不修改产品、流程、架构、前端或后端文档 |
|
||
| D-040 | 2026-05-23 | 阶段 6 review 修复 | 按 review 结果修复专题文档：`专题-01` 收回到决策命令语义合同，补幂等、接受前置条件、作品资产预检、正文来源硬阻断、修改后合并 lineage 继承和失败矩阵；`专题-03` 补 Provisional Shadow Candidate、Tool Grant、Authorization Snapshot、检索结果合同、Candidate Decision Envelope、质量状态、New-API 脱敏和来源传播矩阵；`专题-04` 拆硬阻断/叙事关键/非关键维度，补决策优先级、离线评估私有内容边界、线上质量观测和下游承接；`专题-02` 去除旧实现态断言并改为目标取舍语言 | 阶段 6 review 修复完成，待复核确认；确认前不进入阶段 7 前端/后端文档 |
|
||
| D-041 | 2026-05-23 | 阶段 6 -> 7 | 用户要求提交阶段 6 并进入下个阶段；`专题-01/02/03/04` 和阶段计划纳入已确认基线，阶段 7 准备处理前端/后端文档 | 阶段 7 只能承接阶段 1~6 已确认的产品、流程、架构和专题结论；索引与内容映射仍属于阶段 8，不在阶段 7 顺手修改 |
|
||
| D-042 | 2026-05-23 | 阶段 7 工程基线 | 阶段 7 前后端工程口径调整为：后端主仓为 `muse-cloud/`，fork `YunaiV/yudao-cloud`；管理后台为 `muse-admin/`，fork `yudao-ui-admin-vben` 并使用 `apps/web-antd`，基于 Vue 3 + Vite + Ant Design Vue + TypeScript，接口走 `/admin-api/**`；用户端单独自研 `muse-studio/`，建议 Next.js / React / TypeScript，接口走 `/app-api/**`；设计文档后续可独立为 `muse-design-docs/` | 阶段 7 重写 `前端-*` / `后端-*` 必须以此为工程基线；保留 `system/infra/ai/member/pay/bpm/report/mp` 等 Yudao 能力口径，已裁剪 `mall/crm/erp/mes/iot` 和空壳 `yudao-ui`；`mp` 明确保留 |
|
||
| D-043 | 2026-05-23 | 阶段 7 初稿 | 按 D-042 重写阶段 7 前后端文档：前端拆为 `muse-admin/` 管理后台和独立 `muse-studio/` 用户端；后端主仓 `muse-cloud/` 拆为 Yudao 原生模块复用和 Muse `content/knowledge/ai/market/account` 业务模块；API 改为 `/admin-api/**` 与 `/app-api/**`；Schema 改为 Yudao fork 下的模块级业务 Schema，`后端-04a` 降级为旧 SQL 历史快照且禁止执行 | 阶段 7 初稿已覆盖 `前端-01/02/03`、`后端-01/02/03/04/04a/05` 和本计划；确认前不进入阶段 8，不修改 `00-文档大纲.md` 与 `内容映射表.md` |
|
||
| D-044 | 2026-05-23 | 阶段 7 review 修复 | 用户确认阶段 7 可拆分给 worker 并行修订；review 发现的 New-API owner、管理员私有内容边界、MetaSchema 投影兼容、planning owner API、用户知识库工作台依赖、Source/Authorization owner、保护节点注册表、handoff owner、Schema/API 缺口已按分册修复 | 阶段 7 review 修复已完成，待主代理复核和用户确认；阶段 8 索引与内容映射继续保持未修改，确认前不进入阶段 8 |
|
||
| D-045 | 2026-05-24 | 阶段 7 整体一致性修复 | 用户要求对整体设计文档中“不对、不一致、不闭环”的内容拆成独立可修复任务并用子代理修复；本轮按架构 owner、后端 Schema/API、产品/原型、流程/专题、前端分册并行修复，并由主代理补齐残留：作品资产当前只允许阅读/收藏/授权记录；MetaSchema 逻辑 owner 固定为 Admin/Governance；Agent/Tool Grant/Runtime Permission 不能由 AI runtime 自授权；Market 只发起来源侧 handoff，目标 owner 自己创建和消费 precheck；Parse Job / Chapter Parse Result 归 AI Orchestration；动态字段无跨 owner 泛写接口；Accept/Merge 必须消费或重算 Candidate Decision Envelope；SourceStatus / SourceEventType / SourceActionPolicy 统一包含 delisted/read_only 语义 | 受影响的产品、流程、架构、专题、前端、后端文档已定点修复；阶段 8 在 D-046 开始补索引；本轮修复待复核确认后再进入更完整的阶段 8 清理 |
|
||
| D-046 | 2026-05-24 | 阶段 8 工程仓库索引 | 用户确认开始补齐四仓工程架构索引；本次将 `muse-cloud/`、`muse-admin/`、`muse-studio/`、`muse-design-docs/` 写入 `00-文档大纲.md` 和 `内容映射表.md`，并同步 `前端-01`、`后端-02` 的仓库命名映射 | 阶段 8 仅刷新工程仓库索引和 owner 映射，不改产品功能边界、Schema、API 或状态机 |
|
||
|
||
## 7. 阶段交付格式
|
||
|
||
每个阶段交付时，默认输出以下内容：
|
||
|
||
1. 结论：当前阶段文档是否可以进入修改或是否已经收口。
|
||
2. 本阶段修改范围：明确只改哪些文件。
|
||
3. 已承接的前序结论：列出来自前序阶段的关键约束。
|
||
4. 暂不处理的后续事项：列出需要后续阶段承接的内容。
|
||
5. 冲突和待确认问题：只保留会影响决策的问题。
|
||
6. 验证状态：说明已检查哪些引用、术语、边界或文档 owner。
|
||
|
||
## 8. 当前下一步
|
||
|
||
当前处于阶段 8 工程仓库索引补齐：阶段 7 整体一致性修复已完成但仍待复核确认；本轮先把四仓工程架构写入入口索引和映射表，并同步前后端工程文档的目标仓库命名。
|
||
|
||
下一步是统一复核：P0 是否已清空，Yudao 原生模块复用边界、`account` 与 `member` 的后续物理落地决策、Schema 与 API 的 owner 闭合、`muse-admin/` 与 `muse-studio/` 的入口边界、MetaSchema 与 Source/Authorization 横切模型落点、`后端-04a` 降级为历史 SQL 快照后是否需要在后续实现阶段重新生成模块 migration，以及阶段 8 的索引/映射文档是否还有其他过期引用需要清理。
|
||
|
||
阶段 8 已开始处理 `00-文档大纲.md` 与 `内容映射表.md`。本次只补四仓工程架构和仓库 owner 映射；其他索引、过期引用和内容映射清理仍需后续复核。
|