首页 / 全部技能 / 设计 / qiaomu-codex-imagegen
English (EN)简体中文 (ZH)日本語 (JA)
设计 · joeseesun/qiaomu-codex-imagegen

qiaomu-codex-imagegen

Generate or edit images with Codex's built-in image generation from any agent, through an MCP tool or a plain CLI. For every image request it first proposes at least four divergent style directions (24 distilled templates, 48 presets, 20 Mondo poster artists), lets the user pick, expands the prompt, generates, and checks the result. Scenario craft for 视频封面, 视频海报, 小红书配图, 公众号封面, X 封面, 朋友圈海报, 书籍封面, 专辑封面, 产品海报, 人物写真, 节气海报, 展览海报, PPT 页面, 图生图. Use for 生图, 配图, 海报, 封面, "给我几个风格", "用 Codex 画一张". Excludes: editing photos with local tools, charts or diagrams from data, UI mockups, video generation, or anything that needs an API key-based image service.

L4 高权限 · 分级授权与审计V1 已固定执行命令联网读写文件Dual-pass Audit
Author joeseesunGitHub joeseesun/qiaomu-codex-imagegen ↗License MIT（仓库根 LICENSE）Commit c03a1ccaf7
管控等级描述 skill 的能力与建议配套的管控措施，不代表质量或安全认证，也不表示可用或不可用。是否使用由用户和管理者决定。不同 agent 宿主对权限的约束各不相同，请勿假定宿主一定会提供安全兜底。第三方 skill 版权归原作者，使用风险由使用者自行承担。

1实现原理 · 为什么它能做到

把只有 Codex 内部可调用的生图能力经 `codex app-server`（stdio JSON-RPC）中继出来，再补上让图「能用」的工艺层：24 模板/48 预设/20 Mondo 设计师与一套防编造规则

SKILL.md
Codex ships an image generator that other agents cannot call. This package relays to it (`codex app-server`) and adds the craft that makes the pictures usable: a library of 24 templates (48 presets) distilled from 689 reference prompts, Mondo poster techniques, scenario presets, and a rule set for facts, text and identity.
这里在做什么：定架构——不另造生图后端，而是中继 Codex 并补上让图可用的工艺与规则。

调用入口有确定优先级：MCP 工具优先，其次本目录 CLI，两者都不可用则引导安装，并明令不得用代码伪造图片

SKILL.md
**No MCP**: run the CLI from this skill's folder: `node scripts/cli.mjs suggest|compose|generate|search|prompt|list` (see `--help`).…Neither available: tell the user to install (README). Requires the Codex CLI, logged in. Never fake an image with code.
这里在做什么：给出降级路径与反作弊红线，避免 agent 用本机绘图库画假图交差。

首次请求必须先给至少四个机制不同的方向（文字主导/平面结构/摄影/产品近摄/材料空间，外加一个 Mondo 设计师方向），且不得把两种机制混进同一张图

SKILL.md
Call `suggest_directions` with the topic, deliverable and any headline/text mode. It returns **four or more directions with different visual mechanisms** (typography-led, graphic structure, photographic, product macro, material/space, plus a Mondo artist option for poster-like work). Never mix two mechanisms into one image.
这里在做什么：把「先给方案再出图」写成硬流程；机制多样性用于对抗「同一张图换滤镜」。

海报/封面/卡片/幻灯片必须有排版层：用 exact_short 给出 headline 加 `｜` 分隔的成套短文案；只有标题或没有字，得到的是概念图而不是海报

SKILL.md
**Posters, covers, cards and slides need a typographic layer.** A finished poster has a hierarchy: headline, subtitle, one or two info lines, a small tag. With only a headline, or none, the result is concept art, not a poster.
这里在做什么：把排版层设成交付门槛，文案只能来自用户事实，缺则追问或声明为虚构样例。

提示词变量语义被约束：颜色按角色（背景/主色/强调/墨）而非固定 hex；事实与数字只能来自用户，禁止编造价格、统计、人名、日期、二维码、logo

SKILL.md
Colours are **roles** (background, primary, accent, ink), not fixed hex values.…No invented facts: prices, statistics, titles, names, dates, weather, quotes, QR codes, logos.
这里在做什么：把防编造写进生成前的变量层，而不是事后补救。

默认每个选定方向各生成一张（最多四张）并行调用，`count` 只用于同方向变体；每次生成消耗用户 Codex 额度，禁止测试性生成

SKILL.md
Default **one image per chosen direction**, up to four, each its own `generate_image` call (they can run in parallel). Use `count` only for variants of the same direction.…Each generation spends the user's quota: no test generations, `count` above 3 only if asked.
这里在做什么：控制并行度与额度消耗，防止「连打单张重试」。

