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>

docs/briefs/prompt-revision-inventory.md

@@ -17,7 +17,7 @@
 | `modules/context-order/prompt.md` | **骨架已写**（`context-order.v1`） |
 | `docs/context-fragment-design.md` | **已写**；范例技能已对齐 `context-fragment.v1` |
 | 程序：片段解析 / 扁平投影序 / `对话.历史` 可投影 | **已落地**（非硬双锚） |
-| `orchestrator.md` | **已改**：play 调度 auditor → perspective? → gm → narrator |
+| `orchestrator.md` | **已改**：play 调度 gm → perspective? → narrator → auditor |
 
 ## 优先级 P1（能力归属 feeds）
 
@@ -56,7 +56,7 @@
 ```json
 // 设计.worker集（世界模拟）
 {
-  "play_slots": { "auditor": true, "gm": true, "narrator": true, "perspective": false },
+  "play_slots": { "auditor": true, "gm": true, "narrator": true, "perspective": false, "chance": false },
   "tables": { "side_effects": [/* 来自变量设计 */] },
   "workers": [/* 可空，由程序按槽展开；或覆盖 context/outputs */]
 }

docs/design-orchestrator-guide.md

@@ -198,7 +198,7 @@
 | 记忆 / 长线 / 大纲 / 随机分支 / 人设阶段 | **统一用表**（§5）：维护 + 显隐 + 副作用插换上下文 |
 | 信息差玩法 | 分角 worker；极贵，慎用 |
 | 格式 | 程序拼 |
-| 真随机 / 骰子卡组计算 | 固定按需槽 `chance`（程序工具：roll/compare/draw/pick）→ `运行.本轮.机遇`；`play_slots.chance` 开启后由编排器 run_worker；禁止临时造 LLM「骰子演员」 |
+| 真随机 / 骰子卡组计算 | 主世界层 harness 批量 `chance` 工具（`requests[]`）；`play_slots.chance` 开关；禁止临时造 LLM「骰子演员」；可选保留按需 `chance` worker 供显式 run_worker |
 | 用户不应知道的信息 | 程序固定注入，不进可见区；非 input 整理 worker |
 | 输入协议 | 常驻上下文（`()` 元要求、`""` 对白、无包裹=事实等） |
 

docs/play-dm-auditor.md

@@ -63,7 +63,13 @@ DM 出裁决包（含变量变更）→ 旁观只动表/触发生成 → 程序
 - 旁观要不要能说「该按某条规则补东西」？→ **要**，就得看见规则目录/格式。  
 - 旁观要不要会写角色描写？→ **不要**，所以描写长文不必进旁观上下文。
 
-## 5. 一句话
+## 5. 上下文与思考流（UI 对接）
+
+主世界层游玩期走 **gm harness**（tool loop）：与普通 worker 相同，经 `onThinkingDelta` / `onOutputDelta` 把推理与正文增量推到前端；机遇工具往返也在同一气泡时间线内展示，不另开隐藏通道。
+
+转述、旁观仍各是一次 worker 调用，各自独立流式输出；**不要**把旁观维护当成 gm 的 tool。
+
+## 6. 一句话
 
 **主世界层断事；转述说话；旁观在回合末对表，改表给下一轮。**  
 交互上优先「一次裁决 + 延后轻维护」，不优先「来回多轮 LLM 传话」。

docs/play-presentation-shells.md

@@ -1,7 +1,7 @@
 # 游玩呈现壳 · 可微调前端模板
 
 > **阶段**：P1 = 定类与契约；**P2** = 程序/样式适配与灌数。  
-> 上游：游玩管线 `auditor → gm → narrator`。  
+> 上游：游玩管线 `gm → perspective? → narrator → auditor`。  
 > 创作挂钩：`设计.正文组成` / `设计.监控栏`；终稿 tag 通常 `输出.用户展示`。  
 > **创作定位：基于固定壳做适配微调，不是从零设计前端。**  
 > 预览：`/shells.html`

docs/progressive-data-design.md

@@ -70,7 +70,7 @@ Progressive 投影              本轮主世界层只看见「当前档」；未
 3. 程序：在边沿或回合结算时抽一条 → 写入 `运行.事件流` 或投影 tag；主世界层只演绎已抽中的条目。  
 4. once / fired：同一事件 id 不重复（除非规则允许）。
 
-（真随机：启用 `play_slots.chance`，由按需执行单元 `chance` 程序掷骰/抽签/比点，结果在 `运行.本轮.机遇`；主世界层只演绎已出的结果。事件池权重抽签也可走 chance.pick。）
+（真随机：主世界层 harness 内调用批量 `chance` 工具（`requests[]` 一次交齐）；由 `play_slots.chance` 开关（默认 false 关闭；规格未写 `play_slots` 时 harness 默认开启）。结果可落 `运行.本轮.机遇`；主世界层只演绎已出的结果。旁观 `need_generate` 走程序抽样 → `运行.本轮.旁观.生成抽样`。事件池权重抽签也可走 chance.pick。）
 
 ## 4. 哪些需要变量（判定）
 
@@ -94,10 +94,10 @@ Progressive 投影              本轮主世界层只看见「当前档」；未
 
 ```text
 用户输入
-  → 主世界层（世界推演）：读变量 + 已投影 data，交事件/改真值（按规则）
+  → 主世界层（世界推演）：读变量 + 已投影 data，交事件/改真值（按规则）；可经 harness 批量调 chance 工具
-  →（可选）叙事转述：把裁决写成用户可见正文
-  → 旁观维护（副 LLM）：合同+表+本轮裁决；默认空操作（maintain.v1）
   →（可选）角色视角：强信息隔离时出反应建议（默认关，插在主世界层之后）
+  →（可选）叙事转述：把裁决写成用户可见正文
+  → 旁观维护（副 LLM）：合同+表+本轮裁决；默认空操作（maintain.v1）；改表供下一轮主世界层读取
 ```
 
 | 内容 | 给谁 | 不要做成 |
@@ -111,7 +111,7 @@ Progressive 投影              本轮主世界层只看见「当前档」；未
 
 用户可见名：`ui-glossary.md`（主世界层、旁观维护、叙事转述…）。作者文档可称 **主世界层 / 旁观维护**，与酒馆「主 GM + auditor」同构；**不要**对用户改称整套系统为「GM 框架」而废弃「执行单元」。
 
-**维护路径（不是 chance toolcall）**：主世界层输出 settlement.v1 → Runtime 合并 `variable_changes` 进 `变量.当前` → `side_effects` 换投影；旁观维护输出 maintain.v1 → Runtime 按需合并 `table_ops`；chance 只负责骰子/抽签。
+**维护路径（不是 gm 的 chance toolcall）**：主世界层输出 settlement.v1 → Runtime 合并 `variable_changes` 进 `变量.当前` → `side_effects` 换投影；旁观维护输出 maintain.v1 → Runtime 按需合并 `table_ops` / `need_generate` 程序抽样。gm harness 的 `chance` 只负责本回合裁决前的骰子/抽签。
 
 ## 6. 世界模拟器技能落点
 

docs/ui-glossary.md

@@ -125,7 +125,7 @@
 | `role-decide` | **角色决策** |
 | `world-simulator` | **主世界层**（旧称：世界推演） |
 | `auditor` | **旁观维护**（表/规则检查；默认空操作） |
-| `chance` | **机遇裁定**（按需：骰子/抽签/比点；程序工具） |
+| `chance` | **机遇裁定**（主世界层 harness 批量工具；非每轮独立 LLM） |
 | `round-present` | **回合呈现** |
 
 配方选项展示名示例：`world-simulator`（recipe）→ **世界模拟器**；`expand-assistant` → **扩写助手**。
@@ -143,10 +143,10 @@
 | **旁观维护** | `auditor` | 副 LLM：表/规则检查与按需补充；默认每轮上场、多数轮空操作；不写真相 |
 | **主世界层** | `world-simulator` | 读变量与 Progressive 投影、按规则改真值/交事件；多数世界观与查表归这里 |
 | **叙事转述** | `narrator` | 把裁决写成用户可见正文（若规格拆了呈现） |
-| **机遇裁定** | `chance` | 按需程序工具（掷骰/比点/抽签）；不进每轮管线；结果 tag `运行.本轮.机遇` |
+| **机遇裁定** | `chance` | 主世界层 harness 内批量程序工具（掷骰/比点/抽签）；`play_slots.chance` 为 false 时关闭；结果可写入 `运行.本轮.机遇`；非每轮独立上场 |
 | **角色视角** | `role-decide` | 仅强信息隔离；只出反应建议 |
 
-推荐调度：`auditor → perspective? → gm → narrator`。
+推荐调度：`gm → perspective? → narrator → auditor`。
 
 默认少拆：百科、分档性格、章大纲投影 → 主世界层 + 表副作用，**不要**再拆「世界观执行单元」「性格执行单元」。详见 `docs/progressive-data-design.md` §5。
 

docs/world-simulator-modules.md

@@ -178,7 +178,7 @@ recipes/world-simulator|expand-assistant/recipe.yaml
 
 | 编排器 | 状态 |
 |------|------|
-| 世界模拟器 | 创作链路已写；**play**：`auditor → perspective? → gm → narrator`；settlement/maintain 合并变量已接 |
+| 世界模拟器 | 创作链路已写；**play**：`gm → perspective? → narrator → auditor`；gm harness 批量 chance；settlement/maintain 合并变量已接 |
 | 扩写助手 | 方法论已写；起点：美学纲领与交互范式；勿默认套世界模拟全套 |
 
 ---

skills/dialogue/world-simulator/modules/refine/prompt.md

@@ -58,8 +58,8 @@ boundary: |
 执行顺序：
 1. 复述站位、体验内核、禁忌；矛盾处 askUser 1 点。
 2. 写入 `play_slots`（世界模拟）或等价写手槽；**workers 只含白名单 ref**：
-   - world_sim 每轮：auditor / world-simulator / narrator / role-decide（仅 perspective 开时）
+   - world_sim 每轮（顺序）：world-simulator（gm）→ role-decide（仅 perspective 开）→ narrator → auditor
-   - world_sim 按需：chance（仅 chance 开时；`invocation: on_demand`）
+   - 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 等。

skills/dialogue/world-simulator/modules/worker-spec/prompt.md

@@ -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）。

skills/dialogue/world-simulator/worker-templates/README.md

@@ -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` | 扩写路径固定槽 |

skills/dialogue/world-simulator/worker-templates/chance.yaml

@@ -2,8 +2,8 @@ id: chance
 label: 机遇裁定
 role: chance
 duty: >
-  按需程序工具：掷骰、点数比拼、抽签/加权抽取。不进每轮管线；由编排器
+  程序随机工具：掷骰、点数比拼、抽签/加权抽取。游玩期默认经主世界层 harness 批量调用
-  run_worker（workerContext.chance 或黑板 运行.机会请求）调用。禁止模型编造随机。
+  （play_slots.chance）；也可由编排器 run_worker 显式调度本 ref。禁止模型编造随机。
 when: 需要真随机或可复核比点时
 suggested_context:
   static: