madao-images

madao-images 是面向 Codex 与 SealSeek 的电商视觉规划 Skill。它从一批产品图建立可确认、可追溯的产品与人物资产台账，按默认 VI、详情页或主图组分支先规划正式图片，再从规划编译商品、人物、环境与关系资产需求，随后逐项补齐资产、逐图生成、排版、验收并保留项目记忆。

安装

npm install -g @petercjl/madao-images
madao-images doctor --json
madao-images skill install --target auto --json

测试 SealSeek 原生生图适配时安装预发布版本：

npm install -g @petercjl/madao-images
madao-images adapter status --platform sealseek --json
madao-images skill update --target sealseek --json

可单独安装到指定 Agent：

madao-images skill install --target codex --json
madao-images skill install --target sealseek --json

如果目标目录中已经存在手工维护的 madao-images，首次纳管需要显式使用 --adopt。CLI 会保留原目录备份：

madao-images skill install --target codex --adopt --json

更新

npm update -g @petercjl/madao-images
madao-images skill update --target auto --json
madao-images skill status --target auto --json

自动检测更新

CLI 每 24 小时自动检查一次当前发布通道。检查只读取公开 npm 元数据；发现新版时会提醒，但不会自动安装或覆盖 Skill。可以随时强制检查：

madao-images update check --json

单次运行不需要检查时可加 --no-update-check；持续集成或离线环境可以设置 MADAO_IMAGES_DISABLE_UPDATE_CHECK=1。更新仍由用户确认后执行：先更新 npm 包，再运行 madao-images skill update --target auto --json。

公开 npm 包 @petercjl/madao-images 中的 skill/madao-images 是唯一权威源；Agent 技能目录是受管理的安装副本。安装后的 CLI 命令仍为 madao-images。

运行依赖

• Node.js 20 或更高版本用于安装、诊断和 Skill 管理。
• Codex 生图使用 Codex 当前提供的内置图像生成能力。
• SealSeek 生图使用运行时公布的 sealseek-canvas.generate_image；默认模型为 gpt-image-2.5-sunburst，用户可以从当前运行时公布的可用模型中自行选择。每个 attempt 默认生成 1 张，最多引用 5 张有序参考图。
• 台账脚本需要 Python 3；CLI 会解析当前虚拟环境、SealSeek 管理目录中的 venv 和 PATH，也可通过 MADAO_IMAGES_PYTHON 指定解释器。
• 确定性文字排版额外需要 Pillow；CLI 会在候选解释器中选择带 Pillow 的 Python，安装要求见 Skill 内的 requirements.txt。

凭证、产品图片、项目台账、生成图片和字体不会打包进 npm。运行时产物只写入用户选择的项目目录。

状态检查

madao-images skill source --json
madao-images skill status --target auto --json
madao-images doctor --json
madao-images adapter status --platform sealseek --json

adapter status 校验包内能力合同并显示目标运行时仍需完成的验证。Agent 原生工具只能在实际 SealSeek 会话中探测，因此该命令不会伪装成已经完成付费生图测试。

当前公开版本不授予源代码再许可；包内 license 标记为 UNLICENSED。