# 日常使用场景 → P0 详细路径

## 0. 怎么用本文

1. **先定场景**：日常到底在干什么（§1）  
2. **再列功能**：每个场景要哪些能力、是否已有（§2）  
3. **收成 P0**：只把「日常阻断 / 高频刚需」推进 P0 详细路（§3）  
4. **其余进后续**：体验打磨与加固，不塞进 P0（§4）

系统边界见 `architecture.md`；总路线见 `px-roadmap.md`。

### 0.1 已确认取向（2026-07-26）

| # | 结论 |
|---|------|
| 1 | 日常包含 **两类**：AIRP/交互扮演 **与** 长文/爽文创作（同一运行内核） |
| 2 | **UI 不自研美学**：布局/控件直接抄参考产品即可；**存档与续作稳定是硬指标** |
| 3 | **配方**：新建时用 UI **选一个**（世界模拟器 / 扩写助手…；初期可只有 1 项） |
| 4 | **工作流计划动态**：不在 UI 里点选死板「流程菜单」；选定配方后，由编排器听用户说话谈出本局工作流计划（创作流程）与运行规格（Worker 集）并调度 |

用户侧术语权威对照：**`ui-glossary.md` §0**（配方 / 编排器 / 技能 / 工作流计划 / 运行规格 / 执行单元）。

### 0.2 配方 vs 工作流计划 / 运行规格（动态）

```text
配方        = 用户 UI 选一次的方法起点（可调味）
            = 内部 recipes/
            = 例：世界模拟器、扩写助手

工作流计划  ≠ 再选一张固定流程卡
            = 选定配方之后：用户说话 → 编排器调度创作
              → 产出 设计.创作流程（近期增量 DAG）

运行规格    = 谈成的 设计.worker集 等可进游玩声明
            → 游玩再按声明让【执行单元】上场

技能        = 共用工序（美学纲领与交互范式…）；编排器从中编排
执行单元    = 实际上场的 Worker
```

| | 配方 | 工作流计划 / 运行规格（动态） |
|--|------|----------------|
| 谁选 | **用户 UI**（显式，一层） | **编排器 + 用户对话**（隐式） |
| 变不变 | 选项相对稳定 | 每局流程、运行规格、回合调度都可变 |
| 忌讳 | 再叠一层选型 | 固化成死 DAG / 死选单 |
| 本仓库对应 | `recipes/` + 默认 skill 包 | `设计.创作流程` / `设计.worker集` |

因此：**只给配方一个选择 UI**；**不要**再给「工作流计划」做第二层死板选择器。

**多配方**才有意义的情况：方法边界真不同（世界模拟 vs 扩写助手），而不是同一配方内的题材分化——后者留在工作流计划层动态谈成。

---

## 1. 日常使用场景（产品视角）

### 1.1 主场景（P0 对准）— 两条产品线，同一内核

#### 线 A：AIRP / 交互扮演

| ID | 场景 | 用户在干什么 |
|----|------|--------------|
| **A1** | 开新档创作 | 描述想扮演/交互什么，谈到可玩的 Worker 集 |
| **A2** | 验收定稿 | 接受/重来/跳过询问，直到可进游玩 |
| **A3** | 进游玩 + 多回合 | 读终稿 → 输入 → 再生成；偶发重 roll |
| **A4** | 续作 + 存档读档 | 关掉再开接着玩；关键节点存/读档 |

#### 线 B：长文 / 爽文创作

| ID | 场景 | 用户在干什么 |
|----|------|--------------|
| **B1** | 开新档创作 | 描述题材/爽点/篇幅；站位偏「写手/统筹」或「助手分段」 |
| **B2** | 验收定稿 | 钉大纲/章结构/写手类 Worker 与固定上下文，可进「写」 |
| **B3** | 分段出文 | 按大纲或指令生成章/节正文；不满意重 roll 该段 |
| **B4** | 续作 + 存档读档 | 连载式接着写；章节点存档、读档不丢正文与进度 |

A4 / B4 **共用**同一套存档语义（`session.json` + `instance`/`run` 快照）；P0 把稳定性做硬。

### 1.2 次场景（P0 不精做）

| ID | 场景 | 说明 |
|----|------|------|
| S7 | 改表 / 状态面板 | 有就不炸；精致编辑 → 后 |
| S8 | 改规格再开写/玩 | 有 instance 加载即可，流程打磨 → 后 |
| S9 | 开局 swipe / 多版本对比 | 有更好，非 P0 闸门 |
| S10 | 预设商店式管理 | 失败可读即可 |

