openclaw-voc-skill/claude-code/fmode-image-set/docs/directory-layout.md

目录与文件规范

正式安装

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

<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/

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

正式运行结果

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

<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/。
• 不自动清理真实运行结果。