144 lines
19 KiB
Markdown
144 lines
19 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/流程-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~02D` 是已提交分册的局部冻结基线，可以作为管理员控制台、用户工作区/作品工作台、智能体工作台的需求输入。
|
||
- `产品-02E~02G` 已按用户本轮指令并行产出初稿和 HTML 原型，并完成子代理二轮 review 后的 PRD 闭合修复；完整 `产品-02` 详细规格基线仍需 02E~02G 再次复核确认后成立。
|
||
- 后续分册只能承接并细化 `产品-02A~02D` 已确认边界，不能把未完成分册的旧口径反向写回已冻结分册。
|
||
|
||
| 分册 | 当前状态 | 是否纳入局部冻结基线 | 未闭合事项 |
|
||
|---|---|---|---|
|
||
| `产品-02A` | 已完成 | 是 | 作为统一模板继续约束 02E~02G |
|
||
| `产品-02B` | 已完成 | 是 | 市场分类/推荐/曝光具体 surface 由 02F 承接 |
|
||
| `产品-02C` | 已完成 | 是 | 知识库工作台、市场和个人中心跳转仍保留 pending 目标 |
|
||
| `产品-02D` | 已完成 | 是 | 市场审核结果、上架、下架和申诉由 02F/02B 承接 |
|
||
| `产品-02E` | 二轮 PRD 修复完成，待复核确认 | 否 | 全局知识库 owner、处理检查、删除、导出、绑定 handoff、导出任务和申诉边界已修复；需用户确认是否纳入基线 |
|
||
| `产品-02F` | 二轮 PRD 修复完成，待复核确认 | 否 | 三类资产可信信息、owner handoff、发布检查快照、治理影响、申诉撤回和作品资产 owner 阻断已修复；需用户确认是否纳入基线 |
|
||
| `产品-02G` | 二轮 PRD 修复完成，待复核确认 | 否 | AssetSummary、作品发布跳转、安全事件确认、测试通知、账户 read-model authority 和 02F/交易/02B 边界已修复；需用户确认是否纳入基线 |
|
||
|
||
## 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 上下文 | 待后续阶段承接 |
|
||
|
||
## 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、读模型和状态机边界 |
|
||
|
||
## 7. 阶段交付格式
|
||
|
||
每个阶段交付时，默认输出以下内容：
|
||
|
||
1. 结论：当前阶段文档是否可以进入修改或是否已经收口。
|
||
2. 本阶段修改范围：明确只改哪些文件。
|
||
3. 已承接的前序结论：列出来自前序阶段的关键约束。
|
||
4. 暂不处理的后续事项：列出需要后续阶段承接的内容。
|
||
5. 冲突和待确认问题：只保留会影响决策的问题。
|
||
6. 验证状态：说明已检查哪些引用、术语、边界或文档 owner。
|
||
|
||
## 8. 当前下一步
|
||
|
||
当前处于阶段 2.5~2.7 二轮 PRD 修复完成、待复核确认：`产品-02A~02D` 是局部冻结基线，`产品-02E~02G` 已有初稿、HTML 原型和二轮 PRD 修复版，但尚未确认进入局部冻结基线。
|
||
|
||
下一步只对 `产品-02E~02G` 二轮 PRD 修复版做复核和用户确认；如确认通过，再提交并进入后续阶段。`产品-03`、流程、架构、专题、前端和后端文档仍作为参考，不跨阶段修改。
|