6a2632da70
将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。 当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包), M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
59 lines
3.9 KiB
Markdown
59 lines
3.9 KiB
Markdown
# 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；查"代码怎么来的"看开工窗口。
|