oh-my-muse/design-docs/流程-01-产品操作流程(用户视角).md
zizi 0d0e1d4473 添加产品设计文档
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
2026-05-20 10:38:31 +08:00

11 KiB
Raw Blame History

流程-01产品操作流程用户视角

  • 版本v5
  • 更新日期2026-05-10
  • 目标读者:产品 / 前端 / 测试
  • 阅读时间20-30 分钟
  • 边界说明:这里只写普通用户(User)如何完成作品创作任务;不承载管理员后台配置流程,不重复接口和底层状态机。本文件定义目标产品形态,不代表当前代码都已实现。关键术语沿用 产品-02 的“中文(English)”口径。

1. 流程总览

1.1 普通用户主流程

普通用户登录后的第一屏必须是我的作品(My Works),再从我的作品进入单个作品的作品工作台(Work Workspace)。

graph LR
    A[登录] --> B[我的作品]
    B --> C{选择作品入口}
    C -->|继续写作| D[进入单个作品工作台]
    C -->|新建作品| E[创建作品]
    C -->|从文稿创建作品| F[导入文稿]
    E --> D
    F --> D
    D --> G[写作台]
    D --> H[作品规划台]
    D --> I[知识与一致性]
    D --> J[导入解析]
    D --> K[导出交付]
    D --> L[记录与用量]
    G --> M{是否使用 AI 辅助}
    H --> M
    M -->|否| N[保存正文或规划]
    M -->|是| O[查看候选卡]
    O --> P{处理当前建议}
    P -->|确认| Q[进入正式内容]
    P -->|修改后合并| R[正文落地并重新提取]
    P -->|丢弃当前建议| G
    N --> S[查看知识变更提示]
    R --> S
    S --> T{确认知识}
    T -->|确认| I
    T -->|忽略| G
    I --> G
    J --> U[章节确认]
    U --> I
    K --> V[交付或备份]
    L --> G

1.2 这张图真正表达的事

  • 我的作品(My Works)只是作品列表和入口;正文编辑、规划、解析确认、导出配置都发生在单个作品工作台(Work Workspace)里。
  • 写作台(Writing Desk)是进入作品后的默认工作区,作品规划台(Planning Desk)、知识与一致性、导入解析、导出交付、记录与用量按需要打开。
  • AI 辅助不单独成为普通用户的后台导航,而是贴在写作、规划、知识和导入解析等具体场景里。
  • AI 候选先进入待审层(Shadow),普通用户确认后才进入规范数据(Canonical);修改后合并必须让旧知识草稿失效并重新提取。

2. 我的作品入口流程

步骤 1进入我的作品(My Works)

用户操作

  1. 普通用户登录。
  2. 查看自己的作品列表、最近编辑、作品状态、搜索筛选、排序和继续写作入口。
  3. 选择打开已有作品、新建作品,或从文稿创建作品。

系统反馈

  • 默认展示用户自己有权访问的作品。
  • 作品卡片展示可理解的创作状态,例如最近编辑、章节进度、待确认数量或导入状态摘要。
  • 点击作品后进入该作品的作品工作台(Work Workspace),默认落在写作台(Writing Desk)。

边界

  • 我的作品(My Works)不展开正文编辑、作品规划、知识确认、全书解析详情或导出配置。
  • 如果列表页提供“导入”或“导出”入口,产品语义也是进入某个作品的导入解析或导出交付流程。

步骤 2新建作品或从文稿创建作品

用户操作

  1. 新建作品时填写最少必要信息。
  2. 从文稿创建作品时选择文件并提交导入。
  3. 创建成功后进入单个作品工作台(Work Workspace)。

系统反馈

  • 新建作品成功后,用户可以先写正文,也可以进入作品规划台(Planning Desk)补全作品设定。
  • 文稿导入成功后,章节和正文出现在该作品下;导入失败时展示失败原因和可恢复动作。

失败与恢复

  • 创建失败时保留用户输入,不能整页清空。
  • 导入部分成功时必须如实展示已导入范围、失败范围和下一步动作。

3. 单个作品工作台流程

作品工作台(Work Workspace)是单个作品的创作空间,不是系统后台。它至少承载六类用户流程:写作台、作品规划台、知识与一致性、导入解析、导出交付、记录与用量。

3.1 写作台(Writing Desk)

用户操作

  1. 打开作品后默认进入写作台。
  2. 在章节和文本块(Block)上继续写作、保存、查看版本历史或处理冲突。
  3. 在光标、选中文本或目标文本块附近触发续写、改写、描写、插入、头脑风暴、推进情节、换口吻、收紧、放慢或检查。

系统反馈

  • 用户自己保存的正文立即成为当前正式正文。
  • AI 返回候选卡,候选卡包含候选文本、知识草稿(Knowledge Draft)、风险标记(Risk Markers)和必要参考来源摘要。
  • 后台提取或校验失败不能回滚已保存正文。

候选生命周期

  • 确认:候选文本进入正文;与本次建议绑定、已完成校验、且来源快照(Source Snapshot)未失效的知识草稿可以一并确认。
  • 修改后合并:用户先改最终入正文的文本,再合并;正文落地后旧知识草稿立即失效,系统重新提取新的知识草稿,等待用户稍后确认。
  • 丢弃当前建议:本次建议和关联知识草稿退出当前待审视图;不改正文,不改知识库,用户可以后续再次触发生成。

冲突处理

  • 如果候选审核期间正文已变化,系统必须提示冲突,并保护用户当前输入。
  • 冲突解决只能围绕文本块(Block)和版本差异展开,不能用系统结果静默覆盖用户正文。

3.2 作品规划台(Planning Desk)

