术语速查
本页按主题分组解释站内反复出现的术语。定义只保留一句话结论；完整规则见对应页面。代码标识符保持原样，中文译名不替代接口名。
架构与生命周期
| 术语 | 一句话定义 | 详见 |
|---|---|---|
| 大插件 | 功能单位，不可变，由框架定义，第三方不得新增。 | 大插件与小插件 |
| 小插件 | 与「子插件」同义：大插件内部的一个分项，是实现位里的一个条目，可由 Plugin 替换；不是 Plugin 与 Mod 的统称。 | 插槽与实现位 |
| 子插件 | 大插件内部的一个分项，是实现位中的一个条目，可变，可由 Plugin 替换。 | 插槽与实现位 |
| 根插件 | 构建期确定的框架骨架，属于大插件，只能随框架构建更新。 | 根插件名单 |
| 根插件名单（RPM） | 构建脚本从源码扫描生成的不可变清单，列出根插件、契约、入口哈希与可写落点。 | 根插件名单 |
| 大插件契约 | 大插件声明的服务、插槽、registry 与版本，是准入与替换的机械依据。 | 大插件总表 |
| 装载管线 | 从解析清单、版本求解、签名核验、准入判定到挂载与装载后核验的固定流程。 | 装载管线与 guard |
| guard | 装载器的一部分，只在单元装载时做三态裁决。 | 装载管线与 guard |
| 三态裁决 | guard 的输出：允许、拒绝、待用户裁决；挂起与界面归装载器。 | 装载管线与 guard |
| 作用域（scope） | 单元挂载时建立的 Cordis 生命周期范围，卸载时整域撤销。 | Kernel |
| 隔离域（isolate） | 服务解析的命名空间隔离，不是安全边界。 | 隔离运行 |
| 装载后核验 | 挂载后核对实际发生的写边与声明是否一致，不符即卸载。 | 装载管线与 guard |
| boot | 启动层，负责读取 RPM、建立宿主绑定、装载根插件与内置包，不属于任何根插件。 | 网页与 Tauri |
| boot:settled | 装载完成且首帧渲染完成之后的时刻，用于启动期清理提示。 | 孤儿标记与清理 |
| 信任锚链条 | host → 产物常量 → RPM → guard → 其余单元的逐级核验关系。 | 信任与签名 |
| 分发包 | 一次装载可含多个子单元的包，每个子单元分别判定。 | 分发包与包结构 |
扩展与信任
| 术语 | 一句话定义 | 详见 |
|---|---|---|
| 四档扩展模型 | 按「是否含代码」与「是否产生写边」把扩展分为数据包、资源包、插件、Mod。 | 四档扩展模型 |
| 数据包 | 无代码、写 registry 条目、承载内容与逻辑的数据单元。 | 包清单与目录 |
| 资源包 | 无代码、通过 VPath 覆盖表现资产的表现单元。 | 资源管线 |
| 插件 | 有代码、无写边，只新增自己的能力节点。 | 四档扩展模型 |
| Mod | 有代码且至少有一条写边的单元，改写既有能力。 | policy 与写边 |
| 读边 | 只读取他人能力，不需要许可，不参与四档分类。 | policy 与写边 |
| 写边 | 改变自身子树之外既有服务或机制插槽的可观测行为，是 Plugin 与 Mod 分类的唯一依据；数据包写 registry 条目不计写边，属于内容覆盖。 | policy 与写边 |
| policy | 被作用目标自身声明的静态开放度，只决定准入，不参与运行期协商。 | policy 与写边 |
| closed | 目标独占，写入一律拒绝并保留原值。 | policy 与写边 |
| public | 预授权覆盖，放行后表现为普通 Mod。 | policy 与写边 |
| trusted | 允许写入但须更高信任：清单内签名或逐条用户同意，并记入审计。 | policy 与写边 |
| 机制插槽 | 大插件对外提供的改写型插槽，Mod 专属。 | 插槽与实现位 |
| 实现位 | 大插件对外提供的 registry 注册位，Plugin 专属，分 single 与 multi。 | 插槽与实现位 |
| registry | 由大插件提供、按条目 ID 分层叠加的只读查询面，写入只经装载器。 | Kernel |
| 能力（caps） | 宿主按单元清单授予的受控能力；必需能力缺失即拒绝，可选能力缺失降级。 | 信任与签名 |
| 预算 | 单元声明的资源上限，只能小于或等于框架默认值。 | 包清单与目录 |
| 四态判定 | 清单内通过、清单外通过、核验失败、未签名四种签名状态，处置各不同。 | 信任与签名 |
| TOFU | 首次信任：首次装载记录发布者名与公钥指纹的唯一映射。 | 信任与签名 |
| 发布者名 | 用于展示的清单字段，安全判定不依赖它，须经规范化与同形检测。 | 信任与签名 |
| 公钥指纹 | 公钥原始字节的 SHA-256，是发布者身份的机械依据。 | 信任与签名 |
| 签名清单 | 由根密钥签名的官方发布者与撤销列表，可单调更新。 | 信任与签名 |
| 归档 hash | 全部文件「路径 → SHA-256」表的 JCS 规范化后再哈希，用于未签名批准与内置包登记。 | 包清单与目录 |
| 安全关键 UI | 展示信任与权限决策信息的界面，免疫于任何资源包。 | 隔离运行 |
| 知情权原则 | 信任状态变更必须展示身份、时间、来源与变更内容。 | 信任与签名 |
| 信任存储 | 框架之外的独立数据库，保存个人信任记录与批准，是唯一允许绕过内核的例外。 | 信任与签名 |
| 未签名批准 | 用户对未签名单元的显式批准，绑定归档 hash，hash 变化须重新批准。 | 信任与签名 |
| 撤销 | 官方清单拒绝被撤销密钥的新装载，已装载单元继续运行。 | 信任与签名 |
| 隔离运行 | 特定单元在独立 realm 中执行，主 realm 不执行其代码。 | 隔离运行 |
| 命名空间 | 一切跨文档 ID 的 <ns>:<局部名> 前缀，core 与 sui 保留。 | 接口命名规范 |
剧本与资源
| 术语 | 一句话定义 | 详见 |
|---|---|---|
| 剧本 IR | 节点图与节点内指令流分层的内部剧本表示。 | 剧本 IR |
| 剧本图 | 一份 IR 文档，包含 id、入口、节点与边。 | 剧本 IR v1 |
| 节点 | 指令流的容器，拓扑只在边中表达。 | 剧本 IR v1 |
| 边 | 连接节点的有向关系，携带条件、权重、一次性标记与不可选提示。 | 剧本 IR v1 |
| 指令 | 节点体内的最小执行单位，写作 <ns>:<名>。 | 剧本 IR v1 |
| 条件 | 只读旗标的声明式布尔结构，可用 all／any／not 组合。 | 剧本 IR v1 |
| 旗标 | 跨节点保存的布尔、数字或字符串状态，写入须有命名空间所有者。 | ScriptPlay |
| 章节序列 | 描述章节标题、入口与插入锚点的 registry，成环即拒绝。 | ScriptPlay |
| 台词文本 | 字符串、文本段数组或 lang 表键引用三种形态。 | 剧本 IR v1 |
| VPath | assets/<ns>/<类型>/<路径> 形式的全局虚拟路径。 | 资源管线 |
| 来源栈 | 同一 VPath 的有序候选来源列表，后挂优先，builtin 最低。 | 资源管线 |
| 变体 | 同一 VPath 的不同形态，由管线按消费者声明选择。 | 资源管线 |
| 句柄 | Asset 交付的只读资源对象，不暴露 URL，释放后失效。 | Asset |
| 解码器 | 把字节转换为可用值的实现位条目，解码路径受额外限制。 | Asset |
| 解码路径 | 从资源路径到解码器或生成器的解析链，数据包与资源包不得影响它。 | 资源管线 |
| 翻译层 | 把特定输入源的剧本、逻辑与资源转译为通用协议的唯一边界。 | 翻译层 |
| 翻译规则 | 描述格式识别与字段映射的声明式数据包。 | Translate |
| 翻译器 | 执行翻译的插件，只新增、无写边。 | Translate |
| 翻译产物 | 翻译输出的数据包与资源包，不自动装载。 | Translate |
| lang 表 | 资源包内 assets/<ns>/lang/<语言标签>.json 的扁平「键 → 文本」表。 | Text |
平台与宿主
| 术语 | 一句话定义 | 详见 |
|---|---|---|
| 宿主 | 为框架提供文件、窗口、音频等能力的平台层，网页与 Tauri 是两种宿主。 | 网页与 Tauri |
| 网页宿主 | 以浏览器能力为基线的宿主，功能完整但不伪造原生能力。 | 网页与 Tauri |
| Tauri 宿主 | 在浏览器基线之上补充文件系统、原生选择器等差异的桌面宿主。 | 网页与 Tauri |
| 外壳 | 框架自带的应用界面层，持有装卸载控制面与设置，不属于扩展单元。 | Platform |
| 播放区 | 外壳提供给 Stage 与对话框的绘制容器，经 platform:host.surface() 取得。 | Platform |
| 控制面 | 只交给 boot 与内置外壳的装卸载、信任与查询接口，不进入普通 ctx。 | Kernel |
| 存档槽位 | 一次存档的编号与数据，包含位置、旗标、随机状态、访问记录与涉及单元。 | Save |
| 归属登记 | 写入持久数据时登记的单元归属记录，用于孤儿识别与清理。 | 孤儿标记与清理 |
| 孤儿 | 归属单元已不在，但仍留在持久存储中的记录或数据。 | 孤儿标记与清理 |
| 可清理性 | 代码单元声明的 none／closed／public，决定其数据能否被清理。 | Save |
| 已读 | 按「剧本图 + 节点 + 指令位置」记录的全局读过集合。 | ScriptPlay |
| 自动播放 | 台词显示完且语音结束后等待设定时长再推进的模式。 | ScriptPlay |
| 快进 | 立即推进台词、跳过语音与部分演出的模式，可设置为只跳已读。 | ScriptPlay |
| 历史 | 本次游玩最近若干条台词的回顾面板，可重播语音。 | ScriptPlay |
| 合成器 | Stage 的渲染后端实现位，内置 Canvas 与 PixiJS 两种。 | Stage |
| 演出执行者 | 按指令名登记的演出实现，由 Stage 与 Audio 分别提供。 | ScriptPlay |
| 导航 | 平台提供的界面栈服务，界面之间只经它互相打开。 | Platform |
| OPFS | 网页宿主用于持久化翻译产物等目录的站点私有存储。 | Translate |