用途
本条目用于在 Claude Code、Codex 或 OpenClaw 等智能体环境中，调用 Beatra 托管付费服务，把用户提供的照片转换为动漫、漫画、卡通、水彩、黏土或 3D 角色风格图像，并在生成后对整组结果检查相似度与风格一致性，而不是默认这些特征会被保留。
主要能力
- 将照片转换为多种风格的角色艺术图。
- 支持在生成后核查相似度与风格一致性。
- 通过免费、不计费的发现接口读取当前模型卡片与额度估算。
- 每次付费调用前展示成本卡（工具、模型、估算费用、将上传的文件），并等待明确批准。
- 使用稳定的 client_request_id 提交任务并轮询结果，报告实际扣费额度。
使用方式
本条目本身只是经审核的指针，不含客户端代码，也不自行执行任何 Beatra 操作。它指向的包固定在提交 c2d3fbfffd9c0a04de5672ff8764f88fb13904ea、目录树 32cb74bf0ecd7caed1983d514940bdefd96b2a2c，需按以下步骤安装：
- 将固定提交拉取到审查目录，并校验目录树哈希（应输出 TREE-OK）。
- 激活前检查：确认无符号链接、可执行位或子模块，并确认脚本中没有自更新入口。
- 第二次批准后，将审查过的目录复制到宿主技能的安装目录。
- 单独执行授权步骤，运行 authorize.py 完成浏览器登录并保存令牌。若宿主只在启动时发现技能，需要重开一个智能体会话。
安装后会得到 SKILL.md、manifest.json、install-source.json、若干 Markdown 参考文档，以及 scripts/authorize.py、scripts/mcp_client.py、scripts/uninstall.py。示例命令：
python3 "$HOME/.claude/skills/ai-photo-restyler/scripts/mcp_client.py" verify
用于免费连接检查（不计费）。付费调用须先经用户对成本卡明确批准，再以安装包 SKILL.md 中的工具名提交一次；若响应丢失，只能用相同 client_request_id 和相同参数重试，任务运行期间不得重新提交替代请求。
更新：本固定版本不能自更新，不会下载或替换包文件；update 只会报告安装来源提供的更新方式，对本步骤安装的副本通常查不到记录。升级需在新审查目录重做第 1 至 3 步，展示文件级差异后经批准再替换目录。
卸载：先运行 uninstall.py --dry-run，再运行正式卸载，阅读 JSON 决策：disconnected 表示这是设备上最后一个 Beatra 技能，令牌被吊销（revoked 为 true 时）并删除 ~/.beatra 下相关状态文件；keep_connection 表示其他 Beatra 技能仍共用令牌；revoke_retry 表示服务器拒绝吊销、需稍后重试。脚本不会删除包目录，需用户确认路径后自行删除。uninstall.py 不清理 ~/.beatra/updates/，在 disconnected 且无其他 Beatra 技能时可按说明移除。
适用场景
- 用户明确希望在 Beatra 上生成 Photo to Anime 作品，并接受付费。
- 用户已同意将提示词和参考图发送给第三方。
- 不适用于仅本地图像编辑，或未获批准的付费渲染。
限制
- 需要 Beatra 账号、网络访问、Python 3.10+ 和预付额度。
- 模型、价格、接口结构和可用性由 Beatra 及其上游模型提供商控制，可能变化，服务按现状提供。
- 输出具有概率性，不保证唯一或不侵权，发布前需人工复核。
- 本条目只审核上述固定目录树；更新版本属于另一次审核。
安全与隐私要点
网络请求均为 HTTPS 且拒绝重定向；授权走 api.beatra.ai，工具调用走 mcp.beatra.ai；上传是对服务器返回的 HTTPS 地址做 PUT，不带令牌。除非缓存的线路决策仍有效（10 分钟至 7 天），每次运行会先请求 skill-route，首个响应慢或返回 cn 时还会请求 api.beatra.cn，这些探测不带凭证或包标识。返回 cn 时授权与工具调用改走 api.beatra.cn 和 mcp.beatra.cn，使用同一令牌，版本提示从 www.beatra.cn 读取。可用 network --use ai 固定 .ai 主机并停止探测。
版本提示：不会自更新，也不会写入安装目录；在 verify、tools、upload、call 之前最多每 24 小时记录一次检查时间，只读查找其他安装器留下的记录，若发现新版本仅向 stderr 打印一行安装器自带的更新命令，从不执行。
上传与第三方：提示词和上传媒体会发送给 Beatra 并转发给执行任务的第三方模型提供商；cn 线路请求经 Beatra 在中国大陆的主机到达。
计费：付费工具消耗预付额度；因 Beatra 或上游模型原因失败的任务额度自动退回，否则购买不可退款，实际用量可能超过估算并产生负余额。
凭证：authorize.py 执行 OAuth 设备流程，在浏览器打开批准页，将单个令牌存入 ~/.beatra/credentials.json（目录 0700、文件 0600），令牌不进入命令行参数、环境变量或输出，具有完整 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。
遥测：授权时发送主机名、包 slug 与版本、检测到的智能体平台和安装引用；连接后最多每天一次注册调用，附带发布通道、网络线路、安装来源及系统版本、CPU 架构、Python 版本、区域设置、UTC 偏移等粗略运行时信息，工具调用附加 source_package_slug 和 source_platform，这些字段无法关闭。
留存与内容权利：账户数据在账户存续期间保留，任务记录、产物和计费账本在账户关闭后为审计与税务目的继续保留；用户保留其输入的权利并获得 Beatra 对输出的权利，须对上传媒体拥有权利，不得制造欺骗性冒充。
最佳实践：每次付费调用、每组上传和每个安装步骤各保留一次批准；报告实际净扣费而非估算；不静默替换为未审核版本；不打印或移动令牌；响应不确定时不用新请求 ID 重试。