作品规划台用于支持高质量小说规划但不做成后台表单。每个规划入口都必须支持用户手写、AI 生成、AI 补全、AI 整理、AI 检查、AI 给多组选项、从正文提取,并能绑定后续生成上下文。

入口 用户要完成什么 AI 辅助方式
作品设定 明确题材、主题、读者承诺、基调、禁区和结局方向 生成故事前提、整理梗概、检查偏题、给多版方向
章节大纲 管理章节顺序、章节摘要、近期目标、主线、支线和伏笔 生成章节摘要、整理进度、提示断点、建议下一章目标
世界设定 管理角色、地点、物品、组织、规则、事件、时间线和因果链 从正文提取、补全属性、发现冲突、生成关系图
角色关系 管理角色档案、目标、动机、弱点、秘密、角色弧光和关系变化 生成角色弧线、检查章节推进、提示关系停滞
文风检查 管理作者声音、句式、节奏、叙事视角、张力节奏和质量诊断 分析样本、生成风格说明、检查风格偏移、给改写建议

边界

  • 近程叙事控制使用“情节节拍 / 章节叙事规划 / 章节目标”的用户语言,不引入独立一级模型。
  • 规划项进入后续生成前,必须有清楚来源和用户取舍。
  • 作品规划台不是知识管理后台;用户不需要维护底层字段、索引或系统配置。

3.3 知识与一致性

用户操作

  1. 查看当前作品的局域知识库(Local Knowledge Base),包括人物、关系、事件、规则、关键叙事状态和来源追溯。
  2. 查看待确认知识、风险标记和过期提示。
  3. 主动发起一致性检查(Consistency Check),查看问题列表并跳转到正文、规划项或作品知识。
  4. 在必要时手动修正正式作品知识。

系统反馈

  • 未确认知识草稿不能进入正式检索、图查询或下一次生成事实。
  • 来源快照(Source Snapshot)失效时,系统必须提示“这条待确认内容已经和当前来源不匹配,需要重新提取”。
  • 一致性检查只提示、定位和解释风险,不自动写正式事实。
  • 用户可见内容必须区分“当前作品知识”和“被授权的全局知识库(Global Knowledge Base)资料”。

失败与恢复

  • 知识确认失败时不能影响已保存正文。
  • 手动修正失败时必须保留用户输入,并说明失败位置和重试方式。

3.4 导入解析

用户操作

  1. 在某个作品内上传旧文稿或选择需要导入的正文文件。
  2. 查看导入状态、成功章节、失败原因和可恢复动作。
  3. 发起全书解析(Full Parse)。
  4. 在章节汇总页逐章查看解析结果。
  5. 对章节执行整章确认、整章驳回、稍后处理,或查看详情。
  6. 批量选择多个可处理章节,或点击“一键确认全部可确认章节”。

系统反馈

  • 全书解析结果先进入待确认状态,不直接写正式知识。
  • 汇总页展示章节级实体数、关系数、风险分布、失败原因和详情入口。
  • 详情页用于理解来源和风险,不是逐条提交正式事实的入口。
  • 批量选择和“一键确认全部可确认章节”只是用户操作效率优化;系统落库、校验、失败回滚仍按章节隔离。

硬边界

  • 章节确认边界固定为 parse_job_id + chapter_id
  • 同章节内必须 all-or-nothing。
  • 任一条来源失效、冲突、校验失败或导入失败,整章确认失败。
  • 不允许跨章节做不可解释的一次性全局写入。

3.5 导出交付

用户操作

  1. 选择导出正文、导出设定、导出作品知识或备份。
  2. 选择导出范围、格式和目标。
  3. 查看导出结果或失败原因。

系统反馈

  • 导出只读取已确认内容和用户有权导出的资料。
  • 导出失败只影响本次输出,不得破坏作品本身。
  • 失败原因、影响范围和重试入口必须可见。

3.6 记录与用量

用户操作

  1. 查看单作品生成记录、任务记录、失败原因、令牌(Token)使用和成本提示。
  2. 回看已确认、已丢弃、已过期或失败的候选历史。
  3. 根据失败原因返回写作台、作品规划台或导入解析继续处理。

系统反馈

  • 普通用户看到的是作品相关的使用记录和生成反馈,不是系统日志或管理员审计后台。
  • 历史记录不能和当前待确认内容混在一起。
  • 记录必须能解释发生了什么,但不暴露普通用户不需要操作的后台配置。

4. 决策清单(普通用户必须稳定可理解)

  1. 在我的作品(My Works)里打开哪个作品,或创建哪个新作品。
  2. 在作品工作台(Work Workspace)里进入写作台、作品规划台、知识与一致性、导入解析、导出交付,还是记录与用量。
  3. 是否触发 AI 辅助,以及使用续写、改写、描写、检查、补全、整理或生成方案。
  4. AI 候选是确认、修改后合并,还是丢弃当前建议。
  5. 知识草稿(Knowledge Draft)是确认还是忽略。
  6. 全书解析(Full Parse)结果是整章确认、整章驳回、稍后处理、批量选择,还是一键确认全部可确认章节。
  7. 一致性检查(Consistency Check)问题是立即修复,还是带着问题继续写。
  8. 导出正文、设定、知识或备份时选择什么范围和格式。

5. 关联阅读

  • 产品定位与产品闭环:产品-01-产品定位与核心价值.md
  • 交互边界:产品-02-核心功能与交互边界.md
  • 产品旅程与长期闭环:产品-03-用户旅程与操作流程.md
  • 系统处理链路:流程-02-系统处理流程(系统视角).md
  • Accept 收束专题:专题-01-正文建议接受(Accept Suggestion)实现规范.md