AI Logo Maker 技能用于在 Claude Code、Codex 或 OpenClaw 等智能体环境中，将品牌名称、行业或参考图片转化为 Logo 概念。实际生成工作由托管的付费服务 Beatra（mcp.beatra.ai）完成。该技能本身是一个经过审核的目录条目，不是可执行包，不含客户端代码，也不会自行执行任何 Beatra 操作。
用途
当用户明确希望在 Beatra 上生成 AI Logo Maker 作品并接受付费时使用。当用户同意将提示词和参考图片发送给第三方时使用。不适用于仅本地图片编辑，或未批准付费渲染的场景。
主要能力
该技能指向的软件包（ai-logo-maker 0.2.6）包含三个仅使用 Python 标准库的脚本：authorize.py、mcp_client.py、uninstall.py。脚本会进行网络调用并存储凭据。软件包没有自更新器，不会下载代码，也不会修改自身文件。固定版本树中只包含常规文件，没有符号链接、可执行位或二进制文件。
使用方式
安装分为四步。第一步：将固定版本树拉取到审查目录，需先说明会从 github.com 获取外部包并征得批准。命令包括使用 git clone 和 checkout 指定提交 50d2353e6d878980f06a4d89bbd0996f8ac3776c，并验证树 ID 为 a9774ee50fb1d08591158ba3328c571721aadbc8，若未输出 TREE-OK 则停止。第二步：激活前检查，确认没有符号链接、可执行文件或子模块，并确认没有自更新器入口。向用户报告审查发现的内容。第三步：复制到宿主技能目录（如 Claude Code 的 ~/.claude/skills/ai-logo-maker），需第二次单独批准，因为这会更改智能体配置。第四步：授权，运行 authorize.py，会打开浏览器登录并存储 bearer token，需先征得同意。
工作流程：先阅读已安装包的 SKILL.md 及其引用，了解路由、载荷格式和审查循环。先使用免费、不计费的发现功能（beatra.models.list、任务列表）读取当前模型卡和积分估算。向用户展示恰好一次付费调用的成本卡：工具、模型、估算和将上传的文件。等待明确批准。只上传用户提供并批准的文件，然后使用稳定的 client_request_id 提交一次并轮询返回的任务。报告交付的产物和 billing.net_charged_credits，与用户一起审查结果，并在任何进一步付费阶段前再次询问。
示例：免费连接检查（不计费）运行 mcp_client.py verify。一次批准的付费调用：在用户批准成本卡后，使用已安装 SKILL.md 中的工具名，以稳定的请求 ID 提交一次；若响应丢失，仅用相同的 client_request_id 和相同参数重试，任务运行期间绝不提交替代请求。
更新：此固定版本无法自我更新，没有下载或替换包文件的代码。update 仅报告安装副本的商店或工具提供的内容。要迁移到更新版本，需在新审查目录中重复步骤 1 到 3，向用户展示与已安装副本的文件级差异，并在批准后替换目录。
卸载：运行 uninstall.py --dry-run 和 uninstall.py。读取 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。uninstall.py 不删除 ~/.beatra/updates/。当决策为 disconnected 且没有其他 Beatra 技能安装时，删除该目录，然后删除空的 ~/.beatra；否则保留。无法撤销的令牌在闲置 15 天后过期，可在 Beatra Console 的 Agents 下立即撤销。
适用场景
适用于用户明确希望在 Beatra 上生成 Logo 概念并接受付费、同意将提示词和参考图片发送给第三方的场景。
限制
需要 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 读取；Beatra 从中国大陆提供这些 .cn 主机。运行 mcp_client.py network --use ai 可固定 .ai 主机并停止探测；失败的版本通知读取仍可在另一网络重试一次。
版本通知，无自更新：此版本没有下载或替换包文件的代码，也不在安装目录内写入任何内容。在 verify、tools、upload 或 call 之前，每个安装路径最多每 24 小时一次，记录检查时间并只读地查找其他安装器留在包旁的记录（ClawHub origin.json、SkillHub 或 skills CLI 锁条目、gh skill frontmatter）。通过上述步骤安装的副本通常没有这些记录，不会发出请求。当找到记录时，读取 https://beatra.ai/skills/ai-logo-maker/sources.json（无凭据，3 秒超时，64 KiB 上限），如果该安装器提供更新版本，则向 stderr 打印一行，包含安装器自己的更新命令。它从不运行该命令。
上传和第三方：提示词和上传的媒体发送给 Beatra，并转发给执行任务的第三方模型提供商。Beatra 在中国大陆以外运行服务；在 cn 路由上，请求通过 Beatra 在中国大陆的主机到达。
计费：付费工具消耗预付积分。因 Beatra 或上游模型原因失败的任务积分会自动返还；否则购买不可退款，实际使用可能超过估算并留下负余额。
凭据：authorize.py 运行 OAuth 设备流程，在批准页面打开浏览器，并在 ~/.beatra/credentials.json 中存储一个 bearer token（目录 0700，文件 0600）。令牌从不进入 argv、环境变量或输出。它携带完整的 Beatra 范围，包括 wallet:spend，具有滑动 15 天闲置生命周期，并由设备上每个 Beatra 技能共享。当用户尚未选择 Allow 时，待处理的设备代码保存在 ~/.beatra/pending_authorization.json（0600），以便重新运行完成同一批准而不是打开新的批准。当 verify、tools、upload 或 call 找不到可用令牌时，客户端对该保存的批准进行一次检查，如果用户已选择 Allow 则存储令牌；它从不启动新授权或打开浏览器。
本地状态：~/.beatra/ 还保存 installation.json（随机安装引用）、host.json（智能体平台和主机名）、skills.json（已安装 Beatra 技能路径）、network.json（路由决策，当路由答案包含国家代码时）、balance-holds.json（在积分不足拒绝后，该工具在本地被回答最多 30 分钟；call --recheck-balance 发送一次调用）、短期的 .authorize.lock，以及每个安装路径的 updates/<id>/state.json（上次版本检查）、source.json（安装来源）和 registration.json（上次注册）。文件为 0600，除了 host.json 遵循 umask。
遥测：授权发送主机名作为设备名、包 slug 和版本、检测到的智能体平台（例如 claude-code，来自环境变量）以及安装引用。连接后，除非版本、平台、路由或安装来源变化，最多每天一次，客户端进行不计费的 beatra.installations.register 调用，包含这些包和平台字段、发布渠道、网络路由、安装来源（此树为 github）以及粗略运行时事实：操作系统和操作系统版本、CPU 架构、Python 版本、区域设置和 UTC 偏移。每次工具调用添加 source_package_slug 和 source_platform。这些字段没有退出选项。
保留：账户数据在账户生命周期内保留。任务记录、产物和计费账本在账户关闭后为审计和税务目的保留。
内容权利：用户保留其输入的权利，并获得 Beatra 在输出中的权利；用户必须持有上传媒体的权利，且不得创建欺骗性冒充。