用途
poster-design-studio 用于在 Claude Code、Codex 或 OpenClaw 等智能体环境中，把活动描述、产品照片或品牌参考交给 Beatra 托管的 AI Poster Maker 服务，生成活动海报、宣传横幅或社交媒体图，强调清晰的视觉层级、按类别匹配的风格以及为文字预留的空间。该工作属于付费的托管服务，不是本地图像编辑工具。
主要能力
- 基于活动描述、产品照片或品牌参考生成海报类图像。
- 输出面向活动海报、促销横幅和社交媒体图。
- 通过 Beatra 的 MCP 服务（mcp.beatra.ai）执行任务。
- 技能包内提供连接检查、授权、调用与卸载脚本，仅依赖 Python 3.10+ 标准库。
本目录条目本身是经过审核的指向记录，不包含可执行客户端代码，也不会单独执行任何 Beatra 操作。
使用方式
- 获取固定提交：从 github.com/beatra-ai/ai-poster-maker-skill 克隆，并检出提交 c2c81e2f6b41691c9da65e71b4350f59cb6eace5 下的 skills/poster-design-studio，确认 Git 树 ID 为 8f18a8574c7b8fe983176d4a733788a550e53c52。若未输出 TREE-OK 应停止。
- 激活前检查：确认包内只有普通文件，无符号链接、可执行位或子模块；确认脚本中不存在旧版自更新入口。
- 复制到宿主机的技能目录（如 ~/.claude/skills/poster-design-studio），复制前需获得用户第二次批准。
- 单独授权：运行 scripts/authorize.py，打开浏览器完成 OAuth 设备流登录并保存令牌。若宿主机仅在启动时发现技能，需要新开会话。
- 使用免费、不计费的发现调用（如 beatra.models.list、任务列表）查看模型与额度估算。
- 对每一次付费调用先展示成本卡（工具、模型、估算、将上传的文件），获得明确批准后再提交；提交时使用稳定的 client_request_id，并轮询任务。
- 报告交付物与实际计费的 net_charged_credits，并在任何后续付费阶段前再次征求同意。
免费连接检查示例：
python3 "$HOME/.claude/skills/poster-design-studio/scripts/mcp_client.py" verify
更新方面，该固定版本没有自更新代码；如需升级，需针对新提交重复审查步骤并展示文件级差异，经批准后替换目录。卸载使用 scripts/uninstall.py，支持 --dry-run；脚本不会删除包目录本身。
适用场景
- 用户明确希望在 Beatra 上生成 AI 海报并接受付费。
- 用户已同意将提示词和参考图发送给第三方。
- 需要活动海报、促销横幅或社交媒体图形，并希望保留文字排版空间。
不适合本地-only 图像编辑，或未获批准的付费渲染。
限制与注意事项
- 需要 Beatra 账户、网络访问、Python 3.10+ 和预付额度。
- 模型、价格、接口结构和可用性由 Beatra 及其上游模型提供方控制，可能变化，服务按现状提供。
- 输出具有概率性，不保证唯一或不侵权，发布前需要人工审核。
- 目录条目仅审核上述固定树；更新版本属于新的审核。
- 授权令牌具有完整 Beatra 范围（包括 wallet:spend），闲置 15 天滑动过期，设备上所有 Beatra 技能共享。
- 上传内容会被转发给执行任务的第三方模型提供方；部分请求可能经中国大陆主机路由。
- 失败任务若归因于 Beatra 或上游模型会自动返还额度，否则购买不可退款，实际用量可能超过估算并产生负余额。
- 存在安装注册与粗粒度运行环境遥测，且无退出选项。