# PX 路线图（产品体验与交付）

## 0. 定位

当前仓库的**执行计划表**。系统边界见 [`architecture.md`](./architecture.md)；日常场景与 P0 工作包见 [`daily-use-p0.md`](./daily-use-p0.md)；文件级索引见 [`implementation-guide.md`](./implementation-guide.md)。

**不**绿场重写、**不**近端迁 Mastra/Next/SQLite。挂在现有相位机 + Book/快照 + 声明驱动 Worker 上增量交付。

### 0.1 已锁定产品取向

| 项 | 决定 |
|----|------|
| 日常玩法 | **AIRP/交互** + **长文/爽文**（同一内核） |
| 编排器 Skill | 新建时 **UI 选择**技能包；初期可只有 1 项（默认选中） |
| 工作流计划层 | **动态**：听用户说话谈 Worker 集 + tool loop；不做死板流程选单/DAG |
| UI | **抄参考**即可，不自研美学 |
| 硬指标 | **存档 / 续作稳定** |
| 多配方 | 仅当方法边界真不同时再加包；爽文≠新配方 |

### 0.2 成功标尺

| 级别 | 含义 |
|------|------|
| **L1 可演示** | 带路能跑通一轮 |
| **L2 可自助** | 选配方 → 创作 → 玩/写，少踩坑 |
| **L3 可日常** | 双线存档续作可靠；少死循环 |
| **L4 可扩展** | 新配方包或隔离模式不改内核边界 |

---

## 1. 总计划表（主表）

| 阶段 | 名称 | 目标标尺 | 核心交付 | 状态 |
|------|------|----------|----------|------|
| **PX0** | 双线可日常最小集 | L2→摸 L3 | 配方选择 UI；线 A 扮演 + 线 B 长文/爽文主路径；**存档硬稳定**；失败出口；UI 只抄缺口 | **进行中（核心已落地）** |
| **PX1** | 创作体验 | L3 design | 规格可读可改、进度可见、表/黑板可手改、instance 改规格 | **进行中（定稿存读+黑板改+进度面板已有）** |
| **PX2** | 游玩/写作体验 | L3 play | 阅读主舞台（抄）、状态抽屉、重 roll 顺手、副作用调度、多 run 线打磨 | 未开始 |
| **PX3** | 运行可信 | L3 加固 | Context Trace、调度预算、规格钉版本、mock E2E | 未开始 |
| **PX4** | 长文加深 | L4 | 章产物/多卷、局部评测、更好的长文阅读面（P0 已含最小长文） | 未开始 |
| **PX5** | 隔离 + 调试 | L4 | 私有上下文、泄漏测试；Trace/成本/分支调试台 | 未开始 |

```text
现在 →  PX0（存档+双线+编排器UI）
      →  PX1（创作好改）
      →  PX2（玩/写好用）
      →  PX3（可信可测）
      →  PX4 / PX5（按需，可调序）
```

顺序原则：先 **PX0 双线硬路径**，再体验（1–2），再加固（3），再扩展（4–5）。  
若 PX0–2 出现腐档/死循环，允许提前插入 PX3 对应子项。

预估（单人全职约）：PX0 1.5–2 周；PX1/PX2 各 2–3 周；PX3 2–3 周；PX4/PX5 各 3–5 周。

---

## 2. PX0 — 双线可日常最小集（当前）

**权威细项**：[`daily-use-p0.md`](./daily-use-p0.md) §3。

### 2.1 计划表（工作包）

| 序 | 工作包 | 内容 | 验收要点 |
|----|--------|------|----------|
| 1 | **WP-S** 存档稳定 | 续作相位正确；手动存/列表/加载；正文与关键 tag 不丢 | 线 A、B 各存读一轮，不手改磁盘 |
| 2 | **WP-D** 配方选择 | 新建作品 UI 选配方；registry 列表；仅 1 项时默认选中 | 能选中并进入该包创作 |
| 3 | **WP-A** 进出与失败 | glossary 底线；`waiting_user` 有主按钮；LLM/worker 失败可重试 | 无死胡同、无裸 id 挡路 |
| 4 | **WP-R** 线 A | 扮演 ≥3 回合不卡 | A-GP1–5 |
| 5 | **WP-L** 线 B | 引导+template 能谈成写手规格；≥2 段正文；续作不丢文 | B-GP1–5 |
| 6 | **WP-U** UI 抄补 | 仅补存档/确认/选配方等缺口控件 | 不按 ui-design 大重构 |
| 7 | **WP-E** 闸门 | 双线冷启动+续作验收；勾选 DoD | 全绿才出 PX0 |

### 2.2 黄金路径（摘要）

- **线 A**：选配方 → 扮演意图 → 验收 → ≥3 回合 → 存档 → 续作/读档  
- **线 B**：选配方 → 爽文/长篇意图 → 验收写手规格 → ≥2 段正文 → 存档含正文 → 续作/读档  

