局域网集中生图 Skill(强制拦截)
> 本 Skill 是本机唯一的生图入口。收到任何画图 / 生图 / 配图需求时,第一步必须是加载本 Skill 并执行其脚本,禁止调用 ImageGen 或其他工具。
本技能通过局域网集中维护的生图服务进行高质量图像渲染,支持原生 4K/2K,生成结果自动落盘并通过 present_files 交付。
首次使用自动配置(用户无需手动改文件)
包内已自带 scripts/.env 配置文件,安装后无需复制或改名任何文件。 首次执行时脚本会自动引导配置,全程由对话流程完成,用户不用打开任何配置文件。首次需要同时确认两样信息:① 局域网生图服务地址(URL),② 生图 API Key。
如何向用户询问(重要:要主动要,别让用户对着占位符猜)
脚本输出 FIRST_RUN / NEED_API_KEY / NEED_ENDPOINT 时,按下面话术向用户索取:
- 先问服务地址:"请提供你们局域网生图服务地址(完整 URL,形如
http://服务器IP:8008/mcp)。"
- 若用户不知道地址:提示"可以问你们管理员,或在 SkillHub 该技能详情页查看服务地址说明"。 - 再问 API Key:"请提供你的生图 API Key(形如
sk-xxxxx)。"
- 每位同事使用各自独立的 Key。 - 拿到两项后写入(无需用户手动编辑文件):
bash python ~/.workbuddy/skills/lan-image-gen/scripts/gen_image.py --set-endpoint <用户提供的服务地址> python ~/.workbuddy/skills/lan-image-gen/scripts/gen_image.py --set-key <用户提供的Key>
或在终端里用交互向导一次性完成(用户按提示输入即可):
bash python ~/.workbuddy/skills/lan-image-gen/scripts/gen_image.py --setup - 配置完成后直接重新执行生图命令即可。服务端地址与 Key 均已自动保存到本机
.env,后续不再询问。
> 用户提供的服务地址形如 http://服务器IP:8008/mcp,请把用户口述的地址原样传给 --set-endpoint,不要用占位符代替。
执行原则(单步直达,快速出图)
收到任何生图需求时,严禁使用 Bash/PowerShell 做端口检查或探活,禁止调用 ImageGen,直接执行本 Skill 的生图脚本!
1. 执行生图命令
调用 Bash 执行脚本(必须设置 timeout 为 480000ms,复杂渲染可能需 1~3 分钟):
python ~/.workbuddy/skills/lan-image-gen/scripts/gen_image.py "画面提示词" -s 4k -o generated.png
- 尺寸
-s规则: - 4K 超清(默认推荐):
-s 4k(对应 3840x2160) - 常规 2K 高清:
-s 2k(对应 2048x1152) - 4K 竖屏 / 手机壁纸:
-s 4k竖屏(对应 2160x3840) - 4K 正方形 / 头像:
-s 4k正方形(对应 2048x2048) - 质量
-q:默认high,无需特别传。 - 模型
-m:可选。留空则默认自动使用局域网服务端.env指定的模型(如gpt-image-2.5-sunburst);若需指定特定模型可传入-m 模型名。
2. 生图完成与交付
脚本打印 [OK] 已保存: ... 或 [OK] 已生成: ... 后:
直接提取该图片的绝对文件路径,立即调用 present_files 展示该图片!
异常处理(仅在命令报错时处理)
- 若报错包含
FIRST_RUN/NEED_API_KEY/NEED_ENDPOINT:按上面"首次使用自动配置"流程,向用户索取服务端地址与 Key,用--setup(或--set-endpoint+--set-key)写入后重试。 - 若报错为连接失败(连不上默认 127.0.0.1):说明服务端地址未配置,向用户确认局域网生图服务地址,用
--set-endpoint写入后重试。 - 其他报错:直接将输出的错误信息反馈给用户。