Nodeclaw-Image-Gen
使用现有文本模型理解需求,选择风格/技术并调用随附的 Node CLI。确定性准备、验证和图像处理属于工具范畴,而非模型编写的脚本。无需额外的 LLM 服务、守护进程或存储上传器。将实际的 API 结果保存在本地;不要将它们重新托管到 Telegram/存储/CDN 上。
开始
将 <skill-root> 解析为包含此已加载 SKILL.md 的绝对目录;切勿从工作目录猜测。在用户的工作区中调用 node "<skill-root>/scripts/image-gen.mjs" ...,以便相对输出保存在那里。
- 检查 Node.js 22+ 和 CLI
--help,然后查看setup --status --json以了解本地凭据就绪状态(无需 API 调用)。不要打印配置文件,不要在每次使用时重写设置,或要求用户重复保存的地址/模型选择。 - 默认值:NodeClaw,
gpt-image-2,任务优先,一张图像,./generated-images/。对于插件安装,使用/plugin configure nodeclaw-image-gen@nodeclaw-image-gen;待决更改通过同一会话中的/reload-plugins加载,而不是常规重启。不要声称该技能可以自行打开或执行那些原生命令。附带的原生模块在加载/重新加载时将地址/密钥作为一个临时绑定传递;CLI 会验证它并忽略旧的启动导出。重新加载后,结合setup --status --json检查有效的apiBaseUrl、endpointMode和credentialConfigured。仅凭凭据就绪状态并不能证明配置最新或 API 已接受;status:not_configured可能意味着没有独立的配置文件。如果地址仍然过时或原生应用程序被阻止,请报告确切的加载/配置阻止程序,而不要打印环境值、读取密钥存储、重新输入已保存的密钥、重试未更改的重新加载或调用 API。用户选择的独立安装使用node "<skill-root>/scripts/image-gen.mjs" setup --interactive在用户自己的本地终端中运行;它会询问基地址并隐藏密钥,对于现有配置则需要显式的--replace。切勿在聊天、AskUserQuestion、规格、工具命令参数或 OAuth/令牌/会话存储中收集密钥。不要在已捕获的 AI 工具会话中运行交互式密钥提示。直接安装程序/设置密钥参数仅供人工操作的自动化使用,而非模型用于秘密收集。 - 重用提供的模型/路径/规格选择。
models --json合并有序发现;当没有目录时,仍然允许精确的手动模型,并显式声明能力未经核实。安装/设置地址/密钥会固定该端点;旧版自动模式在配置/原生回退之前,仍会尝试暴露的活动 harness。不要将存储的密钥移动到另一个地址或代理前缀。
生成或编辑
生成用于创建新图像;编辑则使用明确批准的源图像/遮罩。仅存在于工作区中的文件并不意味着允许发送它们。
node "<skill-root>/scripts/image-gen.mjs" generate --prompt "A quiet riverside town at sunrise" --dry-run --json
node "<skill-root>/scripts/image-gen.mjs" generate --prompt "A quiet riverside town at sunrise" --yes --json
编辑使用 edit --prompt TEXT --image FILE [--mask FILE]。对于较长的需求,使用经批准的私有 --spec FILE;规格不是诊断日志,也绝不包含 API 密钥。CLI 会将任务/OpenAI 路由附加到保存的基地址。原生 /v1beta/models/{model}:generateContent 需要显式的 --api-mode gemini:它仅是 Direct-only 原生内容/部分,不能由 Google 模型名称或 Images 兼容性键隐含。现有的 google_image_generate_content Images/任务执行保持在其当前路由上。Gemini 原生传输不是 Direct Image 计费/就绪状态的证明。CLI 帮助列出了实际选项。
在付费调用之前,根据干运行总结操作/模型/风格/规格/端点/方法/回退/输出。使用一种原生表单:按所示生成 / 调整 / 探索风格 / 取消。仅合并真正缺失的问题;不要询问每个字段。批准后使用 --yes;仅确认实质性数量/端点/顺序变更。
Claude Code 在可用时使用 AskUserQuestion;Codex 仅在实际暴露时使用 request_user_input。不要用编号文本冒充原生选择,或切换模式以发明工具。用户选择的非交互式自动化可以使用提供的配置/规格加上 --yes。Grok Bot 导入/原生表单集成未经核实;云路径不代表桌面文件。
风格和技术工具
styles list|show ID选择外观;techniques list|show ID选择工作流及其附带的工具。可以自由组合,无需风格→技术允许列表或其他编排服务。- 建议 2–3 种相关风格以及原始提示 / 无预设。使用
styles show ID --json读取选定的预设;exampleImages[]是可选的第三方预览 URL,不是经批准的 API 图像输入。不要自动获取、上传或将其用作编辑参考。58 个捆绑预设包括 55 个额外导入的风格;references/style-imports/中的原始集合仅是来源证明,绝不是另一个活跃的风格来源。GIF 名称不暗示动画支持。仅使用当前请求批准的主题/上下文,而不是无关的私有记忆。仅通过可用的 harness 工具请求时才进行搜索;不要将整个私有需求发送到搜索。 - 仅读取选定的工作流,检查要求,并使用其附带的
techniques prepare/check/merge工具。不要要求较弱的模型从头实现裁剪/调整大小/遮罩/颜色/合并逻辑。首先在本地准备,然后显示实际的付费请求数量和顺序以供批准。本地准备绝不授权推断。 - 像素画精修:准备对齐的最近邻平铺和编辑规格,通过现有客户端提交已批准的编辑,检查并合并为高分辨率/原始尺寸的 PNG。构图保持:准备一个受限的编辑规格并检查结果。两者都附带了 PNG 编解码器;无需安装 Python/ImageMagick。
- 缺少辅助工具/最小客户端要求需要经过批准的全技能更新或停止该技术在付费调用之前。不要用仅上下文的声明替换它、执行下载的代码、承诺无缝或开始付费重绘循环。
styles|techniques sync预览官方 GitHub JSON/Markdown;--yes应用。自定义命名空间是独立的。可执行辅助工具的更改需要经过验证的全技能更新;远程内容永远不会更改认证/端点/权限或授予执行批准。预设不会授权披露私有内存。
结果与恢复
使用返回的 JSON 状态和路径。saved 表示所有预期文件都已保存。pending/outcome_unknown 保留句柄并使用 resume --handle FILE,绝不创建另一个请求。save_failed 保留成功的文件并重试相同的结果。直接未知的结果没有启用的恢复。技术 incomplete/partial 退出码为 3;部分输出未完全精修。
停止客户端不会取消远程任务。不要切换方法/模型/端点以绕过不确定性、认证或策略;请参阅 API 契约。仅在实际可用时使用视觉检查;文件检查不能证明视觉质量。没有自动的付费精修。
对于安装请求,在调用其安装程序之前获取并验证选定的 GitHub 包;不要假设源文件已存在于本地。优先使用文档化的 AI 自动安装流程或选定的原生插件管理器,绝不重复安装。独立安装后,将其返回的 commands.configure argv 转换为一个使用真实安装路径的、适当引用的命令,供用户在本地运行;同时返回重新配置/状态/更新命令。插件使用其原生的敏感配置表单;其基于 Git 的市场独立于独立发布资产选择仓库修订版本。人工运行的终端 claude plugin install --config 可以提供声明的地址/密钥值,但绝不收集真实密钥或将其放入 AI 工具参数中。在用户完成设置且本地 setup --status --json 报告就绪之前,不要将凭据设置标记为完成;这是本地就绪状态,而非 API 接受。如果所需的独立发布版本或匹配的市场版本不可用,则以此阻止程序停止,而非发明已安装的功能。
docs fetch|sync 是可选的公共参考,不是运行时契约更新。独立 update check|apply 从不会写入插件管理的缓存;那些使用原生插件管理器。安装/替换/发布需要其自身的授权,而非从图像请求中推断的权限。用户交互遵循用户的语言;此技能的基础指导为英文。