nuyoah-ai-works/nuyoah-open-skill/codex-image-to-eagle

南鸢 Codex 图片归档到 Eagle

把 Codex 生成图导入 Eagle，并把最终提示词保存为可检索的注释。

默认规则

• 图片目录：优先使用 CODEX_GENERATED_IMAGES_DIR，否则使用当前用户的 ~/.codex/generated_images。
• 连接：读取 ~/.codex/config.toml 中的 Eagle MCP 配置；HTTP 回退默认使用 http://127.0.0.1:41596。
• 标签：Codex、AI生成、Prompt。
• 目录：用户未指定时使用 Codex 生成图/本地日期。
• 注释：保存完整 Prompt、来源、原路径和归档时间。
• 不删除、不移动源图片。

执行

使用随 Skill 附带的脚本：

node scripts/archive-codex-image-to-eagle.js --latest --prompt "PROMPT_TEXT"

按用户意图选择图片：

• “最新一张”使用 --latest。
• “刚才这一批 / 最新会话”使用 --latest-session。
• 明确文件使用 --path "/absolute/path/image.png"。
• 长提示词使用 --prompt-file "/absolute/path/prompt.txt"。

先准确取得实际生图使用的最终 Prompt。图片、提示词或目标目录不明确时，先加 --dry-run；明确且用户已要求归档时直接执行。

需要连接模式、文件夹 ID、自动化环境变量或完整参数时，读取 README.md 或运行：

node scripts/archive-codex-image-to-eagle.js --help

文件夹安全

1. 先解析用户指定的根目录；无指定时解析顶层 Codex 生成图。
2. 日期目录只能在已解析根目录下按“名称 + 父 ID”精确匹配，不能全局按日期名搜索。
3. 缺少日期目录时，创建时必须带根目录 parentId。
4. 同一根目录下已有重复日期目录时，复用最早的目录并报告重复，不再新建。
5. 并发自动化优先使用随附脚本，它有目录创建锁。

完成反馈

成功后返回：

• 导入的 Eagle item ID；
• 使用的 Eagle 目录；
• 实际归档的图片数量；
• 失败项及原因（如有）。

Eagle 未运行或 MCP 插件未启用时，告诉用户启动 Eagle 并启用 Eagle MCP，再继续执行。