SeaGames CLI

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install seagames-cli
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 seagames-cli。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

SeaGames CLI 是一个捆绑的命令行技能，用于使用为您的账户发布的函数创建和转换项目资产。它涵盖 AI 生成以及实用的媒体操作，包括图像编辑与批处理、视频帧提取、音频处理、文本生成以及 3D 资产工作流。
Openclaw Skills 可以使用该 CLI 上传资源、跟踪并恢复作业、下载完整的结果，并且在支持的情况下，通过后端 API 将资产交付到指定的项目画布。可用的函数和模型绑定取决于账户和当前服务目录；该技能不会绕过不可用的功能或凭空捏造模型参数。

应用场景

从文本或参考图生成图像、探索风格和调色板，或创建像素艺术。
去除背景、重绘或扩展图像、重新打光、分解图层，并执行批量调整大小、裁剪、分割或合成。
从提示词和参考图生成视频、剪辑片段、采样帧或导出图像序列。
生成或处理语音、音乐和音效，包括音频剪辑和转换。
生成 3D 资产并运行受支持的拓扑重建、纹理贴图、绑定和导出工作流。
生成或优化文本、美化提示词，或从图像中逆向推导提示词。
针对受支持的工作流使用工具箱模板，或在中断后上传资源并恢复现有作业。
当安装的 API 支持该操作时，将生成或处理后的资产交付到用户选择的项目画布。

工作原理

选择当前操作系统的捆绑可执行文件，并验证其版本和帮助输出。
检查固定的环境和可用的已发布函数；当账户特定的模型或媒体列表需要认证时进行登录。
确认支持的命令、输入、输出位置和必需的选项。根据命令的支持情况上传本地资产或提供参考文件。
对于项目交付，使用用户提供的项目 ID 或将当前目录绑定到选定的项目。请勿猜测项目或静默切换到仅下载模式。
使用记录的产品参数运行生成或处理命令。CLI 处理受支持的上传、任务执行、等待和下载。
保存任务 ID、媒体作业 ID、操作 ID、幂等键和上传收据，以便查询或恢复现有工作，而不是提交重复的付费请求。
检查输出清单并验证交付的文件及相关属性，例如尺寸、透明度、动画帧或随附的 3D 文件。

配置指南

使用 SeaGames CLI 技能包中包含的可执行文件；请勿替换 PATH 上找到的其他可执行文件。该包包含针对 Windows x64、Linux x64 和 macOS ARM64 的平台特定二进制文件。选择与环境匹配的二进制文件。该包面向一个固定的生产 API，可通过 profiles list 进行检查；请勿编辑环境配置或覆盖 API。
首先运行非计费检查：
./bin/seagames-cli-linux-x64 --version
./bin/seagames-cli-linux-x64 --help
./bin/seagames-cli-linux-x64 profiles list
对于 macOS ARM64，请使用 ./bin/seagames-cli-macos-arm64 代替 Linux 可执行文件。在 Windows 上，请从合适的终端使用捆绑的 bin/seagames-cli-windows-x64.exe。通过相关的 --help 输出检查命令特定的选项。使用 functions --json 检查已发布的功能；账户特定的模型列表可能需要登录。
如果需要认证，请运行 login --phone PHONE 且仅使用用户提供的验证码。请勿打印或暴露会话凭据。此包记录的是验证，而不是单独的下载或包管理器安装命令。初始检查不应发送 SMS 消息或创建付费作业。

数据架构

SeaGames CLI 未指定单一固定的本地项目模式。文件和标识符取决于命令、所选功能、账户目录和输出规则。请参阅捆绑的输出指南以了解格式、覆盖、透明度和多结果行为。
数据或构件 其用途
输入文件和参考文件 可以使用支持的资源命令上传本地资产，或通过诸如文档中记录的 --reference-file 等选项提供。
资源 ID 和上传收据 标识上传的输入并支持后续检索或恢复。
任务 ID 和媒体作业 ID 跟踪生成或处理作业，并在超时后恢复或查询现有工作。
分析、批处理和操作 ID 为受支持的分解、批处理或画布交付工作流保留标识符。
幂等键 有助于避免无意中重复付费任务；在恢复原始操作时予以保留并重复使用。
输出文件和清单 通常写入 --output，或者对于面向目录的命令写入 --output-dir；检查命令的输出规则并验证所有预期的结果。
项目和画布元数据 可以显式提供项目 ID 或将其绑定到当前目录。画布交付状态与生成和本地下载状态不同；请确认交付的收据和保存的节点。
该软件包还包含针对模型、用法、输出规则、音频、3D、背景去除以及角色、场景和 UI 工作流的参考指南。

