SuperAPI AI 工具集

codex-image-gallery

设计与创作

查看项目

更新于 10-15 20:34

技能介绍

用途:为 Codex 生成的图片提供一个本地浏览器图库,方便浏览。该技能自包含,服务器代码位于 scripts/server.mjs,界面模板位于 assets/index.html。

主要能力:启动本地 Web 服务并展示图片;默认图片根目录为 ~/.codex/generated_images;可通过环境变量 GALLERY_ROOT 指定其他目录;默认从 http://127.0.0.1:8765/ 启动,端口被占用时自动尝试后续端口;提供 /api/images 接口返回 rootPath 与 items,/images/<relative-path> 返回图片内容。

使用方式:在包含 SKILL.md 的技能目录下运行 node scripts/server.mjs,服务器会打印实际 URL。可先用 node -e 'fetch("http://127.0.0.1:8765/api/images").then(r => r.json()).then(j => console.log(j.rootPath, j.items.length)).catch(() => process.exit(1))' 检查默认地址是否已有服务,成功则复用;失败时可用 pgrep -fl 'node .*server.mjs' || true 查找进程,并注意端口可能自动递增。复用前需再次验证 URL。若无服务则启动,保持进程运行并读取 stdout 获取 URL。除非用户只要 URL,否则用 open http://127.0.0.1:8765/ 打开浏览器。使用其他目录:GALLERY_ROOT=/path/to/images node scripts/server.mjs。

验证:编辑后先运行 node --check scripts/server.mjs,再启动服务器并确认 /api/images 返回含 rootPath 和 items 的 JSON、至少一个条目的 /images/<relative-path> 可返回图片内容、页面能从内置 assets/index.html 加载。

限制:资料未提供收费、平台兼容性、图片格式支持范围等更多信息;需本地具备 Node.js 环境。