1实现原理 · 为什么它能做到
自包含本地服务：scripts/server.mjs 是纯 Node stdlib HTTP 服务器（无第三方包），绑定 127.0.0.1，默认端口 8765，被占则自动 +1 递增（上限 +20）；UI 模板 assets/index.html 由同一目录提供。
daymade-codex/codex-image-gallery/SKILL.md
The server prints the actual URL. It starts at `http://127.0.0.1:8765/` and tries later ports if the default is occupied.
注：server.mjs：'const HOST = process.env.HOST || "127.0.0.1"'；listen() 内 'if (error.code === "EADDRINUSE" && port < DEFAULT_PORT + 20) { listen(port + 1); }'。
API 面就两个：GET /api/images 递归 walk 图片根目录返回 {rootPath, items[](path/mtime/size)}（按 mtime 降序）；GET /images/<rel> 流式返回图片文件——两者都做路径穿越防护（safePath 校验解析后路径必须留在根内）。
daymade-codex/codex-image-gallery/scripts/server.mjs
if (fullPath !== root && !fullPath.startsWith(`${root}${path.sep}`)) { return null; }
注：/api/images 带 'cache-control: no-store'；/images/ 的 rel 经 decodeURIComponent 后再 safePath，越界回 403。默认根 ~/.codex/generated_images，可用 GALLERY_ROOT env 覆盖。
『复用优先』协议：先 fetch /api/images 探测默认 URL（成功即复用已在跑的 server），失败再 pgrep 找进程并试后续端口，最后才新起 server——避免每请求叠一个实例。
daymade-codex/codex-image-gallery/SKILL.md
If this succeeds, reuse the running server at `http://127.0.0.1:8765/`.
注：SKILL workflow 1-4 步：探测→pgrep→按端口验证复用→起服务；'Keep the process running for the user and read stdout for the URL.'
前端 index.html 是同源 fetch('/api/images') 渲染网格/灯箱/批量标签，纯本地数据无第三方 CDN/字体/脚本依赖。
daymade-codex/codex-image-gallery/assets/index.html
const response = await fetch("/api/images", { cache: "no-store" });
注：页面另有 'Open another folder'（浏览器内选目录）+ 复制路径等本地功能；渲染逃逸用 escapeHtml。
验收路径可自动验证：node --check 语法 + 起服后核对 /api/images 有 items、/images/<rel> 能出图、首页来自 bundled index.html——SKILL 明示改完代码后要跑这三条再宣称 healthy。
daymade-codex/codex-image-gallery/SKILL.md
Before declaring the skill healthy after edits, run: `node --check scripts/server.mjs`
注：这是作者自带的『改完必须验证』纪律，与 statusline-generator 的 health check 同思路。
2核心能力
01浏览 Codex 生成图片（默认 ~/.codex/generated_images，GALLERY_ROOT 可换目录）
02递归列目录 + 按 mtime 排序 + 逐图服务（png/jpg/webp/gif）
03运行中 server 的探测复用（API check → pgrep → 端口递增定位）
04浏览器内批量浏览/筛选/灯箱/路径复制（bundled 单文件 UI）
05路径穿越防护的静态文件服务
3外部依赖
| 类型 | 依赖 |
|---|---|
| cli | node（运行 server.mjs；SKILL 亦用 node -e fetch 做探测） |
| cli | pgrep（探测已有 server 进程） |
| cli | open（可选，打开浏览器到本地 URL） |
4风险提醒 风险提醒：蓝色 · 知晓即可
风险提醒：蓝色 · 知晓即可
- 无鉴权回环端口暴露本地图片 — 127.0.0.1:8765 上任何本机进程/页面可枚举并读取 generated_images；共享机器上他人可访问；SKILL 未提 CORS/PNA 缓解。
- 服务常驻管理依赖 agent — 起服后 'Keep the process running for the user'——会话结束可能遗留孤儿 node 进程占端口；探测协议靠 pgrep 兜底。
- HTML 无 CSP — index.html 未见 CSP meta（静态核查），若未来加入外部内容（如粘贴不可信 HTML/URL 预览）会扩大 XSS 面；当前仅同源 JSON 数据。
风险提醒：蓝色，知晓即可。自带 Node stdlib 本地脚本、仅回环监听、无外发、无凭证、无写盘；按准则『运行自带本地脚本、仅本地读写』落 blue。注意点：无鉴权回环 HTTP 暴露 ~/.codex/generated_images 内容，本机其他用户/进程可读；现代浏览器 PNA 缓解公网页直连，但本地进程不受限——共享机器上使用需自行评估。
5第二遍独立确认
- [ok] 绑定地址与端口递增 — server.mjs 'HOST = process.env.HOST || "127.0.0.1"' + 'error.code === "EADDRINUSE" && port < DEFAULT_PORT + 20'。
- [ok] 路径穿越防护 — safePath resolve 后 prefix 校验，越界 403；decodeURIComponent 包 try/catch。
- [ok] 无外发网络/第三方依赖 — server imports 仅 node:http/fs/os/path/url；index.html 外链扫描仅同源。
- [ok] SKILL 探测复用协议可实现性 — fetch('/api/images')、pgrep pattern 'node .*server\.mjs' 与 server 实际进程命令行一致（node scripts/server.mjs）。
- [ok] 鉴权缺失的暴露半径 — 代码无任何鉴权/CORS 头；暴露限于回环（本机）——已在 risk 记录；浏览器 PNA 缓解无法在源码验证，标注为宿主/浏览器行为。
- [unlocatable] 真实浏览器端渲染验证 — index.html 视觉行为未在浏览器实测（本环境无 Codex 图片目录/浏览器），验证止于静态代码与 SKILL 自述。
6结论
适合：适合 Codex 生成图片的本地浏览/挑选：agent 在会话里快速起一个图库让用户翻看输出、对比 batch、找图；适合要零第三方依赖、纯本地、可随时 kill 的轻量场景。
不适合：不适合多用户共享机器（无鉴权暴露不可接受）或需要远程访问的图库（只绑回环）；不适合浏览非图片资产/需要缩略图管线/大目录分页的高级需求（walkImages 全量递归，无分页）；已有常驻图库服务的用户可直接复用 URL 而不必起本 skill。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-09
方式 A · 人下载镜像包下载 codex-image-gallery.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agentb2b0045b3baaf9a9…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库daymade / daymade/claude-code-skills
原始 GitHubdaymade/claude-code-skills ↗
Stars1385
最近推送2026-09-09
本 skill commit
d5c4678cb5许可MIT（仓库根 LICENSE；GitHub API spdx MIT）
本站信息
收录日期2026-09-06
分类基础工具与工作流
侦查报告2026-09-06 · 2 遍
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。