AI Podcast Voiceover 是一个智能体技能,用于把文章、笔记或已完成的脚本转成单人播客单集,产出具有一致主播音色、自然节奏和发音控制的 MP3,可在 Claude Code、Codex 或 OpenClaw 内使用。实际合成工作在托管且付费的 Beatra 服务(mcp.beatra.ai)上完成。
用途
当用户明确希望在 Beatra 上生成 AI Podcast Voiceover 音频并接受其付费性质时使用。当用户同意将脚本发送给第三方进行托管合成时使用。不适用于本地 TTS,也不适用于未批准付费合成的情况。
主要能力
该技能包指向的固定版本为 ai-podcast-voiceover 0.2.5,来源提交为 beatra-ai/ai-podcast-voiceover-skill@0fe5c52(完整 SHA 0fe5c523fc42754ba8d328e2db4df895a6276ee3),包树 ID 为 3e9432060beedd7f2592804bc928fb26b595e2fd,许可证为 MIT No Attribution (MIT-0)。固定树中只包含常规文件,没有符号链接、可执行位或二进制文件。包内捆绑三个仅使用标准库的 Python 脚本(authorize.py、mcp_client.py、uninstall.py),要求 Python 3.10+,不安装依赖,没有生命周期钩子。该版本没有自更新器:它从不下载代码,也从不更改自身文件。
使用方式
安装需经过固定、验证和两次批准。第一步:将固定树拉取到审查目录,需先说明会从 github.com 获取外部包并请求批准,然后执行 git clone 与 checkout,并校验树 ID 是否输出 TREE-OK,否则停止。第二步:激活前检查,确认没有符号链接、可执行文件或子模块条目,并确认没有自更新器入口点,然后向用户报告审查发现。第三步:复制到宿主技能目录,需第二次单独批准,因为这会更改智能体配置。第四步:授权作为独立决定,运行 authorize.py 会打开浏览器登录并存储 bearer token,需先询问。
工作流程上,先阅读已安装包的 SKILL.md 及其引用,它们定义路由、载荷结构和审查循环。先使用免费、不计费的发现调用(beatra.models.list、任务列表)读取当前模型卡和积分估算。向用户展示恰好一次付费调用的成本卡:工具、模型、估算和将上传哪些文件,等待明确批准;规划或“直接做”不算批准。只上传用户提供并为此任务批准的文件,然后用稳定的 client_request_id 提交一次并轮询返回的任务。报告交付的产物和 billing.net_charged_credits,与用户一起审查结果,任何后续付费阶段前再次询问。
更新与卸载
该固定版本无法自更新。要迁移到更新版本,需在新审查目录中重复步骤 1 到 3,向用户展示相对于已安装副本的文件级变更,并在批准后替换目录。未在本条目中列出的版本尚未在此审查。卸载时运行 uninstall.py --dry-run 和 uninstall.py,读取 JSON 决定:disconnected 表示这是设备上最后一个 Beatra 技能,令牌被撤销且 ~/.beatra 下相关文件被移除;keep_connection 表示另一个 Beatra 技能仍使用共享令牌;revoke_retry 表示服务器拒绝撤销且无变化,需稍后重试。脚本从不删除包目录,确认路径后由用户删除。
适用场景
适用于用户明确要求 Beatra 托管付费合成、并同意将脚本发送给第三方的情况。需要 Beatra 账户、网络访问、Python 3.10+ 和预付积分。
限制
模型、价格、模式和可用性由 Beatra 及其上游模型提供商控制,可能变化,服务按原样提供。输出是概率性的,不保证唯一或不侵权,发布前需要人工审核。本条目只审查上述固定树,更新版本属于另一次审查。
安全与安全说明
风险等级 critical 是刻意设定的。网络方面,每个请求都是 HTTPS 并拒绝重定向;授权使用 api.beatra.ai,工具调用发往 mcp.beatra.ai;上传是将批准文件 PUT 到服务器返回的 HTTPS 地址,不带 bearer token。除非缓存决定仍有效(10 分钟到 7 天),每次运行先询问 https://api.beatra.ai/skill-route,当第一个慢或回答 cn 时也询问 https://api.beatra.cn/skill-route,以决定使用哪个网络;这些探测不携带凭证或包身份。当答案为 cn 时,授权和工具调用发往 api.beatra.cn 和 mcp.beatra.cn,使用相同 bearer token,版本通知从 www.beatra.cn 读取。
版本通知方面,该版本没有下载或替换包文件的代码,也不在安装目录内写入。在 verify、tools、upload 或 call 之前,每个安装路径最多每 24 小时记录一次检查时间,并只读地查找其他安装器留在包旁的记录。若找到,会读取 https://beatra.ai/skills/ai-podcast-voiceover/sources.json(无凭证,3 秒超时,64 KiB 上限),若该安装器提供更新版本,则向 stderr 打印一行带其更新命令,但从不运行该命令。
上传与第三方方面,提示和上传的媒体会发送给 Beatra 并转发给执行任务的第三方模型提供商。Beatra 在中国大陆以外运行服务;在 cn 路由下请求通过 Beatra 在中国大陆的主机到达。计费方面,付费工具消耗预付积分;因 Beatra 或上游模型原因失败的任务积分自动返还,否则购买不可退款,实际使用可能超过估算并留下负余额。凭证方面,authorize.py 运行 OAuth 设备流,在批准页打开浏览器,并将一个 bearer token 存储在 ~/.beatra/credentials.json(目录 0700,文件 0600);令牌从不进入 argv、环境变量或输出,携带完整 Beatra 范围包括 wallet:spend,具有滑动 15 天空闲生命周期,并由设备上每个 Beatra 技能共享。
本地状态方面,~/.beatra/ 还保存 installation.json、host.json、skills.json、network.json、balance-holds.json、短期的 .authorize.lock,以及每个安装路径的 updates/<id>/state.json、source.json 和 registration.json。文件为 0600,host.json 除外,它遵循 umask。遥测方面,授权会发送主机名作为设备名、包 slug 和版本、检测到的智能体平台和安装引用;连接后最多每天一次,客户端进行不计费的 beatra.installations.register 调用,包含包和平台字段、发布渠道、网络路由、安装来源和粗略运行时事实;每次工具调用都会添加 source_package_slug 和 source_platform,这些字段没有退出选项。保留方面,账户数据在账户生命周期内保留;任务记录、产物和计费账本在账户关闭后为审计和税务目的保留。内容权利方面,用户保留其输入的权利,并获得 Beatra 在输出中的权利;用户必须持有上传媒体的权利,且不得创建欺骗性模仿。
最佳实践
每次付费调用、每次上传集和每个安装步骤保持一次批准。从终端任务报告净扣费积分,而不是估算值。不要用未审查版本静默替换已安装副本。不要打印、粘贴或将令牌移出 ~/.beatra/credentials.json。在响应不确定后不要用新请求 ID 重试付费调用。
其他资源
固定提交处的源代码树、产品页面、条款和隐私政策。在声称可发布单集之前,请收听完整输出并与批准的脚本对比遗漏、发音、说话者权利和时长。MP3 下载并不授权发布它。