生成后必须逐图对照工具打印的 acceptance_checks 复核（首眼焦点、必须成立的关系、材料位置、文字与身份、无编造），失败只改承载该关系的一句并重生成一次

SKILL.md
Read each saved image and test it against `acceptance_checks` (the tool prints them): first-glance focus, relations that must hold, materials only where intended, exact text and identity, nothing invented.
这里在做什么：把验收从「已生成」变成「看过并逐条核对」。

本地 689 条参考提示词语料只用于学习「一种机制怎么被描述」，禁止把语料提示词原样当用户提示词发送

SKILL.md
Reference corpus: `search_prompts` / `get_prompt` read the local pack of 689 reference prompts (installed on the user's machine only). Use them to study how a mechanism is described; never send a corpus prompt unchanged as the user's prompt.
这里在做什么：划清第三方语料的使用边界（可检索、可学习、不可原样转手）。

交付契约要求回报绝对路径、像素尺寸、所用方向（模板/预设或 Mondo 设计师）、假设、验收结果与 prompt sidecar 位置

SKILL.md
Reply with: absolute path(s), pixel size, direction (template/preset or Mondo artist) per image, assumptions made, acceptance result, and where the prompt sidecar is.
这里在做什么：把交付物固定为可复核清单，并要求 sidecar 记录实际提示词以便复现。

2核心能力

01MCP 七工具 + 本目录 CLI 双入口（suggest_directions / compose_prompt / generate_image / search_prompts / get_prompt / build_prompt / list_catalog）
0224 类场景模板 × 48 预设的设计系统（每类带风格锁、可替换变量、失败条件与验收项）
0313 个平台场景预设，逐条给出比例、像素尺寸、默认风格与安全区（含缩略图逻辑与标题留白）
0466 种通用风格 + 20 位 Mondo 海报设计师风格（含丝网印、负空间、书籍/专辑封面专用风格）
05图生图/改图：reference_images 接受绝对路径的身份照、产品照、风格参考或待改图
06事实/文字/身份三重规则：人物默认剪影、背影、手势或符号，身份一致必须给参考照，复杂图表与长文案事后排版
07本地 689 条参考提示词语料的检索与读取（需自建本机数据包，不随仓库分发，无数据包时功能照常）
08生成后透明区域自动压平到白底（`transparent_background: true` 可保留），并在提示词层要求背景不透明

3外部依赖

KindDependency / Endpoint
cliCodex CLI（`codex app-server --listen stdio://`；需已安装并登录、账号具备图片生成权限）
mcpMCP 客户端（Claude Code / Cursor / Codex 等注册 `scripts/mcp-server.mjs`）
env环境变量 `QIAOMU_CODEX_BIN` / `QIAOMU_CORPUS_DIR`（Codex 可执行路径与本地语料目录）

4管控建议与判定依据

建议配套管控措施
面向 Agent
分级或逐次授权，建议在沙箱运行
面向管理者
审批流程、可回滚、全程审计
判定依据（文件路径与关键语句摘要）
  • scripts/: 执行本地脚本或命令: node scripts/cli.mjs …（suggest|compose|generate|search|prompt|list，主要入口）
  • 网络端点: 声明外部网络访问: 本 skill 目录内无任何 HTTP 请求代码（风险扫描「網路請求」无命中）
  • 本地工作目录: 文件读写与工件输出: 图片输出目录（默认 ~/Pictures/qiaomu-codex-imagegen/<日期>，或用户指定 out_dir）
审计说明： 。判级对象为本 skill 目录（SKILL.md + scripts/*.mjs + references/* + docs/samples + agents + evals + reports，共约 88 个文件）。判橙依据是自 statement 用途决定的「用户素材出网」：skill 自己的脚本 scripts/lib/codex.mjs 起 codex app-server 子进程，把用户写的主题/文案与 reference_images（身份照、产品照、待改图）送进 Codex 内置生图（背后是 OpenAI 账号与额度），与站内 codex-image-to-eagle / baoyu-article-illustrator 同属生成后端类。不是 red：无逆向、无冒充、无绕过防护、无任意代码执行；skill 自身不读任何密钥（用 Codex CLI 已登录凭据），不抓外部内容、不 eval 用户输入。缓解因素：codex 子进程沙箱只允许写输出目录、approvalPolicy never、networkAccess false、交互请求一律拒绝；无测试性生成；第三方语料只做本机数据包并禁止原样转手。仍需提醒：生成会消耗用户 Codex 额度，且提示词与参考图会离开本机到模型服务。

5第二遍独立确认

  • [ok] 架构陈述与文件清单一致：SKILL.md 说 relay 到 `codex app-server`，§1 有 scripts/lib/codex.mjs(11655B) 与 scripts/mcp-server.mjs(1550B) 支撑 — §3 沙箱条目给出 scripts/lib/codex.mjs:81/87 的 approvalPolicy/ sandboxPolicy 原文，与 agents/interface.yaml:29 的 subprocess 声明互证，relay 说法成立。
  • [ok] 「无网络请求」结论：风险扫描「網路請求」标注「無命中」，与 README 大量 https:// 文档链接不矛盾 — URL 命中 26 条全部为文档/作者/上游链接（README、SKILL.md 版权行、manifest/package 的 homepage/repository），无执行期端点；出网只可能发生在 spawn 出的 codex 子进程。
  • [ok] 凭证面：只读两个路径类环境变量，不接触任何 key — §3 凭证命中 23 条中与本 skill 相关的是 QIAOMU_CORPUS_DIR / QIAOMU_CODEX_BIN，其余为 mondo 文案里的 credentials 一词与测试用 FAKE_CODEX_MODE / QIAOMU_CORPUS_DIR；无 API_KEY/TOKEN/SECRET 类读取。
  • [ok] 写盘面：29 条写盘命中集中在输出目录、sidecar、语言包与测试假图，未触及源文件 — scripts/lib/tools.mjs:144 写 sidecar；scripts/lib/png.mjs:64 写压平 PNG；scripts/build-corpus.mjs 写 ~/.local/share/.../corpus；tests/fake-codex.mjs 写 tmpdir；符合「只写输出目录」的沙箱声明。
  • [ok] 判级取样：与站内同类的 codex-image-to-eagle（orange）、ian-xiaohei-illustrations（orange）、baoyu-article-illustrator（orange）口径一致 — 同类「调用外部生图后端并消耗账号额度」均落橙；本 skill 无 red 特征（无逆向/冒充/绕过/任意执行），也无 blue 的可能（自身脚本会触发外部生成）。
  • [ok] 第三方语料授权风险已被作者显式隔离，不构成 red — README 明写 689 条语料「没有看到开放授权，所以只做成你本机的数据包，不随仓库分发」，SKILL.md 亦禁止原样转手；仅记为 verdict.risks。
  • [ok] meta 核定值核对：license MIT、official_desc 逐字取自 SKILL.md frontmatter、commit 与 audit 一致 — commit=c03a1ccaf77938257bb93f64e09afa9cd08efe29，与骨架 audit.skill_commit 相同；stars/last_push/installs 维持 null（无 per-skill 可定位值）。

6结论

  • 把 Codex 独占的生图能力真正解耦出来：同一套核心同时提供 MCP、CLI 和 Agent Skill 三种接口，任何能执行命令的 agent 都能用，且优先级与降级路径写得明确
  • 「先给至少四个机制不同的方向，用户选定后再出图」是本仓最像设计工作室的地方，把生图从「给一句 prompt 抽一次」变成有方案评审的流程
  • 防编造与排版层写成了硬约束（文字模式、exact_short 成套文案、颜色按角色、事实只来自用户、不得伪造图），比同类生图技能更强调可交付性
  • 额度与执行面自律：禁止测试性生成，每次调用独立临时会话，沙箱只写输出目录、审批 never、交互请求全拒，且零依赖（Node 18+）
  • 第三方法律自觉：小小东 689 条语料因授权不明只做本机数据包并禁止原样转手，且明说模板提炼的是机制不是原图复刻
    • 适合： 需要在任何 agent（Claude Code / Codex / Cursor 等）里批量产出视频封面、小红书配图、公众号头图、海报、封面、PPT 页面或做图生图改图的用户；尤其适合愿意先看方案再定稿、重视文案与事实不出错的品牌/内容团队。已有 Codex CLI 与登录、并能接受额度消耗的环境最顺手。
    不适合： 不适用：想用纯本地工具修图、想用数据画图表/流程图、要 UI mockup、要生成视频，或只能用 API key 式图像服务（非 Codex）的场景。没有 Codex CLI 或不愿消耗账号额度的环境不要用。
    Install Agent-Ready
    ① Verified Mirror 2026-10-10
    Option A · Direct DownloadDownload qiaomu-codex-imagegen.tar.gz
    sha256: 30d89f420fcbc925…
    Option B · Copy Guide for Agent
    install.json
    agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit c03a1ccaf7.