高级特性

functions --json
、账户特定的模型列表、技术目录以及离线内置图像参数快照进行功能发现；这些来源并不能全部证明某个功能当前已发布。
适用于图像生成与编辑、视频生成与提取、音频生成与处理、文本工具、3D 工作流和动态工具箱模板的广泛媒体命令系列。
使用保存的标识符（而不是创建重复任务）进行资源上传、任务与媒体作业查找、多结果下载和恢复。
具有项目绑定、操作查找和重试支持的后端画布交付；基于浏览器的画布控制不用作回退方案。
针对文档记录的可恢复资源或配额等待条件的受控重试行为。超时并不一定意味着作业失败，付费任务创建也不会自动重试。 3d export 进行本地原生 OBJ/FBX 转换，前提是遵守受支持的格式和文档记录的附加规则；此转换不需要浏览器、Node.js 或 Blender。
针对部分结果和资产特定属性的输出验证指导。Openclaw Skills 应该报告不受支持或不可用的操作，而不是绕过已发布的功能力度限制。

name: seagames-cli description: 使用 SeaGames CLI 为项目生成和处理图片、视频、音频、文本及 3D 资产，执行图片工具、语义拆件、动态工具箱和本地批处理；支持资源上传、任务恢复和完整产物下载。 SeaGames CLI 使用指南

随附候选版本：1.2.1。使用前运行 --version 和目标命令 --help 确认二进制支持。文档中的可用性由当前账号发布目录和实时报价决定；后台入图还要求目标 API 支持交付协议。安装验证只检查版本、帮助和 profiles list，不执行收费任务。

3D 生成默认使用服务端为所选能力配置的当前推荐版本，不在命令或文档中固定旧版模型。

程序与会话

使用本 Skill 的 bin/seagames-cli-windows-x64.exe、bin/seagames-cli-linux-x64 或 bin/seagames-cli-macos-arm64。API 由随包配置固定；不调用 PATH 或其他 Skill 中的同名版本。使用匹配环境的已保存会话；需要登录时执行 login --phone PHONE，验证码只能使用用户提供的值。不要输出会话凭证。

选择能力

先用 functions --json 查询已发布功能；普通生成可以用 --function、--binding 指定目录中的选项。models 及各媒体 models 默认需要登录，返回当前账号已发布的模型绑定、名称及参考能力；--technical 查看技术接入目录，--builtin 查看离线图片参数快照，两者均不证明已发布。下线、隐藏或返回不可用的功能不通过改模型或私有参数绕过。

需求 命令入口 按需说明
文生图、参考图、风格与配色迁移、像素图 image generate、palettes、styles list 模型指南
超强 AI 抠图、普通去背景 image strong-cutout、image remove-background 抠图指南
重绘、扩图、打光、图层分解、万能拆分 image repaint/outpaint/relight/layer-decompose/decompose 使用说明
缩放、裁剪、分切、九宫格、序列合成、批处理 image resize/crop/trim-alpha/grid-split/auto-split/nine-slice/gif-resize/compose-sequence/batch 使用说明
文生视频、混合参考视频、首尾帧 video generate 使用说明
视频裁剪、取帧、序列导出、首尾帧动画 video trim/frame-sample/extract-frames/sequence-export、image animation 使用说明
语音、音乐、音效、音频裁剪与转码 audio generate/process 音频指南 3D 生成、减面、纹理、绑骨、导出 3d generate/retopologize/texture/rig/export 3D 指南 文本、提示词优化、图片反推 text generate/beautify、image reverse-prompt 使用说明
动态工具箱模板 toolbox list/get/plan/run 使用说明
上传、恢复任务、多结果和文件组下载 resources、tasks、media-jobs 输出与恢复
环境查询、目录绑定项目、后台资产入图与恢复 profiles list、projects use/unuse、canvas 支持范围与使用说明

