用途
该技能用于在 Claude Code、Codex 或 OpenClaw 等智能体环境中，把定稿的手稿或课程文本交给托管的付费服务 Beatra，生成按章节排序的有声书音频。合成时使用单一旁白音色，先产出一个有代表性的样章，之后再做针对性调整。它适用于用户明确想要在 Beatra 上制作有声书或课程旁白，并接受付费以及把稿件发送给第三方进行托管合成的情况。它不适用于本地 TTS、M4B 打包、翻译或母带处理；如果没有获得付费合成授权，也不应使用。
主要能力与包内容
该目录条目是经审核的指向信息，不是可执行包本身，因此它不含客户端代码，也不能单凭这一条目执行 Beatra 操作。它指向的包为 ai-audiobook-narration 0.3.1，固定提交为 beatra-ai/ai-audiobook-generator-skill@4f5f6b5（完整 SHA 4f5f6b5ec10ee989be010c4990a7a087cc3c721c），对应的包树 ID 为 7efde6f4e854ac4da9fde2590f070a561de2856b，许可证为 MIT-0。被固定的目录树中只包含普通文件，不含符号链接、可执行位或二进制文件。包内包含 SKILL.md、manifest.json、install-source.json、捆绑的 Markdown 参考资料，以及 scripts/authorize.py、scripts/mcp_client.py、scripts/uninstall.py；这些脚本需要 Python 3.10+，仅使用标准库，无需安装依赖，也不含生命周期钩子。
安装方式
安装分为四步：获取固定目录树、激活前检查、复制到技能目录，以及单独进行授权。第一步是从 github.com 克隆固定提交，并校验 Git 树哈希；如果输出不是 TREE-OK，就停止。第二步是检查目录树中是否存在非 100644 条目，并扫描是否残留自更新入口；按资料，这两项检查都应无输出。第三步是在用户第二次单独批准后，把审核过的目录复制到宿主机的技能目录（例如 Claude Code 的 ~/.claude/skills/ai-audiobook-narration）；如果目标已存在，则停止并询问用户。第四步是运行 authorize.py，开启浏览器登录，并把 bearer token 存入 ~/.beatra/credentials.json。资料强调，哈希或 grep 结果只能作为清单辅助，不等于完成源码审查；激活前应阅读固定目录树中的每个文件。
使用流程
先进行免费、不计费的发现调用（如 beatra.models.list、任务列表），读取当前模型卡片与额度估算。然后针对一次确切的付费调用向用户展示费用卡：工具、模型、估算值以及将上传的文件，并等待明确批准。仅上传用户提供且批准的文件，使用稳定的 client_request_id 提交一次并轮询任务。交付后报告产物与 billing.net_charged_credits，与用户复核；后续付费阶段需再次征得同意。资料给出的免费连接检查命令为 python3 ".../scripts/mcp_client.py" verify。
适用场景与限制
适用场景包括：把定稿手稿转为多章有声书；把课程文本转为按顺序排列的旁白音频；先试听样章再集中调整；在旁白来自样本克隆时，需取得说话人或权利人的同意与授权。限制包括：需要 Beatra 账户、网络访问、Python 3.10+ 和预付额度；模型、价格、模式与可用性由 Beatra 及上游提供商控制，可能变化，服务按现状提供；输出具有概率性，不保证唯一或非侵权，发布前需人工复核；该条目只审核了上述固定目录树，更新版本属于另一次审核。
安全与卸载要点
网络请求全部使用 HTTPS 并拒绝重定向；授权走 api.beatra.ai，工具调用走 mcp.beatra.ai；上传是对服务器返回的 HTTPS 地址执行一次 PUT，且不携带 bearer token。路由探测会请求 api.beatra.ai/skill-route，必要时请求 api.beatra.cn/skill-route，探测不携带凭据。该版本无自更新代码，但会在最多每 24 小时一次的情况下，只读检查其他安装器留下的记录，并在发现新版本时于 stderr 打印一行更新命令；它不会执行该命令。凭据保存在 ~/.beatra/credentials.json，目录权限为 0700，文件权限为 0600；token 具有完整 Beatra 作用域（包含 wallet:spend），闲置 15 天过期，并由设备上所有 Beatra 技能共享。遥测字段包括主机名、包 slug 与版本、平台、安装引用、操作系统与版本、CPU 架构、Python 版本、区域设置和 UTC 偏移，没有退出选项。卸载时先运行 --dry-run，再执行；它不会递归删除，也不会删除包目录。若决策为 disconnected，需由用户确认路径后自行删除 $dest；无法撤销的 token 在闲置 15 天后过期，也可在 Beatra Console 的 Agents 中立即撤销。