用途
Beatra 是一个 AI 媒体生成技能（Agent Skill），用于在 Claude Code、Codex、OpenClaw 等智能体平台中，通过托管的付费服务 Beatra（mcp.beatra.ai）生成 AI 图像、视频、音乐和配音。当用户希望用一个 Beatra 连接覆盖图像、视频、音乐和语音工作时，可以使用该技能。它不适用于仅本地或离线生成；对于公开社交数据查询，需要用户单独批准该具体查询。
主要能力
- 通过一个技能连接完成图像、视频、音乐和配音的生成任务。
- 提供免费、不计费的发现能力（如 beatra.models.list、任务列表），用于查看当前模型卡和额度估算。
- 支持付费调用：在用户明确批准成本卡后，上传经批准的文件并提交任务，轮询返回的任务，报告交付产物和 billing.net_charged_credits。
- 提供连接验证（verify）、网络路由选择（network --use ai）、余额重查（--recheck-balance）等操作。
- 提供卸载脚本，可安全撤销令牌并清理本地状态。
使用方式
该目录条目本身是经过审查的指针，不是可执行包，不包含客户端代码，也不会自行执行任何 Beatra 操作。安装需经过两次审批：
- 拉取固定代码树到审查目录：使用 git clone 并 checkout 指定提交 26a5f7963aca434c2cbced911a2914e3224c2107 下的 skills/beatra，并校验树 ID 为 f35935ef2d28c325c60471f6f0934ae1800fd1b0，输出 TREE-OK 才继续。
- 激活前检查：确认没有符号链接、可执行位或子模块条目，并确认不存在自更新器入口（maybe_auto_update、download_update、_apply_update）。
- 复制到宿主技能目录（如 $HOME/.claude/skills/beatra），需第二次单独审批。
- 单独授权：运行 scripts/authorize.py，打开浏览器登录并存储 bearer token。
工作流程：先读取已安装包的 SKILL.md 及其引用，了解路由、载荷结构和审查循环；使用免费发现接口查看模型卡和额度估算；针对单次付费调用展示成本卡（工具、模型、估算、将上传的文件），等待用户明确批准；仅上传用户提供并批准的文件，使用稳定的 client_request_id 提交一次并轮询任务；报告交付产物和实际扣费，与用户一起审查结果，任何后续付费阶段前再次询问。
更新：该固定版本无法自更新，没有下载或替换包文件的代码。要升级需在新审查目录中重复步骤 1 至 3，向用户展示与已安装副本的文件级差异，经批准后替换目录。
卸载：运行 scripts/uninstall.py --dry-run 和 scripts/uninstall.py，读取 JSON 决策。disconnected 表示这是设备上最后一个 Beatra 技能，令牌被撤销且 ~/.beatra 下的相关文件被移除；keep_connection 表示其他 Beatra 技能仍在使用共享令牌；revoke_retry 表示服务器拒绝撤销，需稍后重试。脚本不会删除包目录，确认路径后需手动删除。
适用场景
- 需要在智能体平台中统一调用图像、视频、音乐和配音生成能力。
- 愿意使用托管的付费 Beatra 服务，并接受按次审批和预付额度模式。
- 需要可审查、固定版本、无自更新行为的技能包。
限制
- 需要 Beatra 账户、网络访问、Python 3.10+ 和预付额度。
- 模型、价格、模式和可用性由 Beatra 及其上游模型提供商控制，可能变化；服务按现状提供。
- 输出具有概率性，不保证唯一或不侵权，发布前需人工审核。
- 该目录条目仅审查上述固定代码树，更新版本属于另一次审查。
- 付费工具消耗预付额度；因 Beatra 或上游模型原因失败的任务额度会自动返还，否则购买不可退款，实际用量可能超过估算并导致负余额。
- 凭据方面：authorize.py 使用 OAuth 设备流，将 bearer token 存储在 ~/.beatra/credentials.json（目录 0700，文件 0600），令牌具有完整 Beatra 范围（包括 wallet:spend），15 天滑动空闲生命周期，由设备上所有 Beatra 技能共享。
- 网络方面：所有请求为 HTTPS 并拒绝重定向；授权使用 api.beatra.ai，工具调用使用 mcp.beatra.ai；上传为 PUT 到服务器返回的 HTTPS 地址，不带 bearer token。除非缓存决策仍有效（10 分钟至 7 天），每次运行会先询问 api.beatra.ai/skill-route，必要时也询问 api.beatra.cn/skill-route 以决定使用哪个网络。
- 遥测方面：授权时发送主机名、包 slug 和版本、检测到的智能体平台、安装引用；连接后最多每天一次进行非计费的 beatra.installations.register 调用，包含包和平台字段、发布渠道、网络路由、安装来源及粗略运行时信息（操作系统及版本、CPU 架构、Python 版本、区域设置、UTC 偏移）。这些字段没有退出选项。
- 保留策略：账户数据在账户生命周期内保留；任务记录、产物和计费账本在账户关闭后为审计和税务目的保留。
- 内容权利：用户保留其输入的权利，并获得 Beatra 在输出中的权利；用户必须拥有上传媒体的权利，且不得创建欺骗性模仿。