# 目录与文件规范

## 正式安装

工作区安装只允许产生以下内容：

```text
<workspace>/
├── .mcp.json
└── .claude/
    ├── plugins/fmode-image-set/   # 插件运行副本与 node_modules
    └── skills/
        ├── fmode-image-set/
        ├── fmode-product-vision/
        ├── fmode-product-main-image/
        ├── fmode-detail-page/
        ├── fmode-multi-angle/
        ├── fmode-ad-creative/
        └── fmode-social-visual/
```

这些是安装文件，不是生图结果。升级时由安装器原位覆盖，不应在其他目录再复制一份。

## 正式运行结果

所有真实套图运行只允许写入：

```text
<workspace>/输出/商品套图/<商品名称>-<8位短请求标识>/
├── state.json
├── 商品原图/
│   ├── 01-商品正面.png
│   └── 02-商品背面.jpg
├── S1-1.png
├── S2-1.jpg
└── ...
```

- 运行目录名优先使用用户声明商品名，其次使用明确识图名称，并附加 request key 前 8 位；同一请求不会换目录或重复创建付费任务。
- `state.json` 是脱敏运行状态；图片文件名由计划的 `outputId` 决定。
- 部分完成、质量拒绝或提交不确定仍保留在同一个运行目录。
- 全部计划项完成后，项目根直属商品图移动到 `商品原图/`，项目子目录商品图复制到该目录；整理前重新验证真实路径和内容哈希。
- Skill 不会把结果写入插件源码、`.claude/`、项目根目录或任意自定义位置。

旧版 `outputs/fmode-image-set/run_*/` 不自动迁移或删除，状态查询和恢复继续兼容。

## 测试与临时文件

- 自动测试必须使用操作系统 Temp（Windows 通常是 `%LOCALAPPDATA%/Temp`）。
- 测试结束会删除自己的临时目录。
- 项目根目录禁止出现任何 `.tmp-*` 文件或目录。
- 测试运行器会检查前后直接子项集合；一旦新增项目根 `.tmp-*` 文件或目录，测试直接失败。

## 生命周期

| 类型 | 是否可删除 | 建议 |
|---|---|---|
| `.claude/plugins/fmode-image-set` | 不建议手动删除 | 由安装器升级；删除后 Tool 无法启动 |
| `.claude/skills/fmode-*` | 不建议手动删除 | 由安装器升级；删除后 Skill 无法发现 |
| `.mcp.json` 中本 Server 配置 | 不建议手动删除 | 删除后 MCP Tool 不可用 |
| `输出/商品套图/<商品名称>-<短标识>` | 用户确认后可删除 | 一个运行整体归档或删除，不要只删 `state.json` |
| 系统 Temp 中测试目录 | 可删除 | 正常测试会自动清理 |

## 禁止行为

- 不以日期、模型或调试名称在项目根随意新建输出目录。
- 不把真实结果混入测试目录。
- 不把测试 fixture 写到 `输出/商品套图/` 或旧 `outputs/fmode-image-set/`。
- 不自动清理真实运行结果。