Talking Avatar Video 技能用于在 Claude Code、Codex、OpenClaw 等智能体运行环境中，把一张人像图片和一段短脚本生成为说话头像视频。生成工作由托管的付费服务 Beatra（mcp.beatra.ai）完成，本目录条目只是经过审核的指针，不是可执行包本身，不包含客户端代码，也不会自行执行任何 Beatra 操作。
用途与主要能力：面向明确希望在 Beatra 上生成 Talking Avatar Video 并接受付费的用户，以及同意将提示词和参考媒体发送给第三方的场景；不适用于本地或离线视频编辑、时间线剪辑。所指包为 talking-avatar-video 0.3.0，源码提交 03e427c1220ef7efcfee083b37f4f31aa98311ab，包树 ID 为 e44d57ecf111824bd4081ff26c9f6e7b4b3bd0d2，许可为 MIT-0。固定树中只有常规文件，无符号链接、可执行位或二进制文件。包内含 SKILL.md、manifest.json、install-source.json、Markdown 参考文档，以及 scripts/authorize.py、scripts/mcp_client.py、scripts/uninstall.py，均为仅使用 Python 标准库的 Python 3.10+ 脚本，无依赖安装、无生命周期钩子、无自更新器。
使用方式：安装需分步进行并多次取得批准。第一步，说明将从 github.com 获取外部包并征得同意后，用 umask 077、mktemp 创建审查目录，克隆 beatra-ai/talking-avatar-video-skill 并检出指定提交的 skills/talking-avatar-video，校验树 ID 输出 TREE-OK，否则停止。第二步，检查是否存在非 100644 条目，并确认 mcp_client.py 中不再出现 maybe_auto_update、download_update、_apply_update 等自更新入口，向用户报告审查结果及网络、凭据、本地状态、遥测和版本通知行为。第三步，再次单独征得同意后，将审查过的树复制到宿主技能目录（如 ~/.claude/skills/talking-avatar-video），目标已存在则停止。第四步，单独决定是否授权：运行 authorize.py 打开浏览器登录并存储 bearer token，若宿主仅在启动时发现技能则需新开会话。使用时应先阅读已安装包的 SKILL.md 及其参考文档，先做免费不计费的发现调用（beatra.models.list、任务列表）获取模型卡和积分估算；对每次付费调用展示仅含一个调用的费用卡片（工具、模型、估算、将上传的文件），等待明确批准后才上传用户批准的文件，并以稳定的 client_request_id 提交一次并轮询任务；报告交付物和 billing.net_charged_credits，任何后续付费阶段前再次征得同意。免费连接检查可运行 mcp_client.py verify。
更新与卸载：该固定版本不能自更新，没有下载或替换包文件的代码；update 只报告安装来源提供的更新，按上述步骤安装的副本通常找不到记录，需按安装方式更新。升级应在新的审查目录中对新提交重复前三步，展示与已安装副本的文件级差异并获批准后替换。卸载先运行 uninstall.py --dry-run 再正式运行，读取 JSON 决策：disconnected 表示设备上最后一个 Beatra 技能，令牌被撤销（revoked 为 true 时）并删除 ~/.beatra 下若干状态文件；keep_connection 表示其他技能仍共用令牌；revoke_retry 表示服务端拒绝撤销、需稍后重试。脚本不删除包目录，确认路径后由用户删除；不删除 ~/.beatra/updates/，在 disconnected 且无其他技能时可依次删除该目录和空 ~/.beatra。未能撤销的令牌在闲置 15 天后过期，也可在 Beatra Console 的 Agents 中立即撤销。
适用场景与限制：需要 Beatra 账户、网络访问、Python 3.10+ 和预付积分；模型、价格、模式和可用性由 Beatra 及其上游模型提供商控制并可能变化，服务按现状提供；输出具有概率性，不保证唯一或不侵权，发布前需人工审核；本条目只审查上述固定树，更新版本属于另一次审查。安全方面风险等级为 critical：所有请求均为 HTTPS 并拒绝重定向，授权走 api.beatra.ai、工具调用走 mcp.beatra.ai，上传是不带 bearer token 的 PUT；除非缓存决策仍有效，每次运行会先请求 skill-route 决定使用 .ai 还是 .cn 网络，可用 network --use ai 固定 .ai 主机；版本通知只读检查其他安装器留下的记录，最多每 24 小时一次，有记录时读取 sources.json 并仅在 stderr 打印一行更新命令，从不执行；提示词和上传媒体会发送给 Beatra 及执行任务的第三方模型提供商；付费工具消耗预付积分，因 Beatra 或上游原因失败的任务积分自动退回，否则购买不可退款，实际用量可能超出估算并产生负余额；authorize.py 通过 OAuth 设备流程将单个 bearer token 存于 ~/.beatra/credentials.json（目录 0700、文件 0600），令牌具有完整 Beatra 权限包括 wallet:spend，闲置 15 天滑动过期并在设备上所有 Beatra 技能间共享，不得打印、粘贴或移出该文件；本地状态还包括 installation.json、host.json、skills.json、network.json、balance-holds.json 等；授权会发送主机名、包标识与版本、检测到的智能体平台和安装引用，连接后每天最多一次不计费的 installations.register 调用并附带粗略运行时信息，且无法选择退出；账户数据在账户存续期间保留，任务记录、产物和计费账本在账户关闭后仍为审计和税务保留；用户保留对输入的权利并获得 Beatra 对输出的权利，必须对上传媒体拥有权利且不得制造欺骗性冒充。