### 1.3 明确非 P0

| ID | 说明 |
|----|------|
| N2 | 狼人杀级信息隔离 |
| N3 | Context Trace 专业调试台 |
| N4 | 多配方**运营商店**（P0 只要选择 UI，可仅 1 项） |
| N5 | DefinitionVersion 完整发布迁移协议 |
| N6 | SillyTavern 卡批量导入导出 |
| N7 | 自研精美 UI / 按 `ui-design` 大改布局（**抄参考即可**） |

---

## 2. 场景 → 功能需求（含现状）

图例：✅ 基本有　🟡 有但糙/易踩坑　❌ 缺或不可靠

### 共用：创作 / 验收 / 进出

| 功能 | 现状 | P0? |
|------|------|-----|
| 新建作品 → 选配方（能力包；初期可仅一项） | ✅/🟡 | **必做**（有选择 UI；一项时默认选中即可） |
| 意图可走扮演 **或** 写手/爽文（工作流计划层动态，不另选死板流程卡） | 🟡 | **必做** |
| 验收出口无死胡同 | 🟡 | **必做** |
| 进入游玩/写作阶段门槛清晰 | 🟡 | **必做** |
| UI 自研打磨 | — | **不做**；缺块就抄参考产品交互 |

### 线 A：多回合扮演

| 功能 | 现状 | P0? |
|------|------|-----|
| 连续 ≥3 回合不卡死 | 🟡 | **必做** |
| 失败可重试 | 🟡 | **必做** |

### 线 B：长文 / 爽文

| 功能 | 现状 | P0? |
|------|------|-----|
| 创作能产出「大纲 + 写章」类 Worker 声明（模板或谈成） | 🟡 | **必做**（不新开第二包；缺则补 **templates / 引导**，不是多包） |
| play 期能按段生成正文并展示 | 🟡 | **必做**（≥2 段/章连续） |
| 章/段级重 roll 或读档回到段前 | 🟡 | **必做**（与存档同一套：load earlier → 重来） |
| 独立长文编辑器 / Monaco | ❌ | **不做**（抄现有主舞台展示正文即可） |

### 存档 / 续作（最高优先级）

| 功能 | 现状 | P0? |
|------|------|-----|
| `session.json` 续作相位正确 | 🟡 | **硬必做** |
| 手动存 / 列表 / 加载后可继续 | 🟡 | **硬必做**（线 A、线 B 各验一次） |
| 存档不丢终稿正文与关键 tag | 🟡 | **硬必做** |
| 分支树 UI | ❌ | 不做 |

---

## 3. P0 详细路径

**P0 一句话**：用户用 UI 选好**配方**（初期可只有一个）后，AIRP 与长文/爽文都在**工作流计划层动态**谈成并跑起来，且 **存档/续作稳定**；UI 抄参考即可。

### 3.1 黄金路径（两条都要绿）

**线 A（扮演）**

```text
A-GP1  新建 → UI 选配方（可仅一项）→ 描述扮演/交互意图
A-GP2  验收至可进游玩
A-GP3  ≥3 回合输入→终稿
A-GP4  存 run 档 → 刷新/重开续作成功
A-GP5  加载 earlier 档或新开一条线之一可用
```

**线 B（长文/爽文）**

```text
B-GP1  新建 → UI 选配方 → 描述爽文/长篇意图（写手或分段助手）
B-GP2  验收至可进写作（Worker 集含大纲/写章类能力，勿只能聊天扮演）
B-GP3  连续生成 ≥2 段（章）正文
B-GP4  存档含已生成正文 → 续作能接着写下一段
B-GP5  回到 earlier 档重 roll 某段 或 等价恢复可用
```

### 3.2 工作包

#### WP-S 存档稳定（最先 / 贯穿）

| # | 项 | 验收 |
|---|-----|------|
| S1 | 续作：打开 Book = 恢复可操作相位 + 输入区与等待态一致 | A-GP4 / B-GP4 |
| S2 | 手动存：人话 kind；写入后列表可见 | 同上 |
| S3 | 加载：黑板 + 消息 + 运行进度一致，可继续生成 | A-GP5 / B-GP5 |
| S4 | 回归：线 A、线 B 各完整存读一轮，不手改 `books/` | 双线绿 |
| S5 | 已知「存档丢正文 / 续作进死相位」类 bug 清零 | 无阻断 |

#### WP-D 配方选择（与存档并列早做）

