codex-image-gallery

Codex 图片画廊

启动本地浏览器画廊，查看 Codex 生成的图像。此技能可独立运行：服务端位于 scripts/server.mjs，UI 模板位于 assets/index.html。

快速开始

在此技能目录（即包含此 SKILL.md 的目录）中运行命令。

node scripts/server.mjs

服务端会输出实际 URL。它会从 http://127.0.0.1:8765/ 开始，并在默认端口被占用时尝试后续端口。

工作流

1. 首先检查默认 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))'
   

   如果成功，则复用运行中的服务 http://127.0.0.1:8765/。

2. 如果 API 检查失败，则检查是否有正在运行的服务进程：

   pgrep -fl 'node .*server\.mjs' || true
   

   如果存在进程，但默认 URL 无法访问，请检查其标准输出，或尝试后续可能使用的端口，因为端口被占用时，服务会自动递增端口号。

3. 报告成功前，验证任何复用的 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))'
   

   如果服务选择了其他端口，请使用该端口。

4. 如果没有正在运行的服务，则启动服务：

   node scripts/server.mjs
   

   保持进程运行，并从标准输出中读取 URL。

5. 除非用户只要求提供 URL，否则请打开浏览器：

   open http://127.0.0.1:8765/
   

图像根目录

默认图像根目录：

~/.codex/generated_images

使用其他文件夹：

GALLERY_ROOT=/path/to/images node scripts/server.mjs

验证

编辑后，在确认技能正常运行前，请执行：

node --check scripts/server.mjs

然后启动服务并验证：

• GET /api/images 返回包含 rootPath 和 items 的 JSON
• /images/<relative-path> 为至少一个列出的项目返回图像内容
• 页面通过打包的 assets/index.html 加载

响应

报告 URL、图像根目录、服务是复用还是新启动，以及任何验证失败。回答简短即可。