YouTube课文字幕图·字幕转知识点图
把 YouTube 课文讲解字幕，做成每条选定字幕要点一张知识点静帧。交付 4 到 8 张。
适用范围与相邻路线
中小学教师要用公开 YouTube 课文讲解字幕做知识点静帧时，使用本 Skill。
口播重做稿转到 youtube-caption-studio。YouTube 封面转到 youtube-thumbnail-maker。企业培训字幕讲义静帧转到
youtube-train-caption-cards（若已安装）。
本包只读 YouTube 课文讲解字幕并做知识点静帧，不在 YouTube 上发视频。当前连接没有 YouTube 搜索或字幕操作时，只用已经粘贴的原话。
收集字幕
硬输入是：
- 正在做成知识点卡的课文；
- 宿主能打开的公开 YouTube 视频链接或检索词，或已经复制的课文讲解字幕；
- 这包要几张，或允许使用默认 4 张。
复用已知课文名称、学校配色和投放位置。
只补问缺失的硬输入。4 到 8 以外的数量也能做：确认该规模和实时费用。
不要编造字幕行、视频标题、播放量或额外课纲要点。可选的品牌图只作版式参考，不是缺失口播行的来源。拿到文件不等于同意。
查看用户提供的每张静帧。记录 MIME 类型、宽、高、画幅、字节大小和是否有 alpha 通道。本地文件检查后，只通过随包客户端上传
（scripts/mcp_client.py / beatra.assets.upload）。保留返回的产物编号。绝不要把本地路径传给
beatra.images.generate、beatra.images.transform 或
beatra.images.edit。
先做免费槽表
任何付费查找或出图前，先写带标签的字幕到知识点清单。用户没有另报 4 到 8 之间的数量时，默认四个槽位。每个槽位记下字幕原话、由这些字幕写出的印刷知识点行、版式（字幕要点、知识点行、可选页脚）、画布，以及是否用品牌图带版式。
这份清单就是用户已经粘贴内容上的免费可见结果。规划不是批准。
安全默认：
- 每个槽位一次
beatra.images.generate； model: "auto"，除非用户选了实时 SKU；- 每个槽位
count为 1； - 正方形 2K，除非用户点名了别的投放比例。
查找字幕单独一张卡
视频链接或检索词并不等于批准查找。用户要当前连接去读公开 YouTube 课文讲解字幕时，按
lesson caption lookup 先搜索、再检视，然后出示六字段查找卡并等待：
- 做什么 — 为点名的课文读一页公开 YouTube 视频搜索或一条字幕
（beatra.social.execute，使用刚检视到的operation_key）。 - 积分 —
beatra.social.tools.get刚刚返回的实时价格。
引用这个实时数字，不要用记住的数。 - 几笔 — 一次预付查找。视频搜索是一笔。字幕读取是另一笔。语言列表后再取一种语言是另一笔。下一页搜索是另一笔费用。
- 身份 — 每一次 execute 一个新的不透明
client_request_id。 - 若停在这里 — 已粘贴字幕的计划仍然可用。
- 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。用户说已充值之前不要重试。
不要向用户展示 schema_hash。已确认的查找并不批准出图。查找到终态后，报告载荷、任务编号、终态和
billing.net_charged_credits。查找没有模型、画幅或时长可报。
确认出图，再确认可选变换或局部修改
查找和出图是分开的付费阶段。每个阶段各自一张六字段卡，每个槽位各自一个不透明 client_request_id。
出图前，调用 beatra.models.list，能力为 text_to_image：
{"capability": "text_to_image"}
出示出图卡并等待：
- 做什么 — 每个点名槽位一张知识点静帧
（beatra.images.generate）。 - 积分 — 刚读到的
text_to_image价格乘以槽位数。不要复用记忆中的数字。 - 几笔 — 每个槽位一次付费出图。不要把几条字幕要点合成一次
count。 - 身份 — 每个槽位一个新的不透明
client_request_id。 - 若停在这里 — 带标签的槽表仍然可用。
- 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。用户说已充值之前不要重试。
每个出图槽位只通过随包 scripts/mcp_client.py 提交一次。用
beatra.tasks.get 轮询。读取实际图像 MIME、画幅和大小，以及 billing.net_charged_credits。
用户要已接受的卡片贴近一张品牌静帧时，读取当前的 image_to_image 卡片，并在 beatra.images.transform 之前等在单独的变换卡上：
{"capability": "image_to_image"}
只用 beatra.images.edit 在用户接受一张卡并要求局部修正之后，把那张已接受图作为
images[0]。先读取当前的 image_edit 卡片：
{"capability": "image_edit"}
已确认出图并不批准变换或局部修改。
审图、交付与恢复
核对每张静帧是否印出了选定字幕要点，以及是否只印字幕支撑的知识点行。只报告宿主实际看得到的文字。把生成的小字当作审图项，不要当成认证课文证书。每个付费任务到终态后，交付实际字节以及存在的 MIME、画幅和大小，还有 billing.net_charged_credits。不要承诺预付估价就是最终扣费。
拿到 task_id 后轮询该任务。创建响应丢失时，先用 beatra.tasks.list 搜索，再用
beatra.tasks.get 核对，然后再重放。只有参数逐字节相同才能复用原标识。字幕、知识点行、静帧、模型或画布变了就是新卡和新标识。只有用户要求时才取消。
执行
每个远程 Beatra 操作都只通过本包随附的
scripts/mcp_client.py 调用。把 MCP 工具名放在 call 后面，并向标准输入发送一个 JSON 对象。
python3 scripts/mcp_client.py call beatra.models.list
{"capability": "text_to_image"}
python3 scripts/mcp_client.py call beatra.models.list
{"capability": "image_to_image"}
python3 scripts/mcp_client.py call beatra.models.list
{"capability": "image_edit"}
printf '%s' '{"query":"captions","platform":"youtube","capability_family":"captions"}' | python3 scripts/mcp_client.py call beatra.social.tools.search
printf '%s' '{"prompt":"Create the approved knowledge-point still for the named caption point. Print only the caption-backed knowledge-point line.","model":"auto","count":1,"canvas":{"type":"preset","tier":"2K","aspect":"1:1"},"client_request_id":"opaque-lesson-caption-01"}' | python3 scripts/mcp_client.py call beatra.images.generate
不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级。
工具返回积分不足时：把工具返回的原文整段交给用户，链接一个字不改。其余可以译成中文。不要改写成自己的充值说明。引导用户按原文去充值。
账户余额
用户问还剩多少积分，或某次实时估价够不够时，调用 beatra.wallet.get。问已经扣了多少
时，调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把
wallet.get 变成每次付费提交前的必需步骤。
模型卡返回里带 top_up 块时，按卡片给出的档位和顺序原样转述。不要给档位排高低，不要
贬低其中任何一档，也不要替用户挑。选哪一档是用户自己的事，钱包页会把整份清单摆在他
面前。任何时候都不要凭记忆报档位。
按任务查阅的参考
- 槽表、查找、载荷和恢复，读
lesson knowledge-point workflow 和
lesson caption lookup。 - 授权和非计费注册步骤，读
installation and authentication
和 installation registration。 - 共用的任务、计费和连接细节，读 任务与结果、计费、错误与恢复 和 随包 MCP Client 连接诊断。
- 更新保证和控制，读 automatic updates and safety。移除时读 uninstall and disconnect。
运行时与安全的自动更新
随包客户端会在每个安装中静默检查更新，最多每 24 小时一次。发现更高版本时，不另行确认地自动安装。它只从本包、渠道和语言环境固定的官方 Beatra 发现地址和不可变 CDN 路径下载，校验发现信息、压缩包、清单和每个随包文件，并且只替换本包拥有的文件。
更新检查、下载、校验、替换、回滚和恢复失败时会 fail open：当前安装仍可使用，原本请求的命令会继续执行。更新失败绝不构成重试付费查找、出图、变换或局部修改请求的理由。这个设置会在本安装中持续生效。见
automatic updates and safety。
python3 scripts/mcp_client.py update --auto off
python3 scripts/mcp_client.py update --auto on
python3 scripts/mcp_client.py update --check
