6a2632da70
将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。 当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包), M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
3.9 KiB
3.9 KiB
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、不同用途，别混
四、读图顺序（新窗口按需深入）
../progress.md— 全过程+所有决策（最重要）Clover架构方案.md— v0.3 金标准（造什么）启动包/API契约.md— 唯一冻结契约（怎么对接）启动包/Agent编排开工prompt.md— 怎么拉起 agent team启动包/角色卡/01~05— 5个AI各自的岗位说明书启动包/执行约束.md— 12红线+关键节点启动包/验收清单.md— 三道验收线
五、本窗口（准备窗口）的角色
本窗口负责"准备+体检+决策"，不写产品代码。开工后查"当初为啥这么定"看本窗口对话史 + progress.md；查"代码怎么来的"看开工窗口。