表中斜线表示同一命令组的不同子命令，不是可直接复制的命令字符串。人物立绘、场景、UI 工作流分别见 人物、场景、UI。

执行与交付
先确定输入资源、输出路径和必要模型控件；不假定所有命令都接受 --model、--prompt 或 --quote-only。
普通参考图可使用 --reference-file 自动上传或复用；封装工具按帮助使用资源 ID，本地图片先 image upload --file PATH --json。
封装功能只使用产品参数，不能根据底层模型自行组装请求或推算价格。 --output 通常隐含等待和下载；目录型命令使用 --output-dir。具体格式、透明度、多结果和覆盖规则先读 输出规则。 超时不代表任务失败。保存任务 ID、媒体 job ID、拆件分析/批次 ID、幂等键及上传回执；先查询原任务，不换键重跑付费请求。
部分成功必须检查清单。结果完成后验证尺寸、透明通道、动画帧和 3D 配套文件，再用于项目。

报价等待：资源时长或审核未就绪时，CLI 对明确可恢复错误自动等待最多约 2 分钟。只重报价格，不重传资源或重试收费创建；详见 references/OUTPUT_RULES.md。

报价前的单个资源 GET 查询也复用相同等待机制，处理审核/上传期间返回的可恢复 409，避免在到达报价前直接退出。等待预算按每次资源读取或报价请求分别计算。其他 GET、上传、任务创建和收费重试均不在自动重试范围。

登录与项目

安装包已固定环境；用 profiles list 查看随包 API。切换环境请使用对应 Skill，不能修改 profile 或覆盖 API。凭据仍按 API 与账号隔离。

已接入的生成和加工默认后台入画布。先使用用户指定的 --project-id 或当前目录 projects use PROJECT_ID 绑定；缺少目标时询问用户，不自动创建或猜选项目，也不静默改成仅下载。用户明确不要入图时使用 --no-attach。支持范围见 使用说明；查询和下载不会额外插入节点。

画布操作全程使用后台 API，禁止打开、导航或操控浏览器画布（包括无头浏览器），不能以页面点击作为失败回退。网页开着也允许后台追加，必要时由用户刷新查看；不要要求用户关闭画布。projectUrl 仅返回给用户。本地模型格式转换使用 CLI 内置算法，也不打开浏览器。

保留 operationId、任务 ID 与回执路径；中断后用 canvas operation get 查询，入图失败用 canvas operation retry 恢复原意图。本地产物的 retry 还会续传原文件，因此保留原路径和内容；不会重新处理素材。生成完成、画布保存和本地下载是不同状态，只有交付回执为 delivered 且节点回读存在才能说明已保存。旧 API 缺少能力时停止，不能擅自加 --no-attach 再提交收费任务。

访问令牌过期时 CLI 会自动使用刷新令牌续期；刷新令牌也失效时才需要重新登录。不要因查询失败重新创建生成任务，应使用已有任务 ID 恢复。

项目 ID 可通过 projects list --json 获取；只有用户要求新项目时才执行 projects create，不需要操作画布。

本地模型导出

OBJ/FBX 使用 3d export 在本机原生转换，无需浏览器、Node.js 或 Blender，不创建生成任务、不消耗积分。FBX 默认上传完整模型组入图；OBJ 仅支持显式 --no-attach 本地导出。先阅读 3D 指南。转换不支持的模型应报告具体错误，不临时编写转换程序，也不回退到付费任务。

安装包环境

本包为 正式环境，Skill 目录为 seagames-cli。API 由随包 environment.json 固定；用 profiles list 只读查看。不要配置 profile 或覆盖 API，不要修改环境文件，也不要仅复制二进制。升级只备份并替换同名 Skill，不覆盖另一个环境。命令示例中的 seagames-cli 指本 Skill 的 bin 内对应平台程序，不使用 PATH 中其他版本。安装验证只运行 --version、--help、profiles list，不发短信、不创建收费任务。

本地 TOTP 查看器
SEOmatic SEO 审计