baseline: Clover 独立仓库首次基线提交

将 Clover 从上层产品包旧仓库中独立出来,建立专属版本控制。
当前状态=纵切片端到端已打通(登录→选品→出文出图→审核→下载包),
M1文案质量去套路化已验收。此提交作为后续按核销清单逐条修复的基线。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
yangqianqian
2026-06-16 11:30:22 +08:00
commit 6a2632da70
253 changed files with 27467 additions and 0 deletions

58
开工引导.md Normal file
View File

@@ -0,0 +1,58 @@
# 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契约.mdBE/FE/AIE 再并行
- **7个停下等倩倩姐拍板的点**:契约冻结/架构选型/质量标准/违禁词/可调prompt/验收/破红线
- **铁律**banana(`O2中间件平台/banana`)、worker(`万牛会L1准备/worker`)、产品包 = 只读复制不修改key绝不进CeleryFERNET_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备用 codeproxyIMAGE_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查"代码怎么来的"看开工窗口。