AI 视频创作平台：将小说、剧本或创作构想转化为短视频。本文件是领域术语表（ubiquitous language），只定义概念，不含实现细节。
供应商（provider）： 向 ArcReel 提供文本、图片、视频或语音生成能力的外部服务方。 Avoid: vendor、channel。
调用通道（backend）： 一对供应商 + 模型落到具体协议后的可调用形态；供应商解析产出的是供应商模型组合（ProviderModel）身份，据此构造出的调用通道才真正发起供应商调用。 Avoid: client、adapter、后端——「后端」在中文里已被 frontend/backend 占用。
模型（model）： 由模型厂商发布、经供应商提供的一项具体生成服务；同一供应商可以提供多个用途和能力不同的模型，同一模型也可以经多个供应商调用。 Avoid: 把供应商与模型当作同一层概念。
模型厂商（model maker）： 训练并发布模型的一方，如 Google、字节跳动；与供应商不同，Gemini 经 AI Studio 和 Vertex 两个供应商调用，模型厂商都是 Google。 Avoid: 把模型厂商当作供应商、用「官方渠道」指代模型厂商。
模型目录（model catalog）： ArcReel 所知的全部模型条目，是内置供应商、自定义供应商与 Agent 共用的模型元信息与价格来源。 Avoid: 注册表、价格表、把它当作某个供应商的模型列表。
模型条目（catalog entry）： 模型目录中的一项，描述一个模型本身的事实：媒体类型、能力、限额与官方价格；与经哪个供应商调用无关，各供应商共用同一条，身份是「模型厂商/官方模型名」，两栖模型的两个条目再以媒体类型区分。 Avoid: 把同一模型在不同供应商下登记成多条、在条目上记录某个供应商的价差。
供应商模型（provider model）： 某个供应商名下提供的一个模型，记录它经哪个调用端点、以什么 API 模型名调用；内置供应商与自定义供应商共用这一概念。内置供应商下分官方收录与用户添加两种。 Avoid: 模型行（旧称）、在供应商模型上另立价格、供应商模型的同步开关。
模型别名（model alias）： 同一个模型在官方模型名之外的其他调用名，如带日期的快照名、中转站的常见命名；只用于把模型名对应到模型条目。价格或能力不同的变体不是模型别名，各自是一个条目。 Avoid: 不加限定地说「别名」、与资产别名混用、把价格不同的日期快照登记为模型别名。
条目绑定（entry binding）： 用户为自定义供应商的供应商模型或 Agent 凭证的档位手动指定的模型条目。 Avoid: 关联、条目引用、把按名字现查的结果当作存下来的对应关系。
官方收录（officially listed）： 内置供应商的某个供应商模型出现在官方数据给该供应商的清单中；与之相对的是用户添加的供应商模型。 Avoid: 预设模型、内置模型。
能力覆盖（capability override）：
供应商模型上对模型能力的整维替换，表达这个渠道与模型条目或调用通道声明的差异（见 docs/adr/0104）。
Avoid: 为渠道限制修改模型条目、在官方收录的供应商模型上覆盖能力。
出厂快照（factory snapshot）： 随版本发布的模型目录数据，取自发版时的目录数据仓库。 Avoid: 内置价格表、默认数据。
官方数据（official data）： 来自目录数据仓库的模型目录数据，即出厂快照与官方同步的合称，与用户修改相对。 Avoid: 预设数据、上游数据。
官方同步（official sync）： 实例自动从目录数据仓库取回比出厂快照更新的模型目录数据。 Avoid: 自动更新、在线目录、把它当作官方服务的功能。
目录数据仓库（catalog data repository）： 发布模型目录数据的公开仓库，出厂快照与官方同步都取自它。 Avoid: 把它当作市场源、同步服务器。
最低应用版本（minimum app version）： 官方收录的供应商模型上标注的、能调用这个模型的最低 ArcReel 版本。 Avoid: schema 版本、兼容版本。
第三方数据源（third-party metadata source）： 由外部项目维护的模型元信息与价格数据，如 basellm、models.dev，是目录数据仓库的构建输入。 Avoid: 同步源、上游目录。
凭证（credential）： ArcReel 访问某个供应商所需的认证信息。媒体供应商的设置界面称「密钥」（英文界面为 Key），如「已配置 2 个密钥」「添加密钥」。 Avoid: 模型、供应商、连接。
内置供应商（built-in provider）： ArcReel 随版本内置、开箱可用的供应商，用户填好凭证并选定模型即可使用，代表官方渠道。 Avoid: preset、official、用内置供应商接中转站。
自定义供应商（custom provider）： 用户在运行时自行创建的供应商，其供应商模型各自挂接一个调用端点；凭证只有 api_key 与 base_url 两项，api_key 可留空。 Avoid: 内置供应商。
调用端点（endpoint）： 自定义供应商的供应商模型可挂接的一种调用形态——或是一套协议约定（URL 模板、鉴权约定与字段语义），或是一份 ComfyUI workflow 连同其节点绑定。 Avoid: protocol、format、端口、接口格式、HTTP 端点——它不是某个 URL，是一整套调用约定。
内置调用端点（builtin endpoint）： ArcReel 随版本内置在注册表中的调用端点，实现形态可以是 Python backend，也可以是一份随版声明式定义；只读，不可编辑或删除，声明式实现的内置端点可「复制为我的」产出一个自定义调用端点。 Avoid: 系统预设端点、预设端点、preset。
自定义调用端点（custom endpoint）： 用户在运行时创建或导入的调用端点，持有一份端点定义；全局存在，可被多个自定义供应商的供应商模型挂接，与内置调用端点同属「调用端点」，只是来源不同。 Avoid: 协议模板、自定义协议、把它当作某个自定义供应商的附属物。
声明式端点（declarative endpoint）： 端点定义为一套协议约定的调用端点，请求模板、响应取值与状态映射都写在定义里、由通用运行时执行。 Avoid: JSON 端点、模板端点。
ComfyUI 端点（ComfyUI endpoint）： 端点定义为一份 ComfyUI workflow 及其节点绑定的自定义调用端点，只能挂接到 ComfyUI 协议供应商的供应商模型上；一份 workflow 恰是一个端点。 Avoid: workflow 端点、工作流端点、把它当作供应商——一台 ComfyUI 服务是供应商，一份 workflow 才是端点；把一份 workflow 当作一个供应商模型。
端点定义（endpoint definition）：
描述一个调用端点如何被调用的 JSON，按 kind 分声明式协议定义与 ComfyUI workflow 定义两种；是该端点的唯一真相，也是导入、导出与市场安装的载荷；两份定义是否算同一份，看 meta 中的作者与名称。
Avoid: 配置、协议模板、血统 / provenance——说「同作者、同名的定义」。
路径覆盖（path override）：
自定义供应商的供应商模型上，对其调用端点的某一条请求整条替换 URL 路径，请求的其余部分不变（见 docs/adr/0101）。
Avoid: 自定义路径、URL 覆盖、把它记在供应商或调用端点上。
节点绑定（node binding）： ComfyUI 端点上，ArcReel 的一个具名语义（提示词、首帧、尾帧、参考图、宽高、帧数、帧率、种子、产物）落到 workflow 中哪些节点的哪个输入（产物则是哪个节点的输出）的对应关系；导入时自动推断出的只是候选，用户保存后才算节点绑定。某项语义没有节点绑定即 ArcReel 不驱动该维度、对应值以 workflow 字面值为准，提示词与产物两项必有。一项语义有三态：有节点绑定、经用户确认的「此 workflow 不支持」、以及从未推断过——后两者都是「没有节点绑定」，但只有后者会在导入时重新跑推断。 Avoid: 槽位、映射、mapping、裸用「绑定」、把推断候选当作节点绑定、把「从未推断」说成「不支持」。
示例模板（example template）： 随前端源码附带、不可挂接的定义示例，仅作「新建自定义调用端点」表单的预填内容。 Avoid: 起步模板、起步骨架、模板文件。
端点测试（endpoint test）： 对一份自定义调用端点定义在保存前后进行的验证操作，分预览请求、验证响应、测试连接三种模式；ComfyUI 端点只有预览请求与测试连接两种。 Avoid: 试跑、试跑器、试运行。
预览请求（preview request）： 端点测试的一种：按定义与参数渲染出将要发出的请求供人查看，不向供应商发送。
验证响应（check response）： 端点测试的一种：用一份供应商的真实响应验证定义的取值路径与状态映射，不向供应商发送请求。
测试连接（trial run）： 对一份自定义调用端点定义或一个供应商模型真实提交一次生成并轮询到终态，会产生费用或占用算力；是唯一能证明模型可成功调用的检查。 Avoid: 把供应商级的连通性检查叫作测试连接。
连通性检查（connectivity check）： 供应商级的免费探针，只验证凭证可达（如能列出模型），不证明任何模型能成功生成。 Avoid: 测试连接（旧称）。
规范供应商 id（canonical provider id）： 供应商身份的规范写法，是全系统唯一接受的写入形式。
旧版供应商别名（legacy provider alias）： 历史数据中曾用于指代供应商、但不属于规范供应商 id 的兼容名称。 Avoid: 将旧版供应商别名作为可写的供应商身份。
API 模型名（api_model_name）：
供应商模型实际发送给供应商 API 的模型名，可以与模型条目的官方模型名不同，如中转站上的 anthropic/claude-sonnet-4.5（见 docs/adr/0038）。
Avoid: 把模型条目的身份直接当作发给供应商的模型名。
两栖模型（amphibious model）：
同一个供应商 API 模型名同时承载图像与视频两种 media_type 的模型，在 ArcReel 内拆成两条模型条目分别登记（见 docs/adr/0038）。
Avoid: 把别名键当成真实模型名。
模型发现协议（discovery_format）：
自定义供应商上决定「模型发现」与「连通性检查」按哪套接口进行的声明，不决定任何模型的调用协议；comfyui 取值下模型发现不适用，只做连通性检查。
Avoid: api_format、把它当模型调用协议开关。
生效凭证（active credential）： 同一供应商下配置多套凭证时当前生效的那一套，由用户在 UI 手动切换、全局生效，每个供应商至多一条生效凭证。 Avoid: default credential、已启用凭证——该词暗示可同时启用多条、把切换理解为自动轮换或负载均衡。
Agent 凭证（agent_credential）：
供 Claude Agent SDK 使用的 Anthropic 兼容网关凭证（base_url + api_key + routing model），存于独立的 Agent 凭证表，与自定义供应商凭证互不相通（见 docs/adr/0017）。界面上称「Agent 供应商」（「添加供应商」「删除供应商」），每条对应一个网关。
Avoid: 把它当成一个自定义供应商。
市场（market）： 用户从一个或多个市场源浏览并安装内容的功能区，浏览与安装只靠本地 ArcReel 与市场源仓库运转，不依赖任何中心服务或账号；首期唯一的市场条目类型是调用端点。 Avoid: 模板库、商店 / store、registry、插件市场、社区。
市场源（market source）： 一个以索引文件列出其市场条目的 GitHub 仓库（或等价的直链地址），在 ArcReel 内登记后即可从中浏览与安装；官方市场源随版预置，其余是用户自行添加的第三方市场源。 Avoid: 裸「源」「仓库」「来源」、registry、feed、镜像。
市场条目（market entry）：
市场源索引中的一项可安装内容，由源内唯一的 slug 标识、以 meta.name 为显示名，载荷是一份端点定义；跨源同 slug 不代表同一份定义。
Avoid: 裸「条目」、插件、包、模板。
安装（install）： 把一个市场条目的端点定义落为本地自定义调用端点，并记下它来自哪个市场源的哪个条目，此后该端点跟随该条目；从本地文件导入不留这层绑定，不算已安装。 Avoid: 把「导入」与「安装」混用、下载、订阅。
官方服务（official service）： 由 ArcReel 方运营、位于市场之上的覆盖层，记录安装量与评分、接收分享提交；不是市场源，不参与浏览与安装链路，可由用户关闭。 Avoid: 云服务、后台、registry。
实例标识（instance id）： 一个 ArcReel 实例本地生成的随机标识，随发往官方服务的请求发送，用于服务端去重；可由用户重置。 Avoid: 设备 ID、用户 ID。
分享提交（submission）： 用户从客户端经官方服务把一个自定义调用端点提交到官方市场源的动作及其记录；采纳与否由市场源仓库的 PR 决定。 Avoid: 投稿（保留给手工 PR 路径）、发布、上传。
生成任务（task）： ArcReel 为完成一次媒体生成而排队和跟踪的工作单元。 Avoid: 作业、供应商调用。
供应商调用（api_call）：
ArcReel 向外部模型供应商发起的一次 API 请求，也是费用与用量记账的最小单位；内嵌 Agent 例外，一轮中对同一模型的各次请求合记为一次供应商调用（见 docs/adr/0102）。它可以服务于一个生成任务（一个任务可对应零到多次调用），也可以独立发生（剧本生成、Agent 会话、端点试跑）。
Avoid: 供应商任务、生成任务、把调用与任务当作一一对应。
供应商任务（provider_job）： 供应商侧为一次提交-轮询型生成创建的远端异步操作；它的状态由供应商写入，与 ArcReel 本地的生成任务状态同名不同物。 Avoid: 与本地 task 状态混为一谈、生成任务。
整批准入判定（batch_admission）： 「生成全部 / 批量生成」在创建任何任务之前对全部目标做的一次性全有或全无判定，三种结论：放行、待确认（跨档费用聚合等用户拍板）、受阻（零任务创建）；它只说这一批能不能建，不预言建成后的执行成败。 Avoid: 把整批拒绝说成「批量失败」。
执行检查点（execution_checkpoint）： 视频任务首次向供应商提交前冻结的单次付费请求身份与实际输入事实，只证明「这次提交如何发生」，不是入队快照或产物标记。 Avoid: request snapshot、resume payload、current marker。
孤儿任务（orphan task）：
记录为执行中、但实际已没有任何执行体在跑的生成任务，现实成因是服务重启（见 docs/adr/0007）。
续跑（resume）： 服务重启后对持有供应商任务 id 的孤儿视频任务接续轮询与下载、不重新提交的自愈路径；供应商侧任务已过期或找不到时续跑显式失败，不回退为重新提交。 Avoid: 重试、重新提交、重启自愈（那是成因描述，不是路径名）。
取消（cancel）：
用户主动撤下一个尚未开始执行的生成任务，只对 queued 开放；任务一旦开始执行就不可取消——已发出的供应商调用照常跑完、结果照常成为产物，不让已产生的费用落空。
Avoid: abort、stop、把取消理解为中断执行中的生成。
取消来源（cancelled_by）：
取消来源标记：user 表示用户从 UI 触发，cascade 表示下游依赖被一并取消，interrupted 表示进程级打断（事件循环拆除、关停超时等）落下的取消，不是用户动作；系统内部超时回收不算取消。
供应商解析（resolve）： 给定一个生成任务，决定它应使用哪个 ProviderModel；优先级自高而低：本次请求 > 项目级 > 全局默认，这是"选身份"，不含调用通道构造。 Avoid: 用 resolution 指代此过程——resolution 专指图像/视频分辨率。
供应商模型组合（ProviderModel）：
供应商解析的结果——一对 (provider_id, model_id)，是指认一个供应商模型的值对象，不是调用通道。
Avoid: ResolvedBackend、BackendSelection。
文本任务档位（text task tier）：
文本生成调用点的粗粒度分级，取值简单 / 复杂；用户配置的是「每档用哪个文本调用通道」，另有一个「默认模型」作为各档未设置时的回退（见 docs/adr/0051）。
Avoid: 为单个调用点开专属模型设置项、把 Agent 对话模型当作某个档位。
模型能力（capabilities）： 一个模型支持的生成输入、输出和控制方式，例如是否接受参考图、是否生成有声视频或是否支持尾帧。 Avoid: 把模型能力与用户选择哪个模型混为一谈。
模型选择（model_selection）： 为不同生成用途指定所用模型的设置；未单独指定时使用默认模型。 Avoid: 生成模型。
任务类型（generation_type）：
一次生成请求按输入形态划分的分类，与媒体类型正交——媒体类型说产出什么媒体，任务类型说拿什么输入去生成：图片 t2i（文生图）/ i2i（图生图），视频 i2v（图生视频，首帧驱动）/ r2v（参考生视频，参考图槽位驱动）；图片的 t2i/i2i 只有执行时才能确定（见 docs/adr/0001）。
Avoid: t2v、与模型能力混为一谈。
任务类型桶（GenerationTypeBucket）：
按任务类型细分的可选模型配置槽位（图片 t2i / i2i，视频 i2v / r2v），是「默认模型」之上的细化覆盖，未配置的桶回退同层默认模型（见 docs/adr/0054）。
Avoid: 把桶当强制配置、在用户可见文案里写「任务类型桶」。
执行模型（effective model）： 给定调用点的任务类型与当前配置，分层解析最终选中的模型；与「默认层模型」相对——默认层只是解析的一层输入，执行模型才是真正会执行的那一个。 Avoid: 把执行模型当可配置项、用默认层模型作能力查询键。
视频请求事实（video request facts）：
一次视频生成请求的执行事实——执行模型、下发的分辨率、收窄后的可选时长及成因、时长是否由端点固定、音轨形态；每次请求只求值一次，提交前与执行时只差身份来源（见 docs/adr/0086）。
Avoid: 在报价、预检或界面各自推算其中一项。
图片编辑（image_edit）： 根据创作者的编辑指令修改一张已有图片，并保留未要求改变的主要内容；编辑产生新版本，不会改写生成原图所用的图片提示词。 Avoid: 重新生成、局部重绘、把编辑指令当作图片提示词保存。
比例（aspect_ratio）：
输出的宽高比（如 9:16 / 16:9 / 1:1），项目级设定。
Avoid: 把比例混进分辨率或尺寸字段。
分辨率（resolution）：
清晰度档位，只决定清晰度规模，不决定比例；自定义值若自带比例只取其短边作清晰度规模，比例仍由 aspect_ratio 决定（见 docs/adr/0011）。
Avoid: 用 resolution 指代供应商解析；把「未设置」说成某个具体档位。
尺寸（size）： 最终下传给调用通道的宽×高像素，由比例 × 分辨率档位在各调用通道的像素约束内推导。 Avoid: 把 size 当比例或清晰度的同义词。
可选时长（supported_durations）：
某视频模型允许的离散时长集合（秒）（见 docs/adr/0018）；空集只在时长这一维「由端点固定」时合法（见 docs/adr/0082）。
Avoid: 全局时长白名单；把「由端点固定」的空集当作配置缺失。
维度由端点固定（endpoint-fixed dimension）：
尺寸或时长这一维不由 ArcReel 驱动、只由端点自身决定的状态；当前只有 ComfyUI 端点会进入（见 docs/adr/0082）。
Avoid: 把它说成「不支持该维度」或「配置缺失」。
时长联动约束（duration_resolution_constraints / reference_image_durations）：
在 supported_durations 全集之上，按分辨率或参考图上下文进一步收窄可选时长的两条逐模型声明；收窄结果与成因属于视频请求事实。
Avoid: 全局时长约束表；在界面复算收窄。
偏好时长（default_duration）： 项目级偏好时长（int）；为 null 或缺失时是有语义的「auto」档——由 AI 按内容节奏在 supported_durations 内自行决定。 Avoid: 把 null 读成「未配置」而擅自补默认值。
原图（reference_image）：
用户上传的、用于表达主体真实外观或创作意图的源图片；角色、场景、道具的原图只作为生成资产图的输入，不直接充当分镜或视频生成的参考图，商品原图例外（见 docs/adr/0034、docs/adr/0073）。
Avoid: 资产图、把所有上传图片都叫参考图、用原图顶替缺失的资产图。
参考图（reference image）： 在某次生成中作为条件输入、用于引导身份、风格或构图的图片；原图、资产图和其他生成结果都可以在一次具体生成中充当参考图。 Avoid: 把参考图当作图片的永久类型。
声明引用 / 可用参考图（declared reference / available reference image）： 参考生视频的视频单元正文里作为画面参考引用的资产是声明引用；其中此刻确实能随请求发出参考图的部分是可用参考图。 Avoid: 只凭「名字已登记」判断视频单元带参考图。
参考上传副本（reference upload copy）： 把参考图编码进供应商请求体那一刻所用的那份字节数据，是临时副本，用完即删，不是磁盘上的源资产文件或生成产出。 Avoid: 把「压缩参考图」误读为压缩源文件或产出。
参考图压缩（reference image compression）：
仅对参考上传副本做的等比缩放 + 重编码，对源资产与产出零影响（见 docs/adr/0012）。
Avoid: 把它与上传保存时压缩混为一谈。
参考图裁剪（reference image clamping）：
一次生成装配出的参考图超过所选模型的数量上限时，按装配序保留前 N 张、去尾丢弃其余，编号只指认实发的图；产物依据仍按完整装配集登记（上限是供应商属性，见 docs/adr/0062）。裁剪一旦发生，分镜图 / 宫格任务结果与参考生视频路线一样在 warnings 里带一条超限提示，最终提示词预览也随分镜图侧给出同一条，用户与 Agent 都能看到有参考图没随请求发出。
Avoid: 把裁剪当作按类型取舍——它不看类型优先级；把它当成只写日志的静默行为。
生成费用（cost）： 使用模型完成内容生成所产生的费用，按模型目录的价目表与倍率估算，是参考指标而非实际账单；提交前显示预计费用，调用完成后记录该次调用的费用，无法关联到具体内容的费用显示为未归属费用。 Avoid: 成本快照、费用归属；面向用户文案里把它称为实际账单。
参考费用（reference cost）： 面向用户展示的费用口径，按模型目录的价目表与倍率估算得出，不是供应商账单金额。 Avoid: 实际费用、账单、成本。
价目表（price table）： 模型条目上的官方价格：以一个币种标价，列出各计量项按选择维度取值的单价。 Avoid: 定价形状、费率表。
计量项（meter）： 计价时被计数的一种用量，如未缓存输入 token、缓存读 token、输出张数、输出秒数、字符数、次数。 Avoid: 计价单位、计费类型。
选择维度（pricing dimension）： 决定计量项取哪一档单价的调用属性，如分辨率、质量档、是否有声、服务档、上下文档。 Avoid: 档位、规格。
上下文档（context tier）： 按单次请求的输入 token 总量落入的价格档，整个请求的 token 单价都按这一档取。 Avoid: 阶梯价、长上下文加价。
倍率（price multiplier）： 表达渠道价差的系数，乘在整笔参考费用上：供应商调用分供应商倍率与供应商模型倍率两级，Agent 调用只有 Agent 凭证倍率一级。 Avoid: 折扣、分组倍率、补全倍率。
未定价（unpriced）： 一次供应商调用找不到适用单价时的费用状态，与费用为 0 不同。 Avoid: 免费、0 元。
使用记录（usage record）： 面向用户的供应商调用视图：分「生成调用」与「Agent 会话」两个视图——前者以一次调用为一行的时间线，后者把 Agent 的调用按会话聚合、每个会话一行，展开后按时间列出各模型的明细；另有筛选、汇总与异常关注。它是对调用事实的投影，不是独立存储的实体，两个视图只是展示方式不同，记账粒度不变。 Avoid: 账本、落账、费用明细、调用记录。
来源（purpose）： 一次供应商调用被发起的原因，取值为剧本生成、分集规划、项目概览、风格分析、Agent 会话、端点试跑、生成任务之一。 Avoid: origin、调用场景、任务类型。
主币种（primary currency）： 一段使用记录期间内参考费用汇总金额最大的币种；图表与构成表只按主币种作图，其余币种单独列出而不折算。 Avoid: 默认币种、基准币种、把多币种折算成单一金额。
需要关注（attention）： 使用记录中自动判定出的调用异常：某供应商或模型的失败率显著高于同期总体，或同一生成目标连续失败，只统计生成调用，Agent 的调用不参与；无异常时不出现。 Avoid: 告警、报警、异常列表。
媒体类型（media_type / call_type）：
贯穿全系统的媒体维度，取值 image / video / text / audio，供应商解析、调用通道家族、用量与计费都按媒体类型扇出；其中 audio 承载文本转语音，与 image / video 一样经生成队列调度（见 docs/adr/0010）。
Avoid: modality、media kind、用 tts / voice / speech 指代 audio。
旁白配音（narration_audio）： 为旁白或解说文本生成的独立语音素材，可与画面在后期合成。 Avoid: 生成旁白、视频声音、TTS 音频。
旁白交付方式（narration delivery）： 项目为画外音选定的配音途径：由 ArcReel 按项目的 TTS 设置生成旁白配音，或交付后由创作者自行后期配音；它不影响视频生成。 Avoid: 旁白模式、配音设置、把它当作每次生成请求的参数。
生成有声视频（generate_audio）： 由视频模型在生成画面的同时生成与画面同步的声音。 Avoid: 生成音频、旁白配音、视频音频。
音色（voice）： 供应商内置的一位预设发音人，决定合成出来的语音听上去是谁在念。 Avoid: 用 voice 指代 audio 媒体类型本身、把音色与声音复刻混为一谈。
编排语速（speech rate）： 估算一段台词或画外音要念多少秒所用的绝对速度（中文为字/秒，英文与越南语为词/秒），按语言取默认值，项目可以覆盖；用于写剧本时安排编排时长和校验说话量，与由谁发声无关。 Avoid: 裸称「语速」、把它当作 TTS 的速度参数。
配音语速（narration speed）： TTS 项目为旁白配音设定的速度倍率，基准是所选音色本身的语速；它是项目 TTS 设置的一部分，只影响旁白配音，不影响台词。 Avoid: 裸称「语速」、按视频单元单独设置配音语速、把它换算成编排语速。
音色试听（voice_sample）： 用于试听和确认某种音色的短音频，不属于成片素材。 Avoid: 旁白配音、参考音频。
环境音描述（ambiance_audio）： 脚本中喂给视频模型的环境音效提示词，是文本字段而非音频文件。 Avoid: 旁白配音、生成有声视频。
声音一致性档位（voice_consistency）：
视频模型在跨片段保持角色音色上的三级标识：native（参考生视频直传角色原声）/ soft（有音轨但只能靠文字描述引导音色）/ none（无声），由「模型有无音轨」×「项目生成模式」×「角色声音绑定方式」三维派生。
Avoid: 用 generate_audio 的真假直接代指有无音轨。
角色声音绑定方式（character_voice_binding）：
项目级设置，声明角色的声音靠什么约束：prompt（默认）把角色的音色描述写进提示词做软约束，reference_audio 才把角色已设的参考音频随请求挂给视频模型。
Avoid: 声音模式、音频模式、用它指代旁白配音的音色设置。
项目（project）： ArcReel 中一项完整的视频创作，拥有自己的源文件、脚本、资产、生成模式和成片内容。 Avoid: 作品、工程、用剧集指代整个项目。
数据根（data root）： 一次部署在文件系统上存放运行数据的目录，项目只是其中一类数据。 Avoid: 项目根、projects 目录（用来指数据根时）、把数据根下的任意目录当作项目。
集（episode）： 项目中的一个连续内容单元；广告/短片项目也只有一集，但界面可以隐藏集选择。 Avoid: 用剧集同时指一集和整个系列。
资产图（sheet）： 为角色、场景、道具或商品确定标准视觉形象的图片，供同一项目中的后续创作复用；资产图用于某次生成时也同时充当该次生成的参考图。尚无可用资产图的资产称「待生成」。 Avoid: 设计图、设定图、参考设计图。
角色（character）： 在项目内容中以特定身份出现、可被多个视频单元复用的资产；一个角色有一个本体外观，可拥有若干衍生。 Avoid: 人物、人物资产。
本体（base look）：
角色条目自身的描述与资产图所定义的常驻外观；脚本中裸写 @[角色] 引用的就是本体。
Avoid: 默认形态、把本体当作衍生之一。
衍生（derivative）：
角色在本体之外的另一套持续外观（换装、变身、易容、年龄跨越等），与本体共享名字、声音与身份，只持有相对本体的外观变化描述和由本体资产图编辑生成的资产图；在脚本中写作 @[角色/衍生]（见 docs/adr/0072）。
Avoid: 变体（已指 Agent profile 变体）、形象、皮肤、把衍生登记为独立角色、给衍生上传原图。
场景（scene）： 可在多个视频单元中复用的环境资产，描述故事发生的地点与空间外观。 Avoid: 用场景指代脚本中的视频单元或剧情段落。
项目资产（project asset）： 当前项目拥有的角色、场景、道具和商品；它们只属于该项目，不会与全局资产库自动同步。 Avoid: 资源库、设定集。
全局资产库（global asset library）：
跨项目保存和复用角色、场景与道具的资产集合；角色的衍生以子表随本体整套进出（见 docs/adr/0072）。资产应用到项目后成为独立的项目资产，之后两边的修改互不影响。
Avoid: 项目资产、以为库内资产与项目资产会自动同步。
商品（product）： 广告/短片中需要准确呈现和推广的商品资产，以用户上传的商品原图作为外观真实性依据。 Avoid: 产品、产品资产、商品角色。
资产重命名（asset rename）：
以名称为身份的资产改换名称的原子级联事务，该名称的全部引用一次改齐（见 docs/adr/0057）。
Avoid: 用「新名 upsert + 删旧名」拼装改名。
资产合并（asset merge）：
把同一身份被登记成的两个同类型角色、场景或道具并成一个的原子级联事务：被并资产的全部引用一次改指保留资产，被并资产的名字成为保留资产的资产别名（见 docs/adr/0057、docs/adr/0092）。角色也可以并为保留角色的衍生：被并资产的名字成为衍生名而不是本体的资产别名，画面引用改指 保留角色/衍生，说话人改指保留角色。
Avoid: 用重命名到已有名字表达合并、把 upsert 的字段并入称为合并。
资产别名（asset alias）：
登记在角色、场景或道具上的其他称呼，包括源文中的其他叫法、改名前的旧名与合并掉的名字（并为衍生的除外），只作 AI 规划或生成脚本时认出同一资产的参考，不是资产的名字（见 docs/adr/0092）。
Avoid: 昵称、称呼表、把资产别名写进引用、不加限定地说「别名」、与模型别名混用。
风格模版（style_template）：
预置的整段画风提示词文本（真人 / 动画两类），选定时把展开后的提示词作为快照写入项目风格（见 docs/adr/0023）。
Avoid: 把 style 理解为短标签、与风格参考图叠加——二者互斥。
线索（clue）： ArcReel 早期对「场景 + 道具」的统称，现已拆为独立的 scene 与 prop 两类资产。 Avoid: 在新代码/文档里用 clue/线索 指代场景或道具。
项目事件（project event）：
服务端推给浏览器的一条「项目里哪个实体发生了什么」的记录，含实体类型、动作、实体 id、标签与定位；浏览器据此刷新项目并决定是否提示、是否跳转（见 docs/adr/0085）。
Avoid: 通知（通知只是前端对项目事件的一种呈现）、变更 hint（hint 只触发重扫，不描述发生了什么）。
项目状态投影（project state projection）： 把项目当前状态（项目元数据与全部剧本）归一成可比对快照的规则，它决定哪些状态变化算作项目事件。 Avoid: 影子 schema、手挑字段的快照。
创作类型（content_mode）： 项目内容如何组织和表达的分类，它与生成模式相互独立。 Avoid: 把创作类型与视频生成方法混为一谈。
旁白/解说（narration）： 以连续的旁白或解说组织内容、由画面配合讲述推进的创作类型。 Avoid: 旁白模式、说书模式。
剧情演绎（drama）： 以角色行动、对白和剧情场面组织内容的创作类型，可采用真人、动画等不同视觉风格。 Avoid: 剧集动画、drama 模式。
广告/短片（ad）： 围绕单条成片及传播目标组织内容的创作类型，适用于商品推广、品牌传播和独立创意短片。它没有源文与脚本规划，正式脚本由 AI 依创作灵感与商品整份生成或手写。 Avoid: 广告模式、短片模式、把它限定为带货视频。
创作灵感（brief）： 创作者对一条广告/短片想要什么的自由描述，如目标人群、风格调性、重点卖点与行动号召。 Avoid: 简报、需求、创作简报。
骨架（skeleton）：
脚本条目数组的结构种类，四值：segments（旁白/解说）/ scenes（剧情演绎）/ shots（广告/短片）/ video_units（参考生视频），由创作类型与生成模式两轴派生（见 docs/adr/0045）。
Avoid: 把骨架当 content_mode 的同义词、对未知模式做二值兜底。
生成模式（generation_mode）： 项目创建时选定的视频生成方法，决定视频由分镜图还是资产图等参考图驱动；同一项目内所有集采用同一种生成模式，创建后不可更改。 Avoid: 生成路线、与创作类型混为一谈。
分镜图生视频（storyboard）： 先为每个分镜生成分镜图，再以分镜图驱动对应视频生成的生成模式。 Avoid: 图生视频模式、分镜模式。
参考生视频（reference_video）： 以角色、场景、道具或商品的参考图直接驱动视频生成的生成模式，不需要先为每个分镜生成分镜图。 Avoid: 参考视频、参考模式、参考直出。
多宫格分镜（grid）： 把多个分镜合并成一张联合图统一生成、再经切分落格写成各分镜图的生产方式，用于增强画面风格与主体的一致性。 Avoid: 分镜板、故事板、把它当成与其他生成模式并列的模式。
联合图（grid composite）： 多宫格分镜中一次生成出的整张多宫格图，覆盖同一分组内按格排列的若干分镜；它本身是可审阅、可上传替换、可回滚的产物，不直接作为任何分镜的画面输入。 Avoid: 宫格图片、拼图、把联合图当成分镜图。
切分落格（grid split）： 把联合图按格切开、写成它覆盖的全部分镜的分镜图的动作，由用户审阅联合图后确认发起，Web 与 Agent 一致；联合图已就绪而尚未切分落格的宫格处于「未切分」状态，被切分覆盖的旧分镜图留在版本历史里可回滚。 Avoid: 拆图、自动切分、待切分、把切分落格当成生成的一部分。
分镜（segment / scene / shot）： 以分镜图驱动视频时，脚本中可独立编辑和生成的一条内容，即分镜图生视频下的视频单元；旁白/解说、剧情演绎和广告/短片都以分镜组织脚本。分镜的数量即分镜图生视频项目的内容规模度量。 Avoid: 把分镜与分镜图混为一谈、把参考生视频的视频单元计入分镜数。
分镜图（storyboard_image）： 为一个分镜确定构图和起始画面的图片，也是该分镜生成视频时的画面输入。 Avoid: 分镜、资产图、多宫格分镜。
章节切分点（segment_break）： 标在脚本某个分镜上、表示从这里另起一个章节的标记，像视频时间线上的章节；它是分镜图参考链与多宫格分组的边界，属于生成输入，不是剪辑决策。 Avoid: 以「场景」命名，如场景切换点（场景已指环境资产）、把它与源文的章节或分集混为一谈。
视频单元（video unit）：
一次视频生成对应的内容，是生成、计费、发声归属与剪辑引用的最小单位：分镜图生视频时即分镜，参考生视频时即一段自由文本加编排时长构成的条目（脚本字段 video_units 只指后者）；参考生视频项目以视频单元的数量度量内容规模。
Avoid: 场景、单位、用分镜指代参考生视频的视频单元。
引用语法（writing_syntax）：
创作者在正文中直接书写的记号。参考生视频的视频单元正文支持三种：@[名称] 引用已登记的商品/角色/场景/道具资产（@[角色/衍生] 引用该角色的某个衍生），@[名称]{台词} 引用资产并附带角色台词（说话人位写衍生时只绑该角色的声音），裸 {台词} 标注画外音（不引用任何资产）。分镜的 image_prompt.scene 只支持 @[名称]，用于指认该分镜引用字段里已声明的资产，渲染时换成参考图的「图N」编号；它不派生参考图。
Avoid: 把记号解析规则与资产登记混为一谈。
脚本（script）： ArcReel 根据小说、剧本或创作构想整理出的结构化创作内容，用于后续生成视频单元。 Avoid: 用剧本指代 ArcReel 的结构化产物。
小说（novel）： 供 ArcReel 改编为脚本的叙事文本源文件。 Avoid: 原作、脚本。
剧本（screenplay）： 用户上传的、已经包含剧情组织与对白安排的文本源文件；ArcReel 应优先保留其中可听见的内容，并补充视频制作所需的信息。 Avoid: 脚本。
源文件类型（source_kind）：
剧情演绎中一份原文的类型，分为小说和剧本，决定 ArcReel 是改编内容，还是优先保留作者已写成的剧情与对白。它属于源文件而非项目：整本源文的每个文件、自带原文的每一集各有一个（见 docs/adr/0036）。
Avoid: 与创作类型或生成模式混为一谈、当作项目级属性。
发声条目（utterance）： 视频单元里「说出来的话」的统一单元——每条要么是台词（有说话人，含对白、内心独白与角色的画外解说），要么是画外音（无说话人），插入顺序即先后。 Avoid: 把台词与画外音当两个独立无序字段、把角色的画外解说算作画外音。
对应原文（source_text）： 一个视频单元所依据的小说或剧本文本，用于创作者对照来源，不会作为独立内容被朗读或生成。 Avoid: 把对应原文当作旁白文本。
尾帧（end_frame_image）： 用户为单个分镜指定的、视频生成收束到的目标画面，是分镜条目的用户意图持久属性，不是生成产出。 Avoid: 把它与宫格产出字段混为一谈。
脚本规划（script_plan）：
ArcReel 把一集的集原文整理为可供创作者检查的脚本内容的制作步骤名；也指该步骤的产出，即供创作者在内容确认时检查与修改、确认后转为正式脚本的那份脚本内容，连同 AI 对本集新出现资产的处理决定，确认时随正式脚本登记（见 docs/adr/0092）。
Avoid: step1、内容整理、预处理、内容层、规划文件、中间态。
提示词编写（prompt_authoring）： 为正式脚本中待编写的视频单元补出视觉层的制作步骤名，输入是正式脚本自身的内容，不读脚本规划。 Avoid: step2、视觉展开、generate-script、增量编写。
提示词形态（prompt form）：
最终剧本中的视觉提示词所采用的表达形态，可以是结构化 JSON 或纯文本；两者都是正式提示词内容，形态本身也区分内容（见 docs/adr/0070）。
Avoid: 把纯文本当作预览缓存、把两种形态视为可无损互换的同一内容。
提示词模版（prompt_template）：
一个生成环节发给模型的完整提示词的定义，正文带数据槽位，随版本内置；渲染时填入项目数据后才是实发文本（见 docs/adr/0077）。
Avoid: 生成场景、prompt 模板、把它与风格模版或提示词正文混为一谈。
生成环节（generation stage）：
流水线上一次向文本、图像或视频模型发起调用的固定位置，按制作步骤、创作类型与生成模式区分，相同者合并；恰对应一个提示词模版。
Avoid: 生成入口（那是准入闸门，见 docs/adr/0073）、场景、调用点、builder。
模版类别（template category）： 提示词模版按产出媒体的分组：文本生成、资产图、分镜图、视频；无槽位的画风提示词单列为画风一组。 Avoid: 用创作类型或生成模式当类别。
模版片段（partial）： 供提示词模版引用的一段措辞，或是跨模版共享的，或是单个模版按源文件类型、资产类型等轴拆出的命名变体，模版按轴值引用；只被一个模版引用的固定措辞不做片段。 Avoid: 规则常量、prompt_rules、用条件分支在模版内切换轴值。
负向提示词（negative prompt）：
按产出媒体共享的排除项片段，图像与视频各一份，以提示词正文里的 Avoid: 行渲染；只有 ComfyUI 端点把它从正文拆出填入负向提示词的节点绑定，其余通道都不是供应商参数；生成环节只能追加专属排除项，不得另起措辞。
Avoid: 反向词表、negative_prompt 参数、各环节自写的禁止清单。
模版正文（template body）： 提示词模版去掉元数据之后的那份带槽位与片段引用的文本，是系统设置页展示与编辑的对象；它既不是项目的源文，也不是渲染后的实发提示词。 Avoid: 源文（那是项目的叙事文本）、源码、把它叫作预览。
内容确认（review gate）： 脚本内容已经整理完成、正在等待创作者确认的制作步骤名；确认即把脚本规划转为正式脚本，此后脚本规划只读。 Avoid: 审核 gate、门禁、pending。
待编写（pending authoring）： 正式脚本中视觉层尚未补出的视频单元的状态；由内容确认的转换与不带视觉层的手动新增置位，提示词编写完成或手写齐视觉层后清除。 Avoid: 待生成、缺提示词、pending。
待修复草稿（invalid draft）： 生成结果未满足内容约束、需要修正后才能继续使用的草稿；已有正式内容不受它影响，草稿在场期间，内容确认与生成入口一律拒绝继续。创作者可以直接改它，每次保存都重新校验，违约清零即采用为正式内容；也可以交给 AI 修复、重新生成（替换整份草稿）或丢弃。 Avoid: 隔离草稿、违约产物、quarantine。
AI 修复（draft repair）： 由 AI 修正待修复草稿中违约所在的条目，其余条目原样保留；违约落在整集层面时才整份修改。修完照常校验，违约清零即采用，否则仍是待修复草稿。 Avoid: 重新生成、重抽、自动修复。
可编辑草稿（editable draft）： 从正式内容取回、供 Agent 修改并重新校验的草稿；它可以没有任何违约。草稿在场期间的阻断与待修复草稿相同；创作者不直接编辑它，只能交给 Agent 完成或丢弃。 Avoid: 隔离草稿、待修复草稿。
软违约（soft violation）： 不阻断落盘、不进待修复草稿判定，但须随产物一并呈现的降级结论（如「角色没配参考音频」「本单元没引用场景」）；对 Agent 与创作者以「降级提示」成文。 Avoid: 与违约混为一谈、把它算进待修复草稿的违约条目。
需要重新规划（needs_replan）： 正式脚本中一个视频单元的状态：其内容已不能直接生成（如台词与画外音混在一起、缺正文或时长），须回到规划层改写。 Avoid: 待编写、待修复草稿、失效。
分集账本（episode ledger）：
记录每一集的身份与其集原文来源的账本，是分集的唯一真相源：切自整本源文的集记原文范围，自带原文或没有原文的集不占用整本源文；切自整本源文的集的分集文件是账本的派生物，自带原文的集文件就是该集的源文（见 docs/adr/0031）。
Avoid: 绕过账本、以物理集文件的存在性推断分集状态或集数、把不带原文范围的集当作异常条目。
播出顺序（episode order）：
项目内所有集排成的唯一序列，即分集账本中条目的先后；创作者以标题和一集在其中的位置认集（见 docs/adr/0096）。
Avoid: 集号、按集号排序、按集的来源分成多条编号线。
整本源文（whole source）：
分集规划从中切出集的叙事原文，由一个或多个文件按创作者排定的顺序接成；文件的先后是整本源文的一部分，不由文件名决定，文件边界也不是集的边界（见 docs/adr/0097）。
Avoid: 按文件名排序认定文件先后、把一个文件当作一集或一批集的容器。
集原文（episode source）：
一集据以规划脚本的原文，按来源分三种：切自整本源文（由分集规划切出一段范围），自带原文（创作者逐集上传或直接填写的一份原文），无原文（此时不经脚本规划，除广告/短片外只能手写脚本）（见 docs/adr/0031）。
Avoid: 预拆分例外、手动预拆分（作为特例称呼）、分集文件（指称内容时）。
未切分的原文（unsplit source）： 整本源文中不属于任何集的部分：最后一个切出集之后尚未规划的原文，以及第一个切出集之前、切出集之间的空段（删除切出集、插入新文件或删改原文后留下）。 Avoid: 缺口、跳过的原文、剩余原文。
集规划状态（ledger_status）：
一集在分集账本里的三态生命周期：planned（已规划、尚无下游产物）/ consumed（已有下游产物）/ stale（规划或下游产物与原文错位：范围内的原文被删改，或已有产物的集原文范围被手工切分改动、在重新规划中被替换下来）。
Avoid: 与产物时效的 stale 混为一谈、与制作状态混为一谈——它只说规划与产物的关系，不说做到哪一步。
附加指令（instructions）： 创作者为一次规划或生成附加的额外要求，只在该次操作中生效；反复提出的同一要求由 Agent 记忆承载为偏好。 Avoid: 指令、用户意见、附加说明、常驻偏好、创作要求、prompt。
分集规划（plan）：
从整本源文切出集的行为，有两种做法：AI 规划由服务端逐段读取源文，一次规划出其中所有剧情弧完整的集（标题、钩子、原文范围）；手工切分由创作者在源文上直接划定集的边界。两种做法切出的集同属「切自整本源文」，受同一套连续性与重新规划规则约束（见 docs/adr/0032）。
Avoid: 让主 Agent 自行读原文选切分点、把手工切分当作分集规划之外的另一种集原文来源。
重新规划（replan）：
由 AI 从某一集起重新规划、替换现有切自整本源文的集：AI 先产出候选规划，分集账本不动；创作者看过候选的集与变更摘要后采纳，才一次性替换，放弃则什么都不变。整本源文被改动不要求重新规划。创作者亲手调整边界、拆分合并或移除切分属于手工切分，直接写入账本，不经候选（见 docs/adr/0032）。
Avoid: 先重置再规划、把重置当作面向创作者的动作、把手工切分称作重新规划。
重置分集规划（reset_episode_planning）：
把分集账本中切自整本源文的集退回未规划状态的底层操作，分全量重置与保留指定集之前条目的部分重置两种；自带原文或没有原文的集不受重置影响（见 docs/adr/0032）。面向创作者的调整入口是重新规划。
Avoid: 把重置当删除。
产物（artifact）： 一次生成或渲染落到项目里的正式文件——资产图、脚本、分镜图、视频、旁白配音、成片、剪映草稿等——连同它与生成依据之间的关系。 Avoid: 与商品混淆、用「文件存在」代替「产物存在」。
产物清单（artifact_manifest）：
登记每件正式产物的身份、位置与生成依据摘要的单一真相源；视频与音频条目还记下登记时正式文件自身的内容指纹、字节数与纳秒修改时间，这些是写入时的事实，不是时效结论。产物是否存在、是否与当前内容一致，一律问清单（见 docs/adr/0062）。
Avoid: 扫目录或读脚本路径串判断产物存在。
生成依据（artifact basis）：
决定一件产物内容的那组输入的规范描述：提示词、画风、画布比例、按装配序排列的完整参考图集（每张记逻辑身份与内容指纹）等；供应商、模型、分辨率、种子这类请求参数不算在内。产物落地时写进清单的是登记依据，判定时效时按项目现状重算的是期望依据，两者一致即 current（见 docs/adr/0062）。用户提供的产物（上传的资产图、分镜图、视频）与从资产库应用到项目的资产图、衍生资产图是成品，在该版本仍被选中且字节未变时按图本身登记：依据只由字节决定，提示词、描述、画风与本体资产图不参与；改选生成版本或文件被外部替换后，回到按生成输入判定。
Avoid: basis、provenance 与中文术语混用；把实发的裁剪后子集当作依据；把供应商请求参数算进依据；把用户上传或从资产库应用的产物当作按当前内容生成的。
生成输入（generation input）：
一个生成环节为一个目标按项目现状装配的内容输入：语义提示词、画风、画布比例与按装配序排列的完整参考图集；生成依据由它算出（见 docs/adr/0062）。
Avoid: 把裁剪、提示词渲染与供应商参数算进生成输入；执行与时效判定各自装配参考图。
生成缺口（input gap）：
生成输入里缺的一项，如描述为空、引用的资产没有资产图（见 docs/adr/0098）。
Avoid: 生成输入不成立；与产物时效的 missing 混淆。
产物时效（artifact currency）：
清单条目相对当前内容的四态判定：current（一致）/ stale（比当前内容旧但仍可用）/ missing（应有而没有）/ blocked（读不出或依据不可用）；stale 仍可查看、参与成片与导出（见 docs/adr/0062）。
Avoid: 用「已过期」表述 stale、与 ledger_status 的 stale 混为一谈。
补录（backfill）：
项目迁移或归档导入时，把项目里已有的正式产物写进产物清单的动作（见 docs/adr/0062、docs/adr/0098）。
Avoid: 与成本归属的「回填」混淆、认领。
项目迁移（project migration）：
应用启动或归档导入时把一个项目目录从旧 schema 版本逐级改写到当前版本的过程，每级一步、幂等、单项目失败隔离（见 docs/adr/0022）。
Avoid: 与数据库的 alembic 迁移混称、把它当重对账入口。
迁移报告（migration report）：
一次项目迁移或归档导入后留在项目内的持久记录，列出这次迁移改变与丢失的内容（见 docs/adr/0098）。
Avoid: 与迁移失败判定混淆、只写进日志。
迁移失败判定（migration verdict）： 一次 schema 迁移没跑完时对该项目留下的持久裁决，携带原样失败原因与结构化明细；裁决在则该项目「需要修复」，生成入口一律拒绝、项目仍可打开。 Avoid: 把它当一次性通知、用它阻断只读查看。
制作状态（workflow status）：
以清单口径对项目及一个目标集的权威判定：各类内容与产物的现状、每个 AI 操作此刻能否执行及不能执行的原因、建议的下一步；阻断项只表示项目整体不可用（见 docs/adr/0091）。它是唯一状态口径。
Avoid: 并存另一套按文件存在性统计的阶段/进度；把流水线位置当作操作前提。
制作计划（workflow plan）： 制作状态之上的步骤视图，每步陈述该类内容的现状、可执行的操作、涉及的产物与问题；步骤顺序只用于呈现，不构成前提；服务端权威生成，Web 与 Agent 消费同一份。 Avoid: Agent 自行按文件推断下一步。
项目摘要（project summary）：
制作状态的跨集聚合投影，供项目列表与剧集卡使用：集进度、可用资产计数、每集可用产物计数与脚本状态。产物判定有两种口径：verified 逐件做产物时效比对，供单个项目的详情与剧集卡；registered 只看清单登记与文件在场、不读产物内容、产物比对不产生 stale（重规划壳的 stale 标记两种口径相同），供项目列表。两者都以清单为准，不扫目录。
Avoid: 用它替代目标集的制作状态、把 registered 口径当成按文件存在性统计、给多集项目标一个统一的「所在阶段」。
剪辑时间线（edit timeline）： 一集的一套具名剪辑决策：由剪辑片段排成的主轨、片段之间的转场、旁白与字幕、BGM 轨；是由它渲染出的成片与剪映草稿的唯一真相源。一集可以有多条剪辑时间线，彼此独立修改；它不随脚本变化自动更新。剪辑时间线是正式内容，不是产物。 Avoid: 裸称「时间线」（已指调用记录与对话时间线）、剪辑方案、把剪辑时间线当作产物。
剪辑片段（clip）： 剪辑时间线主轨上的一格：某个视频单元在入点与出点之间的一段画面，一律取该视频单元的 current 视频版本，挑版本即改 current。一个视频单元可以对应多个剪辑片段，也可以不进入某条剪辑时间线。 Avoid: 裸称「片段」（已指模版片段）、把剪辑片段与视频单元混为一谈。
剪辑（edit）： Agent 或创作者修改剪辑时间线的动作；不含把时间线渲染成文件。 Avoid: 把渲染、合成、导出称作剪辑。
联系表（contact sheet）： 从一个视频版本中抽出若干帧、拼成一张并标注视频单元 ID 与各帧时刻的图片，供 Agent 看图审阅素材。随工具结果返回，不落盘，不是产物。抽帧保证每个镜头至少一帧，并在视频信号附近加密。 Avoid: 缩略图、宫格（已指宫格分镜）。
视频信号（video signal）： 随包 ffmpeg 在本地为一个视频版本算出的三类机器检查结果：黑屏段、卡帧段、镜头切换点。黑屏段与卡帧段是疑似缺陷，镜头切换点是结构信息；信号只作提示，不自动裁切或废弃素材。第一次被看时才计算，按视频版本缓存，不接入生成链路。 Avoid: 质检结果、缺陷检测（切换点不是缺陷）。
审片子智能体（review-footage）： 替主 Agent 看一组视频单元的联系表、回文字审片报告的只读子智能体，用于首轮全量审阅与重新生成后的新旧版本比较。只能看素材和读项目文件，联系表只留在它的上下文里。 Avoid: 质检 Agent、让审片子智能体直接改剪辑时间线或挑版本。
勾选清单（checklist）： 一轮剪辑结束时，用 AskUserQuestion 多选交给创作者一次确认的待决定事项：重新生成哪些视频单元（附预检得出的预计费用与档位）、改写哪些画外音。勾选即授权，执行时不再追问。 Avoid: 逐条询问付费动作、把挑版本放进勾选清单（挑版本不必确认）。
成片（final cut）： 由一条剪辑时间线渲染出的一集视频文件，是产物，按产物时效判定是否与剪辑时间线一致。 Avoid: 合成视频、最终视频、把单个视频单元的视频称作成片。
剪映草稿（JianYing draft）： 剪辑时间线的一种导出形态，交给剪映继续精修；书面与界面一律称「剪映草稿」，不单称「草稿」。 Avoid: 草稿（已指脚本流程里的待修复草稿与可编辑草稿）、剪辑草稿。
字幕草稿（subtitle draft）：
按视频单元、由台词与画外音文字机械生成的一组定时字幕，是产物，不宣称与声音逐句对齐（切分与计时规则见 docs/adr/0089）。它是剪辑时间线上字幕文字的唯一来源：剪辑时间线只决定字幕落在哪里，不改字、不删条，改字回脚本。
Avoid: 把剪辑时间线上的字幕当作可以单独编辑的文本；单称「草稿」。
ArcReel Agent： 在 ArcReel 中理解创作者要求、协助组织内容并调用创作能力完成工作的对话式 AI。中文产品命名写「ArcReel Agent」；其他中文说明可写「Agent」或「智能体」。 Avoid: 助手、创作助手、Copilot。
外部 Agent 接入（external Agent integration）： 把运行在 ArcReel 之外的受信任 Agent 连接到 ArcReel 的过程，包括安装公开 skills、配置远程 MCP 与 API Key，并验证连通。 Avoid: 仅称为 skills 安装、与 ArcReel Agent 配置混为一谈。
Agent 工具集（Agent toolset）： ArcReel 向 ArcReel Agent 与外部 Agent 提供的同一套创作工具。两类 Agent 调用同一个工具，得到同样的能力与结果，也受同样的迁移失败判定约束；差别只在两处：操作某个项目时，ArcReel Agent 的项目由所在会话决定，外部 Agent 每次指明项目；提交生成任务时，ArcReel Agent 等到任务结束才拿到结果，外部 Agent 先拿到提交回执、之后自行查询结果。 Avoid: 工具目录、MCP 工具列表、工具注册表、sdk tools。
子智能体（subagent）： Agent 为实现一个聚焦目标而委派的一段工作，运行时由下级 Agent 执行；主对话只展示其目标、状态和结果。 Avoid: 子任务、子 Agent。
SessionActor：
每个 Agent 会话专属的执行体，串行化该会话对 SDK 的所有调用（见 docs/adr/0028）。
Avoid: 与 ManagedSession 混为一谈。
自主轮次（autonomous turn）： Agent 会话在一轮结束后、没有收到用户消息时自行开启的新一轮，典型来源是后台子智能体完成后 CLI 注入的任务通知；会话因此从 idle 回到 running。 Avoid: 把 result 当作会话不再产出消息的信号。
排队消息（queued message）： 用户已发出、Agent 尚未接纳进对话的消息；被接纳时才成为对话时间线上的用户消息，位置取它实际进入对话的时刻。 Avoid: 把排队消息当作已发生的对话、按发送时刻排定它在时间线上的位置；把接纳称为「受理」（与 AI 操作的准入混淆）。
立即发送（send now）： 让一条排队消息打断当前轮、先于其他排队消息被接纳的动作；被打断的那一轮与用户主动停止一样记为中断。 Avoid: 引导、插队。
Agent 启动失败（agent_startup_failure）： Agent 尚未建立可用运行环境时发生的系统故障，位于任何对话轮次之前。 Avoid: 与 Agent 轮次失败混为一谈。
Agent 轮次失败（agent_turn_failure）： Agent 已成功启动后，某一轮未完成的故障终态；它是系统故障事件，不是 Agent 回答。 Avoid: 把 SDK 合成的错误消息作为普通 Agent 回答；把被停止或被立即发送打断的轮次当作轮次失败。
故障观测（failure_observation）： ArcReel 在一次 Agent 故障中实际获得的上下文与原始故障事实；它是排障证据，不是根因结论。 Avoid: 把未识别事实归一成"未知错误"。
Agent 记忆（agent memory）：
Agent 跨会话持久保存、自主写入并可由创作者查看修改的关于创作者与项目的自然语言笔记，形态为一份逐行索引加按需读取的主题文件；只记 Agent 无法从项目数据或指令文件推出、且未来会话仍有用的偏好、纠正、决策与外部线索，分项目记忆与用户记忆两级。
Avoid: 把项目正式数据、SDK transcript / 会话事件日志、附加指令或制作进度当作记忆；把 CLAUDE.<mode>.md 这类人写的指令文件叫作记忆。
项目记忆（project memory）： 随项目走的 Agent 记忆，只在该项目的会话中生效，承载该项目的风格取向、被确认的做法与创作者对本项目的纠正。 Avoid: 跨项目复用；写进项目正式数据；与项目设置混为一谈。
用户记忆（user memory）： 按用户归属、对该用户所有项目生效的 Agent 记忆，承载创作者的身份背景与长期工作偏好。 Avoid: 绑定服务实例或宿主目录；写入只对某一个项目成立的内容。
项目私有区（project private area）： 项目目录内由 ArcReel 运行时自行维护、不属于项目正式数据的落盘区，承载项目记忆这类「随项目目录、不随归档」的内容；不入归档、不入数据校验，也不随 Agent 运行 profile 的物化与重置一起被清掉。 Avoid: 把它与 profile 物化目录混为一谈；把其中内容当作正式数据导出或校验。
SDK transcript： SDK 按自身协议写入的会话记录，唯一职责是供 SDK 重建 Agent 上下文。 Avoid: 把 transcript 当 UI 对话时间线的数据源。
会话事件日志（session event log）： 对话时间线的唯一读源：每个会话一条有序事件序列，是 SDK transcript 的物化视图。 Avoid: 把它当第二真相源与 transcript 对账。
消息改写（message rewrite）： 用户对已发出的某条历史用户消息的编辑-重跑动作：等同于回到该消息发出前用改写后的内容重新发出，原消息及其后的全部对话随之废弃。 Avoid: 与图片编辑的「编辑」混称。
分支会话（session branch）：
承接一次消息改写的新会话：改写点之前的对话前缀成为新会话的全部历史，原会话保留为不可见备份（见 docs/adr/0058）。
Avoid: 与 SDK 原生 fork_session 混为一谈。
子时间线（subagent timeline）： 同一会话内属于同一个子智能体的消息序列，主时间线上只呈现一张可折叠的子智能体卡片。 Avoid: 把子智能体消息平铺进主时间线。
Agent 运行 profile（agent_runtime_profile）： Agent 专属的运行态配置树，与开发者本地的编辑器配置物理分离，运行时物化进各项目目录。 Avoid: 用「.claude」笼统指代、称为 agent config。
profile 物化（materialization）： 把 Agent 运行 profile 落盘进某个项目目录的过程，按该项目的创作类型选定变体。 Avoid: 用「同步 / 复制」泛指。
Agent 沙箱（agent_sandbox）：
Agent 工具调用外围的内核级隔离层，约束沙箱内所有子进程的文件读写与网络（见 docs/adr/0025、docs/adr/0026）。
Avoid: 用「沙箱」泛指应用层路径围栏 hook。
AgentAccessPolicy：
「Agent 能碰什么」的单一规则来源，同一份规则为内核沙箱与应用层围栏各做一种投影（见 docs/adr/0046）。
Avoid: SandboxPolicy。
会话 JWT（session JWT）： 交互式登录签发的管理员凭证，通常可访问 ArcReel 的全部管理能力；泄漏视为完整管理员身份失陷。 Avoid: 把所有 bearer token 都叫 API Key。
API Key： 面向自动化访问的广泛权限凭证，可访问绝大多数业务与配置能力，但无权管理 API Key；泄漏仍属于高影响安全事件。界面称「访问令牌」（英文 Access tokens），与媒体供应商下的「密钥」区分签发方向。 Avoid: 与会话 JWT 完全等同、scoped token；界面上称「API 令牌」「API 密钥」。
下载 token（download token）：
为项目导出签发的短时效凭证，只对导出端点有效，是自带认证端点目前唯一的凭证形态（见 docs/adr/0071）。
Avoid: 把它称为一次性或低权限凭证；把会话 JWT 放进任何 URL。
浏览器原生请求（browser-native request）：
由浏览器自身发起、无法携带 Authorization header 的请求，只有 <img> / <video> 的 src 加载与原生下载导航两类；静态媒体匿名可读与下载 token 的存在都以它为成因。
Avoid: 浏览器直发请求；把 SSE 归入此类——事件流是普通的带凭证 API 请求（见 docs/adr/0071）。
自带认证端点（self-authenticated endpoint）： 不依赖登录会话、在端点内部自行校验专用凭证的端点，成因一律是浏览器原生请求；它与公开端点同样不要求登录，但拦得住匿名请求。 Avoid: 与公开端点混为一谈。
编辑单元（edit unit）：
一次显式保存所提交的界面范围，如一个设置视图、一张资产、一个分镜详情、一个记忆文件。单元内的字段先进入未保存修改，由单元统一保存或放弃；离开或切换前有未保存修改时，先询问继续编辑、放弃修改还是保存。上传、生成、改名、删除这类动作不进入编辑单元，立即执行。结构与离开拦截见 website/docs/dev/architecture.md「编辑单元与离开拦截」。
Avoid: 编辑模式、按字段即时保存。
未保存修改（unsaved changes）： 编辑单元里尚未提交的本地编辑。期间已保存内容被 Agent 改写或推送更新时，未保存修改保留，由创作者选择采用新内容或坚持保存（后写者生效）。 Avoid: 单称「草稿」（已指待修复草稿与可编辑草稿）、本地草稿。
宽窗口（wide window）： CSS 视口宽度大（如 1920、2560 逻辑宽度）引起的布局问题，与像素密度无关。 Avoid: 大屏、高分屏、高 DPI。