# Fmode Image Set

面向 Claude Code 的电商商品套图 Skill。用户提供一张商品图和一句需求，系统完成商品事实审计、七图规划、逐图 Prompt 校验，并在用户明确授权后调用即梦生成。

## 能力

- 识别商品可见事实，分离推断与未知项；
- 锁定商品外观、Logo、包装文字和不可新增结构；
- 规划 1 张主图、2 张场景图、2 张卖点图、2 张购买决策图；
- 校验卖点证据、角色配额、构图多样性和 Prompt 完整性；
- 串行调用即梦并下载成品；
- 对生成商品进行身份复核；
- 支持同一运行恢复、费用上限和交付完整性审计。

## 目录

```text
.claude-plugin/          Claude Code 插件元数据
bin/                     安装与命令行入口
docs/                    能力地图、快速开始、验收和交付物合同
mcp/src/core/            路径、状态签名和结果信封
mcp/src/features/        套图编排、视觉理解和计划校验
mcp/src/providers/       Claude 附件、视觉模型、七牛、即梦适配
mcp/src/tools/           MCP/CLI 薄入口
memory-templates/        默认套图偏好模板
scripts/                 smoke 与 acceptance
skills/fmode-image-set/  Skill 入口、references 和 Agent 元数据
```

## 安装

当前目录检查：

```powershell
npm install
npm run install:check
npm run smoke:package
npm run mcp:smoke
```

安装到当前 Claude Code 工作区：

```powershell
node bin/fmode-image-set.js workspace --smoke
```

安装后会写入：

```text
.mcp.json
.claude/skills/fmode-image-set/   完整交付包，同时包含根级 Skill 发现入口
```

## 使用

在 Claude Code 中上传商品图并说：

```text
给这款商品做一套高级、适合电商详情页的七图。
```

只规划、不生图：

```text
先帮我规划这套图，不要实际生图。
```

## MCP 工具

- `fmode_image_set_run`
  - `start`：创建运行并完成商品视觉理解；
  - `execute`：在计划通过且用户授权后生图；
  - `resume`：恢复同一个运行；
  - `status`：只读查看状态。
- `fmode_image_set_validate`
  - 校验 `prompt-plan.json`，不调用生图模型。

## 运行产物

默认写入项目目录：

```text
生成结果/电商七图/<run_id>/
├── 商品附件/
├── 成品图/
├── vision-result.json
├── prompt-plan.json
├── reference-assets.json
└── jimeng-result.json
```

## 安全边界

- 未经用户明确授权不执行付费生图；
- 默认费用上限为 1.54 元；
- `submission_unknown` 不自动重提；
- 商品身份复核失败的图片不作为合格交付；
- 不复制其他运行的图片补齐当前运行；
- Token 不进入计划、报告或日志。