275 lines
11 KiB
Markdown
275 lines
11 KiB
Markdown
# 日常使用场景 → 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 里点选死板「剧本菜单」；选定导演后，由导演（Agent）听用户说话谈出本局剧本（创作流程 / Worker 集）与调度 |
|
||
|
||
用户侧拍摄术语权威对照：**`ui-glossary.md` §0**（导演 / 剧本 / 演员 / 能力）。
|
||
|
||
### 0.2 导演 vs 剧本（动态）
|
||
|
||
```text
|
||
导演 = 用户 UI 选一次的方法起点（可调味）
|
||
= 内部 recipes / 原「能力包·配方」合一
|
||
= 例：世界模拟器、扩写助手
|
||
|
||
剧本 ≠ 再选一张固定流程卡
|
||
= 选定导演之后：用户说话 → 导演调度创作
|
||
→ 产出 设计.创作流程 + 设计.worker集（本局活剧本）
|
||
→ 游玩再按声明让【演员】上场
|
||
|
||
能力 = 共用工序（美学纲领与交互范式…）；导演从中编排
|
||
演员 = 实际上场的 Worker
|
||
```
|
||
|
||
| | 导演 | 剧本（动态） |
|
||
|--|------|----------------|
|
||
| 谁选 | **用户 UI**（显式，一层） | **导演 Agent + 用户对话**（隐式） |
|
||
| 变不变 | 选项相对稳定 | 每局流程、Worker 集、回合调度都可变 |
|
||
| 忌讳 | 再叠一层「配方」选择 | 固化成死 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 选好**导演 Skill**（初期可只有一个）后，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 | 单包 = 不能多种玩法 | **已澄清**：一个导演内剧本动态分化 |
|