| # | 项 | 验收 |
|---|-----|------|
| D0 | 新建作品可选配方（registry）；仅 1 项时默认选中并可确认 | 进入该包创作 |
| D1 | 人话展示配方名/简介，不暴露路径 | 可选懂 |

#### WP-A 进出与失败出口（文案够用即可）

| # | 项 | 验收 |
|---|-----|------|
| A1 | 裸 id 不进用户主路径（glossary 底线） | 无 `design-core` 裸露 |
| A2 | `waiting_user` 有主按钮出口 | 无死胡同 |
| A3 | 进游玩/写作门槛提示 | 误进可理解 |
| A4 | LLM/worker 失败：中文 + 重试 | 可回到可输入 |

#### WP-R 线 A 回合可靠

| # | 项 | 验收 |
|---|-----|------|
| R1 | ≥3 回合无卡死 | A-GP3 |
| R2 | 假死可刷新恢复且不腐档 | 与 WP-S 一致 |

#### WP-L 线 B 长文/爽文最小闭环

| # | 项 | 验收 |
|---|-----|------|
| L1 | 启动引导明确支持「写爽文/长篇/先大纲再写」 | B-GP1 |
| L2 | design 能稳定收到写手向 Worker 集（补 template 或 design 提示，**同一配方内动态谈成**） | B-GP2 |
| L3 | play 连续 ≥2 段正文 | B-GP3 |
| L4 | 正文在存档/续作中仍在 | B-GP4 |

#### WP-U UI（抄，不雕）

| # | 项 | 验收 |
|---|-----|------|
| U1 | 缺的存档列表/确认/重试控件：直接仿参考产品，不写设计长文 | 能点、能完成 GP |
| U2 | **禁止** P0 内按 `ui-design.md` 做大布局重构 | 范围不膨胀 |

#### WP-E 闸门

| # | 项 | 验收 |
|---|-----|------|
| E1 | 线 A、线 B 黄金路径各冷启动 + 续作通过 | 全绿 |
| E2 | 更新 `px-roadmap` / `architecture` 进度勾选 | 文档同步 |

### 3.3 P0 明确不做

- 第二套死板「流程选单」/ 固定题材 DAG  
- 自研精美 UI、工作台大改  
- 隔离模拟、Trace 台、完整副作用调度、版本迁移协议  
- 为文采大改全套提示词（仅修**阻断线 B 收不成写手规格**的引导/模板）  

### 3.4 建议顺序

```text
1. WP-S 存档稳定（先修已知腐档）
2. WP-D 配方选择 UI（可仅一项）
3. WP-A 失败出口 / 进出
4. WP-R 线 A 回合
5. WP-L 线 B 长文最小闭环（引导 + template + 存档验正文）
6. WP-U 仅补抄来的缺口控件（含选配方/存档若未齐）
7. WP-E 双线验收闸门 → P0 完成
```

### 3.5 P0 DoD

- [ ] 线 A：A-GP1–5 通过（含选配方、续作/读档）  
- [ ] 线 B：B-GP1–5 通过（含选配方、正文不丢）  
- [ ] 配方选择 UI 可用（可仅一项）  
- [ ] 无等待死胡同；失败可重试  
- [ ] 不依赖手改磁盘文件  
- [ ] UI 无大改承诺；存档稳定优先于观感  

---

## 4. 日常功能 → 阶段归属（修订）

| 日常能力 | 阶段 |
|----------|------|
| 配方选择 UI（可仅一项）、工作流计划层动态谈规格、AIRP+长文主路径、**存档续作硬稳定** | **P0** |
| 抄来的 UI 缺口补齐 | **P0（U）** / 不够再后补 |
| 表编辑精修、改规格心流、副作用完整 | **PX1/PX2** |
| Trace、预算、版本协议、E2E | **PX3** |
| 长文「专业编辑器 / 评测 / 多卷」加深 | **原 PX4 收窄**（P0 已含最小长文） |
| 隔离 + 专业调试 | **PX5** |
| 多个配方包（方法真不同时再加） | **需要时再加**；非「流程菜单」 |

---

## 5. 假设状态

| # | 原假设 | 状态 |
|---|--------|------|
| 1 | 仅 AIRP | **已订正**：+ 长文/爽文 |
| 2 | UI 要按设计稿打磨 | **已订正**：抄参考；存档稳定优先 |
| 3 | 永远自动加载、无选包 UI | **已订正**：UI 选**配方**；工作流计划层保持动态 |
| 4 | 单包 = 不能多种玩法 | **已澄清**：一个配方内工作流计划动态分化 |