# Clover 13环目标导向 · 修改+验收总纲

> 倩倩姐2026-06-12定调：以**13环目标为导向**，做交叉验证，Ralph loop循环，真质量达标、流程完整，不假性验证。
> 13环出处：`北哥回填解读与落点.md:33-49`。banana本给最硬4环引擎(找竞品/写文案/配图/裂变)，本轮补全缺失的引擎环。

---

## 〇、模型与通道（2026-06-12拍板，先改这个）

- Claude 系 → **claude-opus-4-8**（现 `gemini_factory.py:44` 写死 claude-sonnet-4-5，要改）
- GPT 系 → **gpt-5.5**（生图 gpt-image-2 不变）
- 通道：**仍只用 apiports 一套**，文案不补 codeproxy 第二路径（推翻上一版修7）
- 落点：`gemini_factory.py:44 _model_text`、`:166 MODEL_TEXT` 默认值、`.env` 的 MODEL_TEXT

> ⚠️先确认 apiports 是否真有 claude-opus-4-8 / gpt-5.5（记忆 clover-apiports-real-config 记的是 claude系+gpt5.4/5.5）。改前我会先打一个探活请求验证模型可用，不可用立即回报，不偷偷降级。

---

## 一、13环 × 现状 × 本轮动作（全景对照）

| 环 | 名称 | 现状 | 本轮 | 说明 |
|---|---|---|---|---|
| 1 | 选题 | ❌ | 不做(人工) | 热搜+爆款词库，人工环节，非系统功能 |
| 2 | **竞品爆款分析** | ❌ | **本轮补·引擎环** | =标杆8特征。banana有Invariants骨架，需北哥给8维定义 |
| 3 | 关键词 | 🟡隐含 | 随2环 | 长尾词，并入标杆分析产出 |
| 4 | 卖点 | 🟡手填 | 随2环 | 竞品评价提炼，并入标杆分析 |
| 5 | 写文案 | ✅ | 修bug | 90分过滤/品牌词/客户prompt录入/模型升级 |
| 6 | 配图 | ⚠️乱码 | 修bug+3套 | 瓶身叠字/3套差异/强制3:4 |
| 7 | 排版 | ❌空白 | 二期 | 字体模板，原始就缺，非阻断 |
| 8 | 组长审核 | ✅ | 验收 | 一票否决清单已实现，核对完整度 |
| 9 | 发布 | ✅人工 | 不变 | 不自动发，交付包人工发 |
| 10 | 复盘 | ❌ | 不做(人工) | 看数据增量，人工环节 |
| 11 | **裂变** | ❌ | **本轮补·引擎环** | 1爆款→N套完整笔记包，工作台内独立页 |
| 12 | 归档 | 🟡history | 完善 | 日期品类分类 |
| 13 | 达人 | ❌ | 不做(人工) | 蒲公英对接，人工环节 |

**本轮系统要补的引擎环 = 第2环(标杆分析) + 第11环(裂变)。**
**本轮要修真bug的环 = 第5环(文案) + 第6环(配图)。**
**核对完整的环 = 第8环(审核) + 第12环(归档)。**

---

## 二、按环组织的修改清单（替代旧三批分法，以13环为纲）

### 引擎环·第5环 写文案 — 修bug
- 修5a 90分过滤生效（pipeline_io.py:96）+ 0条回退兜底
- 修5b 品牌词字段（客户输入，产品级）→ 文案每条植入
- 修5c custom_prompt 前端录入框（现表单只有name/category，客户填不进prompt）
- 修5d 模型升级 claude-opus-4-8
- 修5e 文案网络退避重试（text_variants.py:49）

### 引擎环·第6环 配图 — 修bug+3套
- 修6a 生图3套（角度×风格×叙事结构三正交维度）
- 修6b 品牌词进特写图（第2/6张）
- 修6c 瓶身中文叠字（先最小版：只叠品牌词一处）
- 修6d 强制3:4比例（image_postprocessor.py）
- 修6e 生图 ai_call_logs 留痕

### 引擎环·第2环 竞品爆款分析（标杆8特征）— 新建【需北哥给8维定义】
- 建2a 标杆笔记加 features_json 字段+迁移
- 建2b 标杆分析service：截图/文本→AI出8特征
- 建2c 前端标杆展示8特征
- ⏸️ 阻塞：8个维度具体定义，北哥不给做不了

### 引擎环·第11环 裂变 — 新建·XL【工作台内呈现】
- 建11a 裂变表+迁移（裂变记录/参考度/维度）
- 建11b 裂变service：1爆款→N套笔记包（文案+图全重做，复用image引擎）
- 建11c 裂变router
- 建11d 前端裂变页（选爆款→参考度档位→裂变维度→看N套结果），挂工作台导航
- ⏸️ 部分阻塞：参考度档位/裂变维度具体值，参考产品包扒包落盘.md:77-84 已有方案骨架

### 配套·第8环审核 / 第12环归档 — 核对+完善
- 修8 导航404（删死链+补/review入口）
- 修10 无key置灰引导
- 建7 图片lightbox放大
- 修12a 归档按日期/品类分类（现history是平铺）

### 工程底座（贯穿所有环）
- 修底1 每用户5并发上限
- 修底2 上传magic number校验
- 修底3 开任务选标杆入口（benchmark_ids现固定空数组，第2环要用）

---

## 三、验收标准（目标导向·可勾门禁·禁假性验证）

> 每项验收=**可观测的真实结果**，不是"代码写完"。带"怎么验"的具体操作。

见 `13环验收清单.md`（独立文件，逐项可勾）。

---

## 四、Ralph loop 循环验证机制（防假性验证）

每个环改完，走固定循环，不通过不进下一环：

1. **改** — 按本环清单改代码
2. **跑** — 真实跑一次端到端（不是单测mock，是真调apiports出真文案真图）
3. **验** — 对照验收清单逐项勾，**截图/贴输出为证**
4. **交叉验** — 另起agent独立读改后代码+独立跑一次，核对结论是否一致
5. **不过则回1** — 任一验收项没真勾上，回到改，不允许"差不多了"进下一环
6. **门禁** — 每环结束自问："13环里这一环真勾上了吗？还是只是码更多了？"

**禁止的假性验证**（倩倩姐红线）：
- ❌ 只跑单元测试就说"通过"（要真端到端）
- ❌ mock掉apiports返回假数据说"能跑"（要真出图真出文案）
- ❌ "代码逻辑上应该没问题"（要真观测到结果）
- ❌ 跳过验收清单某项说"这个应该OK"（每项都要勾，勾不上如实说）

---

## 五、执行顺序建议（纵切片优先）

**P0 先把第5环+第6环修到真质量达标**（这是已能跑的主链，先让它过关）：
修5a→5b→5c→5d→5e → 6d→6e→6a→6b → 6c最小版
每步走Ralph loop。

**P1 补第2环标杆分析**（等北哥给8维定义）+ 配套修8/10/12/底1-3。

**P2 补第11环裂变**（XL，参考扒包落盘方案，工作台内独立页）。

**待北哥给的定义（卡住P1/P2，先要）：**
1. 标杆8特征具体哪8维
2. 裂变参考度档位(高/中/低)各意味多大改动、裂变维度可选哪些