Files

为可重复技能补充参数校验与展示，统一配方、编排器和执行单元术语。

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-07-30 17:59:20 +08:00

7.9 KiB

Raw Blame History

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

0. 定位

当前仓库的执行计划表。系统边界见 architecture.md；日常场景与 P0 工作包见 daily-use-p0.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/成本/分支调试台	未开始

现在 →  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 §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. 下一行动（立即）

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

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

7.9 KiB Raw Blame History Unescape Escape