Update docs for gm-first play pipeline and harness chance.

Sweep glossary, progressive design, worker-spec/refine prompts, and play-dm-auditor streaming notes. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-25 01:02:23 +08:00
parent 123c44ec49
commit 872f742d3e
11 changed files with 33 additions and 27 deletions
@@ -58,8 +58,8 @@ boundary: |
 执行顺序：
 1. 复述站位、体验内核、禁忌；矛盾处 askUser 1 点。
 2. 写入 `play_slots`（世界模拟）或等价写手槽；**workers 只含白名单 ref**：
-   - world_sim 每轮：auditor / world-simulator / narrator / role-decide（仅 perspective 开时）
-   - world_sim 按需：chance（仅 chance 开时；`invocation: on_demand`）
+   - world_sim 每轮（顺序）：world-simulator（gm）→ role-decide（仅 perspective 开）→ narrator → auditor
+   - world_sim 机遇：`play_slots.chance` 开时 gm harness 获批量工具；可另声明 `chance` ref（`invocation: on_demand`）供显式调度
   - writing：outline / chapter-writer
   - 程序也会按 play_slots 展开；你仍应写出与槽一致的 workers[]（含 acceptance），便于人读验收。
 3. **禁止**自造 ref、禁止添加 variable-update / lore-keeper / 自造骰子 LLM 等。
@@ -25,7 +25,7 @@ boundary: |
  细化终稿：按本步勾选展开 workers、合并常驻与 tables。
  变量设计 / 变量控制上下文：真值与投影，不是推理槽。
  旁观维护（auditor）：副 LLM，表/规则检查，默认空操作；无长对话史。
