12 KiB
12 KiB
用户可见文案与术语对照（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. 原则
- 内外分离：id 给机器；中文给用户。
- 本节词优先：对用户与作者文档优先用 §0；技术实现注释可写「编排器（Main Agent）」「配方（recipe）」对照。
- 阶段用产品词：lifecycle 的
design/play用户侧统一为 创作 / 游玩（勿译成「设计模式 / 播放」）。 - 与 SKILL
name对齐：磁盘 worker 若已有中文name，展示优先用 name；本表是缺省与高频兜底。 - 气泡标题形态：
{中文名}或{中文名} · {动作}，例如「创作 · 流程编排 · 产出」，不要「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 |
主世界层（旧称：世界推演） |
auditor |
旁观维护（表/规则检查；默认空操作） |
chance |
机遇裁定（按需：骰子/抽签/比点；程序工具） |
round-present |
回合呈现 |
配方选项展示名示例：world-simulator（recipe）→ 世界模拟器；expand-assistant → 扩写助手。
创造执行单元时：规格里另写 name（中文展示名）。ref 仍用英文 kebab；UI 优先 name。
5.1 游玩拓扑称呼（作者文档）
内部调度单位仍叫 执行单元（Worker）——一次上场调用，这个词准确，不要废除。
作者讨论职责时可用与酒馆主 GM 同构的说法（对用户 UI 仍用上表）：
| 作者可用 | 典型 ref | 含义 |
|---|---|---|
| 旁观维护 | auditor |
副 LLM：表/规则检查与按需补充；默认每轮上场、多数轮空操作；不写真相 |
| 主世界层 | world-simulator |
读变量与 Progressive 投影、按规则改真值/交事件；多数世界观与查表归这里 |
| 叙事转述 | narrator |
把裁决写成用户可见正文（若规格拆了呈现） |
| 机遇裁定 | chance |
按需程序工具（掷骰/比点/抽签）；不进每轮管线；结果 tag 运行.本轮.机遇 |
| 角色视角 | role-decide |
仅强信息隔离；只出反应建议 |
推荐调度：auditor → perspective? → gm → narrator。
默认少拆：百科、分档性格、章大纲投影 → 主世界层 + 表副作用，不要再拆「世界观执行单元」「性格执行单元」。详见 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 |
上下文片段格式、固定槽、投影排序与双锚点 |