重构世界模拟器为模块化配方架构,完善创作编排、会话运行时与 Web UI,并清理过时技能。
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
274
docs/daily-use-p0.md
Normal file
274
docs/daily-use-p0.md
Normal file
@@ -0,0 +1,274 @@
|
||||
# 日常使用场景 → 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 | 单包 = 不能多种玩法 | **已澄清**:一个导演内剧本动态分化 |
|
||||
Reference in New Issue
Block a user