# 安装技能：主图详情蒸馏

你是用户的 AI 助手。用户希望你安装这个技能，并带着用户把它配置到能正常使用。请按下面的顺序做，不要跳步。

## 技能信息

- 技能名：zhengliu-skill
- 版本：v3（2026-10-20 12:41 发布）
- 作者：店智效官方
- 下载地址：https://dianzhixiao.yinceqiyeguanli.com/skills/zhengliu-skill/download?version=3
- SHA-256：a0b94725b8964382926f0858bb0e033524adfad90efe06597912f11c2de8feca
- 大小：61 KB，16 个文件
- 技能页面：https://dianzhixiao.yinceqiyeguanli.com/skills/zhengliu-skill

## 作者提供的使用说明

### 具体功能
扫描用户指定的主图与详情目录，识别重复素材并生成标注骨架。先还原详情设计屏，分析总屏数、每屏的设计方向与内容、商品人物场景展示、排版文案及整页节奏，再标注主图并检查整套的风格、人物外观和商品一致性。输出 7 张主图（首图 3 版及第 2—5 张）与可变 N 屏详情的制作规则、逐屏提示词、可执行 layout.json、统计和回测记录，支持详情拼片、分屏还原与顺序对比。

### 使用方法
把参考素材目录发给 AI，并说明“用主图详情蒸馏分析这批主图和详情，每款作为完整一套”。AI 按扫描、详情还原及逐屏分析、主图标注、整套一致性检查、统计、规则编写、校验和回测执行。详情屏数由商品内容和实际设计模块决定，不按文件数或固定屏数套用。资料默认保留在技能自身 state/cache/<任务名>-已处理图片/，仅明确要求导出时指定其他目录。

### 运行条件
Python 3.9+、Pillow、NumPy，以及能查看本机图片的 AI 工具。排字需要本机可用字体；回测需要可用生图工具，没有时由用户按提示词提供底图。

### 配置
安装后进入 SKILL.md 所在目录，执行 python -m pip install -r requirements.txt。由使用者提供参考素材目录，不预设个人目录。按实际素材核对主图、详情、SKU 等分类；在 layout.json 的 fonts 中配置本机字体，按工具能力选择原生 4K 或 2K。目录关键词和默认尺寸可在 config/defaults.json 中调整。

### 注意事项
只蒸馏规则并用回测校准，不交付客户正式商品图片。详情的一屏是完整设计模块，不等于一个文件或手机可视高度。参考容量、材料、功效和价格不能未经核实移植到新商品。保留商品真实品牌字形及图案，文案最后用代码排字；禁止非必要添加光影，不以插值放大冒充原生高清。任务资料留在技能内部缓存，不混入商品图片交付目录，也不生成任务压缩包。

## 第 1 步：下载并核对

1. 下载上面的技能包（zip）。
2. 计算文件的 SHA-256，必须和上面完全一致。不一致就停下，告诉用户“下载的文件和官网记录不一致”，不要安装。

## 第 2 步：放进技能目录

压缩包里只有一个 `zhengliu-skill` 文件夹，把它解压到你读取技能的目录：

- Codex：`~/.codex/skills/`
- WorkBuddy：`~/.workbuddy/skills/`
- Claude Code：`~/.claude/skills/`
- 其他工具：放进它的技能目录；没有技能目录的，放在用户指定的文件夹，以后每次先读其中的 SKILL.md。

已经装过旧版本时，直接解压覆盖同名文件，不要先删除旧文件夹：里面可能有用户自己的配置和数据。这一步只解压，不要运行技能里的脚本。装好后，如果你的工具要重新打开才能识别新技能，告诉用户怎么做。

## 第 3 步：先跟用户讲清楚

读完 `zhengliu-skill/SKILL.md` 后，先用两三句话告诉用户：

1. 这个技能能做什么、平时怎么用。
2. 要用起来，需要用户配合准备或配置哪些东西，列成清单。

SKILL.md 里有“装好后先做”“首次配置”之类的章节时，严格按它来，包括运行它要求的检查命令。

## 第 4 步：一步一步带用户配置

按清单一项一项来，一次只做一项：告诉用户这一步做什么、在哪里做；需要用户亲自操作的（登录、粘贴密钥、授权、在别的软件里选择文件夹等）请用户自己完成。不要让用户把密码、密钥发在聊天里。每完成一项就检查结果，确认没问题再做下一项。

## 第 5 步：确认能正常使用

全部配置完成后，按技能说明做一次检查或试运行，确认能正常使用，再告诉用户已经装好、以后怎么用。技能需要用户在其他软件里填写的路径或设置（例如插件里的下载文件夹），把这台电脑上的完整路径原样告诉用户。

## 以后更新

装好后告诉用户：以后要更新，打开技能页面 https://dianzhixiao.yinceqiyeguanli.com/skills/zhengliu-skill，再复制一次安装指令发给 AI 就行；AI 会按同样的步骤下载最新版本覆盖安装，用户自己的配置和数据不受影响。