21 KiB
21 KiB
临时-产品形态阶段化重设计计划
- 版本：v1
- 更新日期：2026-05-23
- 目标读者：产品 / 架构 / 前端 / 后端 / 文档维护者
- 文档性质：本轮设计变更的流程约束和阶段管理文档，不替代正式产品、架构、流程或实现文档。
0. 本次讨论的流程约束
本轮目标是按阶段、按顺序重新设计 Muse 的产品形态和后续设计文档，不做一次性全量缝合。
必须遵守以下要求：
- 当前阶段只修改当前阶段文档，不跨阶段顺手修改后续文档。
- 讨论设计时，以已经修改并确认过的文档为准；后面阶段文档只能作为参考，不能反向压当前阶段。
- 每进入下一阶段，必须承接前面阶段已经确定的产品形态、边界、术语、非目标和硬约束，不能遗漏前面阶段设计。
- 如果后续参考文档和前面已确认设计冲突，先记录冲突并提出决策问题，不擅自缝合。
- 每个阶段结束时，必须形成可追溯的阶段结论，再进入下一个阶段。
- 本计划文档负责管理阶段、约束、决策记录和冲突记录；正式设计内容仍落在对应 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/流程-01-产品操作流程(用户视角).md / design-docs/流程-02-系统处理流程(系统视角).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. 阶段门禁
每个阶段进入前，需要确认：
- 上一阶段文档已经完成修改并被确认。
- 本阶段要修改的文档 owner 明确。
- 本阶段只处理当前 owner 文档的职责，不抢后续文档的精确归属。
- 参考后续文档时，只抽取冲突和约束，不直接按后续文档反改当前阶段。
每个阶段结束前，需要确认：
- 当前文档是否完整承接了前面阶段的已确认结论。
- 是否留下与后续阶段有关但暂不修改的待承接事项。
- 是否存在需要用户决策的冲突项。
- 是否需要把阶段结论补充到本计划文档的决策记录中。
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 系列；将确认为流程/架构必须承接的不变式 |
已修复并确认 |
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 |
| 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 纳入已确认基线；下一阶段进入 流程-01/02，继续遵守不跨阶段修改约束 |
7. 阶段交付格式
每个阶段交付时，默认输出以下内容：
- 结论：当前阶段文档是否可以进入修改或是否已经收口。
- 本阶段修改范围：明确只改哪些文件。
- 已承接的前序结论：列出来自前序阶段的关键约束。
- 暂不处理的后续事项：列出需要后续阶段承接的内容。
- 冲突和待确认问题：只保留会影响决策的问题。
- 验证状态：说明已检查哪些引用、术语、边界或文档 owner。
8. 当前下一步
当前处于阶段 3 已完成并提交：产品-02A~02G 已作为输入基线，产品-03 已完成六空间旅程总纲、子代理 review 后的定点修复，并纳入已确认基线。
下一步进入阶段 4 准备：重写 流程-01-产品操作流程(用户视角).md 和 流程-02-系统处理流程(系统视角).md。架构、专题、前端和后端文档仍作为后续阶段，不在阶段 4 顺手修改。