### 2.3 非范围

死板流程选单；自研精美 UI；Trace；隔离；完整副作用；多配方商店（列表可扩展，P0 不追求多包运营）。

### 2.4 DoD

- [ ] WP-S～E 完成  
- [ ] 线 A、线 B 黄金路径各冷启动 + 续作通过  
- [ ] 配方选择 UI 可用（可仅一项）  
- [ ] 更新本文状态列 + `architecture.md` §13  

### 2.5 挂载

`web/`（新建选配方、saves）、`session-manager`、`skill-catalog` / registry、`phase-runtime`、引导与 `worker-templates`

---

## 3. PX1 — 创作体验

| 项 | 内容 | DoD |
|----|------|-----|
| 规格工作台 | 产物为主舞台（可抄 Notion/PR 式验收） | 不看文档能验完 Worker 集进 play |
| 进度 | 创作单位已验收/进行中可见 | — |
| 表 | 字段可编辑 + rev 不覆盖手改 | 手改后 worker 写入可解释 |
| 规格回退 | load instance 再改 | 至少一条路径可用 |

挂载：`worker-set-view`、`creation-units`、questions UI、表编辑 API。

---

## 4. PX2 — 游玩 / 写作体验

| 项 | 内容 | DoD |
|----|------|-----|
| 阅读面 | 终稿/章文主视线（抄 ST/阅读器） | ≥10 回合或等价连续写段不卡 |
| 重 roll | 发现入口；与快照语义一致 | 存/读/重 roll 各至少一次 |
| 状态 | 抽屉看表/变量 | — |
| 副作用 | `side_effects` 边沿完整可观测 | fixture：once / changed |
| 多线 | 同开局新开 play 线 | 不串 run 状态 |

挂载：`table-side-effects`、`phase-runtime`、play UI、`run-snapshot`。

---

## 5. PX3 — 运行可信

| 子项 | DoD |
|------|-----|
| Context Trace | 失败调用能看出装载了什么 |
| 调度预算 | 重复/嵌套/Token 触顶可读停止 |
| 规格钉版本 | 改规格不污染未迁移旧 run |
| mock E2E | 双线+存档脚本可进 CI |

---

## 6. PX4 — 长文加深（P0 之后）

P0 已要求最小长文/爽文闭环。本阶段加深：

- 章/卷 Artifact 更清晰；多段目录  
- 简单质量检查（程序优先）  
- 更好的长文阅读/对照面（仍可抄，可不上 Monaco）  

**不做**：固定小说 DAG；为长文另起调度内核。

---

## 7. PX5 — 隔离模拟 + 专业调试

| 块 | 内容 |
|----|------|
| 隔离 | 私有上下文、公私事件、泄漏测试（依 Trace） |
| 调试 | 调度时间线、Trace 检查器、Token/成本、分支树 |

若隔离需要**不同方法边界**，以**新配方包**形式加入（UI 多一项），仍保持包内工作流计划动态。

---

## 8. 明确不做（周期内）

- Mastra / LangGraph 换相位机；Next 重写前端  
- 完整事件溯源 + SQLite 近端必达  
- 题材固定 instantiate 管道；死板流程选单  
- 把创作方法长文塞回系统架构文  

---

## 9. 里程碑

| 里程碑 | 退出 | 产出 |
|--------|------|------|
| **M0** | PX0 DoD | 双线验收记录；编排器 UI；存档稳定 |
| **M1** | PX1+PX2 DoD | 内部「可日常」说明 |
| **M2** | PX3 DoD | Trace/预算/E2E 绿灯 |
| **M3** | PX4 或 PX5 | 长文加深或隔离/调试演示 |

---

## 10. 文档 / 代码映射

| 阶段 | 文档 | 代码 |
|------|------|------|
| PX0 | `daily-use-p0.md`、`ui-glossary.md` | `web/`、session、saves、catalog、templates |
| PX1 | `ui-design.md`（可抄着落地）、design-guide | worker-set、creation-units |
| PX2 | `run-snapshot.md`、tag-blackboard | side-effects、phase-runtime |
| PX3 | `context-assembly.md`、architecture | assemble、budgets、tests |
| PX4 | Skill 薄层 | artifacts、长文面 |
| PX5 | 隔离短文（待写） | Trace 强制、debug、stats |

---

## 11. 下一行动（立即）

1. **手工跑双线黄金路径**（线 A ≥3 回合；线 B ≥2 段；存读档）验收 PX0 DoD  
2. 表字段格级编辑器（当前是黑板 tag 预览级手改）可继续打磨  
3. 再开 PX2（阅读面 / 副作用 / 多 run）  

**当前**：PX0/PX1 主代码已落地，待你本地用真实 LLM 走一遍确认「能用」。