# Clover 开工引导（新窗口第一份读这个）

> 这是开工窗口的入口卡。倩倩姐重开窗口、工作目录切到本目录(Clover/)后，把下面"开工第一句"贴给我即可。
> 原则：靠文件不靠记忆——准备阶段所有决策都已落盘，新窗口读文件即可接上状态。

## 一、开工第一句（直接贴给 Claude Code）

```
先读完本目录的 开工引导.md 全文（含生文生图通道配置），再读 ../progress.md 恢复项目状态，
然后读 启动包/Agent编排开工prompt.md §3，按那份 goal 模式 prompt 启用 agent team 正式开工。
开工前先跑编排prompt §1 validate 清单 + 本卡§二环境自检。配 AI 通道环境变量照本卡§三·补。
```

## 二、新窗口开工前自检（30秒确认环境就绪）

- [ ] 工作目录 = 本目录（Clover/），不是上层
- [ ] 本目录有 .claude/（门禁+rules+clover-loop 已铺，6文件）
- [ ] `jq -r '.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS' .claude/settings.json` 返回 1
- [ ] 全局 ~/.claude/settings.json 的 base_url = apiports.com（已修，子会话能连通）

## 三、关键事实（开工窗口必须知道，全已落盘细节见 progress.md）

- **模型**：全员 opus 4.8（倩倩姐拍板，质量优先不省钱）
- **门禁已是真硬的**：之前 stdin 传参 bug 已修，实测能拦改 worker/banana/偷key/危险命令
- **API中转已修**：废弃的 lvis.lol → apiports.com，子会话验证回"通了"
- **5角色全栈并行·契约优先**：Lead先冻 启动包/API契约.md，BE/FE/AIE 再并行
- **7个停下等倩倩姐拍板的点**：契约冻结/架构选型/质量标准/违禁词/可调prompt/验收/破红线
- **铁律**：banana(`O2中间件平台/banana`)、worker(`万牛会L1准备/worker`)、产品包 = 只读复制不修改；key绝不进Celery；FERNET_KEY走环境变量

## 三·补 生文生图 AI 通道配置（倩倩姐2026-06-08拍板，开工配环境变量照此）

> 复用大卫 xhs-tool 同款双通道方案（`大卫/小红书系统图片定制/xhs-tool/.env`）。主备对调：apiports 为主、codeproxy 为备。
> 🔴 key 绝不写进代码库/不进Celery，只配在环境变量；本卡只记脱敏指纹。

| 角色 | 站 url | key（脱敏，明文问倩倩姐或从大卫.env取） | 模型 |
|------|--------|------------------|------|
| **主通道** | `https://www.apiports.com`（出图端点 `/v1/api/generate`） | `CASH-lsIz…hKGp`(29位) | 出图 gpt-image-2 |
| **备用通道** | `https://codeproxy.dev/v1` | `sk-4ba…0149`(67位) | 出图 gpt-image-2 |

- **生文 + 生图都走这套**，主用 apiports，备用 codeproxy（IMAGE_PROVIDER_PRIMARY/FALLBACK 配置，不写死代码）
- **图片分析(gpt-5.5)两个站都能调，倩倩姐已验证** → 标杆分析/视觉理解不需要额外单独的视觉key
- 出图模型统一 `gpt-image-2`（实测真实名，"image2"只是俗称）；视觉 `gpt-5.5`
- ⚠️ gpt-image-2 实测出过 502 → 开工必补"生图通道重试退避"(PRD-后端§已记)
- 注意：此处 apiports 是**生图/生文通道**，与对话API的 apiports(全局settings那把CASH-8…du2G)是不同的key、不同用途，别混

## 四、读图顺序（新窗口按需深入）

1. `../progress.md` — 全过程+所有决策（最重要）
2. `Clover架构方案.md` — v0.3 金标准（造什么）
3. `启动包/API契约.md` — 唯一冻结契约（怎么对接）
4. `启动包/Agent编排开工prompt.md` — 怎么拉起 agent team
5. `启动包/角色卡/01~05` — 5个AI各自的岗位说明书
6. `启动包/执行约束.md` — 12红线+关键节点
7. `启动包/验收清单.md` — 三道验收线

## 五、本窗口（准备窗口）的角色

本窗口负责"准备+体检+决策"，不写产品代码。开工后查"当初为啥这么定"看本窗口对话史 + progress.md；查"代码怎么来的"看开工窗口。