-  机遇裁定（chance）：按需程序工具槽，不进每轮管线。
+  机遇裁定（chance）：`play_slots.chance` 开时主世界层 harness 获批量程序工具；非每轮独立上场。
  叙事指南与故事推进：挂到转述槽（推进可兼挂主世界层）；世界/机制：挂到主世界层——本步只点名槽。
 ```

@@ -55,7 +55,7 @@ boundary: |

 固定 ref 白名单：
 - 世界模拟每轮：`world-simulator`（gm）、`narrator`、`auditor`（回合末）、`role-decide`（perspective，默认关）
- 世界模拟按需：`chance`（机遇裁定，默认关；invocation=on_demand）
+- 世界模拟机遇：`play_slots.chance` 控制主世界层 harness 的批量 `chance` 工具（默认 false）；非每轮独立 LLM 槽
 - 扩写：`outline`、`chapter-writer`
 - 禁止：`variable-update`、自造 kebab、为世界观/性格再拆槽

@@ -63,7 +63,7 @@ boundary: |
 1. 读配方与体验契约，判断路径：世界模拟 vs 写手分段。
 2. 默认世界模拟：`auditor: true, gm: true, narrator: true, perspective: false, chance: false`；
   调度序 gm → perspective? → narrator → auditor；
-   仅信息隔离才开 perspective；需要骰子/抽签/比点等真随机时开 chance。
+   仅信息隔离才开 perspective；需要骰子/抽签/比点等真随机时设 `chance: true`（主世界层 harness 批量工具，不进每轮序）。
 3. 写手路径：`outline` + `chapter-writer` 默认都开；用户明确只要正文则可关 outline。
 4. 可写简短 `mount_notes`（哪类上游产物挂哪槽），不粘贴长文。
 5. 输出 JSON。summary：`游玩拓扑 · 旁观+gm+转述` 或 `游玩拓扑 · gm+转述+机遇` 等。
@@ -115,7 +115,7 @@ boundary: |
    "生成规则/变量合同/旁观摘要 → auditor（无长对话史）",
    "叙事指南与故事推进 → narrator（推进兼 gm）",
    "世界/机制/变量规则 → gm",
-    "真随机检定 → chance（按需）",
+    "真随机检定 → play_slots.chance=true（gm harness 批量工具，非每轮 chance worker）",
    "真值与 side_effects → 细化终稿 tables"
  ],
  "开放问题": []
@@ -125,7 +125,7 @@ boundary: |
 填写规则：
 - `path=world_sim` 时必须有 `play_slots`；`writing_slots` 可省略。
 - `path=writing` 时必须有 `writing_slots`；`play_slots` 可省略。
- `auditor` / `chance` 缺省：auditor 视为 true，chance 视为 false；chance 为 true 时不进每轮序，仅可按需调度。
+- `auditor` / `chance` 缺省：auditor 视为 true，chance 视为 false；`chance: true` 时为主世界层开启 harness 机遇工具（仍可声明按需 `chance` ref 供显式 run_worker，但游玩默认不走每轮 chance 演员）。
 - 不要输出自造 `actors[]` / 自由 `workers[]`。
 - 旧产物若含 `actors[]`：本步应改写为槽位勾选，不再追加自定义 ref。

@@ -144,7 +144,7 @@ boundary: |
 好：
 - play_slots: auditor+gm+narrator，perspective/chance false；mount_notes 一行。
 - 有凶手真名不能进 GM：perspective true，并说明只出反应建议。
- 需要检定/抽签：chance true（按需程序工具）。
+- 需要检定/抽签：`chance: true`（gm harness 批量工具）。

 坏：
 - actors 里发明 affinity-manager、lore-keeper、dice-master（LLM）。
@@ -26,10 +26,10 @@ Runtime 执行时读 Worker 集条目，不直接读本目录。
 | 槽 | 默认 ref | 模板 |
 |----|----------|------|
 | auditor | `auditor` | `auditor.yaml` — maintain.v1；默认空操作；无长对话史 |
-| gm | `world-simulator` | `world-simulator.yaml` — 裁决包 settlement.v1 |
+| gm | `world-simulator` | `world-simulator.yaml` — 裁决包 settlement.v1；`play_slots.chance` 开时 harness 批量机遇工具 |
 | narrator | `narrator` | `narrator.yaml` — 只读裁决包写正文 |
 | perspective | `role-decide` | `role-decide.yaml` — 可选知密视角 |
-| chance（按需） | `chance` | `chance.yaml` — 程序骰子/抽签/比点；不进每轮管线 |
+| chance（拓扑开关） | `chance` | `play_slots.chance` 控制 gm harness；可选声明按需 `chance` ref 供显式 run_worker |

 变量 / Progressive：**不是**独立 LLM 模板；见 `docs/progressive-data-design.md`（真值 + side_effects）。  
 Runtime：写入 `运行.本轮.裁决` 时自动合并 `variable_changes` → `变量.当前`；写入 `运行.本轮.旁观` 时按需合并 `table_ops`。
@@ -38,7 +38,7 @@ Runtime：写入 `运行.本轮.裁决` 时自动合并 `variable_changes` → `

 | 文件 | 说明 |
 |------|------|
-| `chance.yaml` | 机遇裁定（按需程序工具） |
+| `chance.yaml` | 机遇裁定（按需 run_worker 或 gm harness 共用程序实现） |
 | `round-present.yaml` | 结构化回合陈述（可选） |
 | `opening-generator.yaml` | 开局生成器（创作末尾） |
 | `outline.yaml` / `chapter-writer.yaml` | 扩写路径固定槽 |
@@ -2,8 +2,8 @@ id: chance
 label: 机遇裁定
 role: chance
 duty: >
-  按需程序工具：掷骰、点数比拼、抽签/加权抽取。不进每轮管线；由编排器
-  run_worker（workerContext.chance 或黑板 运行.机会请求）调用。禁止模型编造随机。
+  程序随机工具：掷骰、点数比拼、抽签/加权抽取。游玩期默认经主世界层 harness 批量调用
+  （play_slots.chance）；也可由编排器 run_worker 显式调度本 ref。禁止模型编造随机。
 when: 需要真随机或可复核比点时
 suggested_context:
  static: