writing-agent/docs/ui-glossary.md

用户可见文案与术语对照（UI Glossary）

用途：凡出现在 Web 界面、导出 Markdown、状态 pill、气泡标题、询问卡、检查器上的文案，禁止直接暴露内部英文 id（如 design-core、design、play）。内部协议、SKILL 路径、黑板 tag、API 字段仍用英文 id。

实现：src/server/display-labels.ts（权威映射）；web/display-labels.js 须与本文及该文件保持一致。新增高频 id 时：先改本文 → 再改代码。

产品口径：用户侧与作者文档统一用业界编排用语的中文译名——配方 / 编排器 / 技能 / 工作流计划 / 运行规格 / 执行单元。旧拍摄词「导演 / 剧本 / 演员 / 能力」与「总管 / 能力包」仅作历史别称，勿再写进新文案。

文档写法：中文为主；英文业界叫法仅在术语表首次定义时括注，正文尽量不再夹英文。

---

0. 核心术语（首选）

中文（首选）	业界叫法	用户可见含义	内部对应	旧称（勿再用）
配方	Recipe	新建时手动选一次的方法起点（如世界模拟器、扩写助手）；给出建议的近期步骤，可按现场调味	recipes/ → 黑板 创作.选用配方	导演（选型）、能力包、第二层「配方」选型
编排器	Orchestrator / Supervisor	会话里负责调度的 Agent：决定下一步调谁、是否追问或结束	Main Agent / orchestrator.md	导演（调度）、总管
技能	Skill / Capability module	共用工序模块（美学纲领与交互范式…）；编排器从池里选型编排	modules/	能力、组件池（作者文档可写模块）
工作流计划	Workflow Plan / Horizon DAG	本局谈成的近期增量有向无环图（步骤 = 技能实例）；可追加、拆分、复用、修订	设计.创作流程	剧本（流程部分）、死板流程卡
运行规格	Runtime Spec / Definition	可复用的执行声明：执行单元、表、常驻上下文、权限与验收点	设计.worker集 等	剧本（规格部分）、Worker 集（对用户）
执行单元	Worker	上场执行的一次单元（一次 run_worker）	Worker / design-* / play workers	演员

关系口诀：

用户选【配方】（世界模拟器 / 扩写助手 …）
        │
        ▼
【编排器】调度 → 从【技能】里编排 → 谈成【工作流计划】→ 收成【运行规格】
        │
        ▼
【执行单元】按规格上场 → 游玩 / 成稿（运行实例）

一层选型：新建作品只选配方，不要再叠「能力包 + 配方」两层。

调味：配方给出的建议步骤是近期起点（horizon）；编排时可增量追加、可反复调用标了可反复的技能。验收的是本局【工作流计划】与【运行规格】，不是磁盘上的静态菜谱。

剧本拆分：旧称「剧本」同时罩住流程与规格，易混。现固定拆成：

• 工作流计划 = 怎么排技能步骤（DAG）
• 运行规格 = 游玩期按什么声明执行

---

1. 原则

1. 内外分离：id 给机器；中文给用户。
2. 本节词优先：对用户与作者文档优先用 §0；技术实现注释可写「编排器（Main Agent）」「配方（recipe）」对照。
3. 阶段用产品词：lifecycle 的 design / play 用户侧统一为 创作 / 游玩（勿译成「设计模式 / 播放」）。
4. 与 SKILL name 对齐：磁盘 worker 若已有中文 name，展示优先用 name；本表是缺省与高频兜底。
5. 气泡标题形态：{中文名} 或 {中文名} · {动作}，例如「创作 · 流程编排 · 产出」，不要「Worker · design-flow 产出」。

---

2. 生命周期 / 阶段

内部 id / 词	用户可见	说明
design	创作	谈工作流计划与运行规格的工作台。不用「设计」作顶栏主词。
play	游玩	执行单元按运行规格上场。不用「播放」。
done	已完成	—
idle	待命	—
running	执行中	—
waiting_user	等待你	—

相关业界概念（对用户可简化）：

中文	业界叫法	含义
人工审批 / 验收	Human-in-the-loop（HITL）Approval	用户对步骤或产物有最终决定权；评价标准只辅助建议
运行实例	Runtime Instance / Run	钉住某次规格截面的一局游玩过程
作品	Project / Book	长期项目容器（过程、资产、存档）；不等于「可玩成品」口语

---

3. 角色与系统概念（对照表）

内部词	用户可见（首选）	过渡别称	说明
Agent / Main Agent / orchestrator	编排器	导演、总管（旧）	调度执行单元、推进工作流计划；气泡可用「编排器 · 思考」。
Worker	执行单元	演员（旧）	UI 标题用中文名；检查器可写执行单元。
Tool	工具	Tool	编排器 tool call；气泡可用「工具 · 读黑板」。
recipe（用户选型）	配方（选项名）	导演、能力包（旧）	新建下拉只出现配方选项（世界模拟器、扩写助手…）。
Module / modules pool	技能	能力、组件池（旧）	见 world-simulator-modules.md。
设计.创作流程	工作流计划	剧本（旧，流程部分）	增量 DAG；非死选单。
设计.worker集	运行规格	剧本（旧，规格部分）	可进游玩的声明截面。
Blackboard	黑板	上下文板	—
Artifact	产物	—	待验收输出。
Accept / Review	验收 / 接受	人工审批	按钮用「接受」；阶段说明用「验收」。
Intake	需求描述	启动填空	—
Burst	本轮调度	—	少对用户说 burst。
Questions card	询问卡	Questions	详见 ui-design.md §8。

---

4. 创作期磁盘 Worker（高频）

内部 id	用户可见	备注
design-flow	创作 · 流程编排	以已选【配方】为起点，编排/增量修订工作流计划（可变 DAG）
design-step	创作 · 执行步骤	按工作流计划执行当前【技能】
opening-generator	开局 · 开场白	创作末尾可选
worker-spec（技能）	游玩拓扑	勾选固定槽；旧称「Worker 规格」，勿再当自由发明演员
design-core 等	（已废弃）	旧分步 skill；勿再调度

标题动作后缀（拼在中文名后）：

动作	后缀
运行中	（可省略或「执行中」）
产出 / 已完成	· 产出
提问	· 提问
占位	· 占位

---

5. 游玩期常用执行单元（缺省）

声明里可覆盖；无中文名时用下表：

内部 id	用户可见
narrator	叙事转述
role-decide	角色决策
world-simulator	主世界层（旧称：世界推演）
chance	机遇裁定（按需：骰子/抽签/比点；程序工具）
round-present	回合呈现

配方选项展示名示例：world-simulator（recipe）→ 世界模拟器；expand-assistant → 扩写助手。

创造执行单元时：规格里另写 name（中文展示名）。ref 仍用英文 kebab；UI 优先 name。

5.1 游玩拓扑称呼（作者文档）

内部调度单位仍叫 执行单元（Worker）——一次上场调用，这个词准确，不要废除。

作者讨论职责时可用与酒馆主 GM 同构的说法（对用户 UI 仍用上表）：

作者可用	典型 ref	含义
主世界层	world-simulator	读变量与 Progressive 投影、按规则改真值/交事件；多数世界观与查表归这里
叙事转述	narrator	把裁决写成用户可见正文（若规格拆了呈现）
机遇裁定	chance	按需程序工具（掷骰/比点/抽签）；不进每轮管线；结果 tag 运行.本轮.机遇
旁观 / 审计	可选自建	只出意见，不写 canon；不为「更聪明」而拆

默认少拆：百科、分档性格、章大纲投影 → 主世界层 + 表副作用，不要再拆「世界观执行单元」「性格执行单元」。详见 docs/progressive-data-design.md §5。

---

6. 创作单位 id（检查器 / 进度）

内部 id 形态	用户可见规则	示例
phase:core	单位 · 核心	—
phase:refine	单位 · 细化	—
worker:{ref}	执行单元 · {中文名或 ref}	worker:narrator → 执行单元 · 叙事转述
fixed:{topic}	技能 · {话题中文}	fixed:aesthetics-interaction → 技能 · 美学纲领与交互范式
resident:{id}	常驻 · {id 或名}	—

技能话题建议译名：

topic	用户可见
aesthetics-interaction	美学纲领与交互范式
interaction	交互范式（旧；已并入上一行）
narrative_guide	叙事指南与故事推进
input_protocol	输入协议
core_premise	核心前提
aesthetics	美学纲领（旧；已并入美学纲领与交互范式）

---

7. 等待态 / 焦点（对用户）

waitingReason.kind	状态摘要（短）	焦点动作
intake	描述需求	描述创作需求
input	补充说明	补充说明 / 回答追问
worker_questions	回答提问	回答 · {中文执行单元名}
approve_step	确认执行	建议调用 {中文名}
review_artifact	验收产物	验收产物

---

8. 禁止出现在用户主路径上的写法

• Worker · design-core、run_worker(design-core)
• 顶栏 / pill 写 design / play 英文
• 「总管会调度 design-core」「导演会先谈剧本」（应写「编排器会先谈工作流计划」或「将开始：创作 · 流程编排」）
• 新建作品同时出现「导演 + 配方」或「能力包 + 配方」两层选择
• 询问卡标题直接写 design-core
• 新文案继续使用拍摄词「导演 / 剧本 / 演员 / 能力」作首选

技术日志、导出里的「调试附录」、开发者文档不受本条限制，但默认导出给用户的 Markdown 应走同一套映射。

---

9. 相关文档

文档	关系
ui-design.md	布局与心流；文案须服从本文
architecture.md	内部术语；用户侧以本文为准
daily-use-p0.md	配方 / 工作流计划产品定义
world-simulator-modules.md	【技能】与配方（recipes）作者清单
creation-playbook.md	创作/游玩流程概念
design-orchestrator-guide.md	创作方法（可继续写英文 id，面向作者）
briefs/capability-authoring-brief.md	技能撰写交接（术语须与本文一致）
context-fragment-design.md	上下文片段格式、固定槽、投影排序与双锚点