AI Headshot Studio 是一个智能体技能（Skill），用于把随意的自拍转换成专业头像，可应用于简历、公司网站、职业档案和社交媒体。它可以在 Claude Code、Codex 或 OpenClaw 中调用，实际生成工作由付费托管的 Beatra 服务（mcp.beatra.ai）完成。
用途 当用户明确希望在 Beatra 上生成 AI 头像并接受其为付费服务时使用；当用户同意将提示词和参考图片发送给第三方时使用。不适用于仅本地图像编辑，或未批准付费渲染的场景。
主要能力 该技能本身是一个经过审查的目录指针，不是可执行包，不包含客户端代码，也不会自行执行任何 Beatra 操作。它指向的包捆绑了三个标准库 Python 脚本，用于发起网络调用并存储凭据。它没有自我更新器：不会下载代码，也不会修改自身文件。固定身份为：包 ai-headshot-studio 0.2.2，源提交 beatra-ai/ai-headshot-generator-skill@c5a2ab9（完整 SHA c5a2ab9483f81b36b501a16868516f960ec84ede），包树 14b395322c83d66604701fca1cb2b2e0dcc0abce，许可证 MIT No Attribution (MIT-0)。固定树中只有普通文件，没有符号链接、可执行位或二进制文件。
使用方式 安装分为四步。第一步：将固定树拉取到审查目录，需先说明会从 github.com 获取外部包并征得批准，然后执行 git clone 与 checkout，并校验树 ID 是否输出 TREE-OK，否则停止。第二步：激活前检查，确认没有符号链接、可执行文件或子模块条目，并确认不存在自我更新入口点。向用户报告审查发现，包括 SKILL.md、manifest.json、install-source.json、捆绑的 Markdown 参考文档，以及 scripts/authorize.py、scripts/mcp_client.py、scripts/uninstall.py（Python 3.10+，仅标准库，不安装依赖，无生命周期钩子）。第三步：复制到宿主技能目录（如 Claude Code 的 $HOME/.claude/skills/ai-headshot-studio），需获得明确授权，且目标不存在。第四步：单独授权，运行 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 技能，token 被撤销且 ~/.beatra 下相关文件被移除；keep_connection 表示其他 Beatra 技能仍在使用共享 token；revoke_retry 表示服务器拒绝撤销，需稍后重试。脚本不会删除包目录，确认路径后由用户删除。
适用场景 适用于需要专业头像的简历、公司网站、职业档案和社交媒体场景，且用户接受付费托管服务并同意上传参考图片。
限制 需要 Beatra 账户、网络访问、Python 3.10+ 和预付积分。模型、价格、模式和可用性由 Beatra 及其上游模型提供商控制，可能变化，服务按现状提供。输出具有概率性，不保证唯一或不侵权，发布前需人工审核。本目录条目仅审查上述固定树，更新版本属于另一次审查。
安全与安全说明 网络：所有请求均为 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-headshot-studio/sources.json（无凭据，3 秒超时，64 KiB 上限），若有更新版本则向 stderr 打印一行安装器自己的更新命令，但从不运行该命令。
上传与第三方：提示词和上传媒体发送给 Beatra 并转发给执行任务的第三方模型提供商。Beatra 在中国大陆以外运行服务；在 cn 路由下请求通过 Beatra 在中国大陆的主机到达。
肖像与参考媒体：上传的肖像或参考片段发送给 Beatra 和模型提供商，需对该确切文件集获得批准。
计费：付费工具消耗预付积分。因 Beatra 或上游模型原因失败的任务积分自动返还；否则购买不可退款，实际使用可能超过估算并导致负余额。
凭据：authorize.py 运行 OAuth 设备流，在批准页打开浏览器，并将一个 bearer token 存储在 ~/.beatra/credentials.json（目录 0700，文件 0600）。token 不会进入 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。除 host.json 外文件均为 0600。
遥测：授权发送主机名作为设备名、包 slug 和版本、检测到的智能体平台、安装引用。连接后最多每天一次（除非版本、平台、路由或安装源变化）进行非计费的 beatra.installations.register 调用，包含包和平台字段、发布渠道、网络路由、安装源和粗略运行时事实。每次工具调用添加 source_package_slug 和 source_platform。这些字段无法选择退出。
保留：账户数据在账户生命周期内保留。任务记录、工件和计费账本在账户关闭后为审计和税务目的保留。
内容权利：用户保留其输入的权利，并获得 Beatra 在输出中的权利；用户必须持有上传媒体的权利，且不得创建欺骗性冒充。