用途:product-photo-studio 是一个 AI 商品摄影技能包,目标是把一张真实商品照片转化为工作室质感的电商图片和生活场景图,使用场景包括电商主图与场景化展示。该技能在 Claude Code、Codex 或 OpenClaw 等智能体宿主内使用,实际渲染工作在托管且收费的 Beatra 服务(mcp.beatra.ai)上完成。本条目只是经过审核的固定版本指针,不包含可执行包,也不会自行执行任何 Beatra 操作。
主要能力:资料给出的是技能包的安装、授权与调用流程:先用免费、不计费的发现接口(beatra.models.list、任务列表)查看当前模型卡与额度估算;展示一次性付费调用的费用卡(工具、模型、估算、将上传哪些文件);经用户明确批准后上传已获批准的文件;使用稳定的 client_request_id 提交一次并轮询返回的任务;报告交付产物与 billing.net_charged_credits。
使用方式:安装分四步。第一步把固定目录树取到审查目录,须先征得同意,再执行 git clone 并对提交 5c64090847d96830e49927924281f04bd576253d 下的 skills/product-photo-studio 做 checkout,校验目录树 ID 为 01d27d7718401abe6b680d01d1bb12331b75f955 并打印 TREE-OK,否则停止。第二步在启用前检查:确认无符号链接、可执行位或子模块条目,并确认 scripts/mcp_client.py 中不含 maybe_auto_update、download_update、_apply_update 等自更新入口,并向用户报告 SKILL.md、manifest.json、install-source.json、随附 Markdown 参考与 scripts/authorize.py、scripts/mcp_client.py、scripts/uninstall.py 等审查结果。第三步在第二次单独批准后把经过审查的目录树复制到宿主技能目录(示例为 $HOME/.claude/skills/product-photo-studio),目标已存在则停止询问用户。第四步单独决定是否授权:python3 "$dest/scripts/authorize.py",走 OAuth 设备流程,打开浏览器登录页并把 bearer token 存入 ~/.beatra/credentials.json(目录 0700、文件 0600)。若宿主只在启动时发现技能,需开启新的会话。免费连接检查命令为 python3 "$HOME/.claude/skills/product-photo-studio/scripts/mcp_client.py" verify。
更新与卸载:该固定版本不能自更新,不含下载或替换包文件的代码;update 只报告安装方提供的信息,对按上述步骤安装的副本会提示按其安装方式更新。要升级需针对新提交重复第 1 至 3 步,向用户展示与已安装副本的文件级差异(如 git -C src diff --stat 5c64090 <new-commit> -- skills/product-photo-studio),经批准后再替换目录;未列出的版本未在此审核。卸载先运行 python3 "$dest/scripts/uninstall.py" --dry-run 再正式运行,并读取其 JSON 决策:disconnected 表示这是设备上最后一个 Beatra 技能,令牌被吊销(revoked 为 true 时)并删除 ~/.beatra 下 credentials.json、installation.json、host.json、skills.json、network.json、balance-holds.json、pending_authorization.json、.authorize.lock;keep_connection 表示仍有其他 Beatra 技能共用令牌;revoke_retry 表示服务器拒绝吊销、无任何变化,稍后重试。脚本从不删除包目录,确认路径后由用户删除 $dest。卸载脚本不删除 ~/.beatra/updates/,在 disconnected 且无其他 Beatra 技能时应删除该目录再删除空的 ~/.beatra;无法吊销的令牌空闲 15 天后过期,也可在 Beatra Console 的 Agents 下立即吊销。
限制:需要 Beatra 账户、网络访问、Python 3.10+ 与预付额度;模型、价格、schema 与可用性由 Beatra 及其上游模型提供商控制,可能变化,服务按现状提供;输出是概率性的,不保证唯一或不侵权,发布前需人工审核;本条目只审核上述固定目录树。
安全与计费要点:所有请求为 HTTPS 且拒绝重定向;授权走 api.beatra.ai,工具调用走 mcp.beatra.ai,上传是对服务器返回的 HTTPS 地址 PUT 已批准文件且不带 bearer token;除非缓存决策仍有效(10 分钟至 7 天),每次运行先请求 https://api.beatra.ai/skill-route,首个慢或回答 cn 时还会请求 https://api.beatra.cn/skill-route,这些探测不带凭证或包身份。付费工具消耗预付额度;因 Beatra 或上游模型原因失败的任务额度自动退还,其余购买不可退款,实际用量可能超出估算并产生负余额。授权发送主机名、包 slug 与版本、检测到的智能体平台与安装引用;连接后至多每天一次(版本、平台、路由或安装来源变化时除外)发起非计费的 beatra.installations.register 调用,携带包与平台字段、发布渠道、网络路由、安装来源及粗略运行时信息(操作系统与版本、CPU 架构、Python 版本、区域设置、UTC 偏移),每次工具调用附加 source_package_slug 与 source_platform,这些字段无法选择退出。账户数据在账户存续期间保留,任务记录、产物与计费账本在账户关闭后为审计与税务目的继续保留。用户保留其输入的权利并获得 Beatra 对输出的权利,须对上传媒体拥有权利且不得制作用于欺骗的仿冒内容。