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

235 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 流程-01产品操作流程用户视角
- 版本v5
- 更新日期2026-05-10
- 目标读者:产品 / 前端 / 测试
- 阅读时间20-30 分钟
- 边界说明:这里只写普通用户(User)如何完成作品创作任务;不承载管理员后台配置流程,不重复接口和底层状态机。本文件定义目标产品形态,不代表当前代码都已实现。关键术语沿用 `产品-02` 的“中文(English)”口径。
## 1. 流程总览
### 1.1 普通用户主流程
普通用户登录后的第一屏必须是我的作品(My Works),再从我的作品进入单个作品的作品工作台(Work Workspace)。
```mermaid
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`