docs: 新增返佣注册指南 + 进度更新至 P8.3

- affiliate-registration.md: 收录阿里云/百度云/腾讯云/Canva/WPS/讯飞
  等平台的注册入口、佣金比例、操作流程
- progress.md: 新增 P8.2（返佣工具库扩充）和 P8.3（模型合规优化）

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

docs/affiliate-registration.md

@@ -0,0 +1,141 @@
+# AI 工具推广返佣 — 联盟平台注册指南
+
+> 本文档收录所有已接入或有计划接入的返佣联盟平台，包含注册入口、申请流程、佣金说明及当前状态。
+
+---
+
+## 一、已接入（占位链接，待替换真实 ID）
+
+以下工具的返佣链接已在线上使用 `yuzhiran` 占位 ID，注册后替换即可生效：
+
+| 工具 | 平台 | 返佣比例 | 注册入口 | 当前链接 |
+|------|------|---------|---------|---------|
+| 通义千问 | 阿里云云大使 | 首购最高 45% | [aliyun.com/minisite/goods](https://www.aliyun.com/minisite/goods) | `?userCode=yuzhiran` |
+| 文心一言 | 百度智能云推广大使 | 新客 30-40% | [cloud.baidu.com](https://cloud.baidu.com) | `?from=yuzhiran` |
+| Canva | Canvassador 计划 | 年付 $36/单 | [canva.cn/join](https://www.canva.cn/join/) | `/join/yuzhiran` |
+| 腾讯元宝 | 腾讯云推广大使 | 新客 20-35% | [cloud.tencent.com/act/cps](https://cloud.tencent.com/act/cps) | `?from=yuzhiran` |
+| 讯飞星火 | 科大讯飞推广计划 | AI 办公/教育 25-35% | [xfyun.cn](https://www.xfyun.cn) | `?from=yuzhiran` |
+
+### 替换流程
+
+1. 注册以上联盟计划，获取真实的推广 ID / userCode
+2. 更新 `backend/prisma/seed-tools-affiliate.ts` 中的 `affiliateLink`
+3. 重新运行 seed：`cd backend && npx tsx prisma/seed-tools-affiliate.ts`
+4. 验证前端工具页显示正确的链接
+
+---
+
+## 二、推荐注册（高优先级）
+
+### 2.1 阿里云云大使
+
+| 项目 | 说明 |
+|------|------|
+| **佣金** | 首购订单佣金最高 45%，大模型/AI 产品 10-30% |
+| **结算** | 月度结算，支付宝提现 |
+| **门槛** | 个人即可注册，无需公司资质 |
+| **适配场景** | 你的用户多为 AI 学习者/开发者，天然需要云资源 |
+| **注册步骤** | ① 访问 [aliyun.com](https://www.aliyun.com) → ② 注册/登录阿里云账号 → ③ 搜索"云大使" → ④ 进入云大使页面申请成为大使 → ⑤ 获取推广链接 userCode |
+| **推广素材** | 平台提供 banner、落地页、文案模板 |
+| **申请入口** | [https://www.aliyun.com/ambassador](https://www.aliyun.com/ambassador) |
+
+### 2.2 百度智能云推广大使
+
+| 项目 | 说明 |
+|------|------|
+| **佣金** | 新客订单 30-40%，AI/大模型产品高分成 |
+| **结算** | 月度，银行转账 |
+| **门槛** | 个人可申请 |
+| **适配场景** | 已推广 DeepSeek + 文心一言，自然延伸 |
+| **注册步骤** | ① 访问 [cloud.baidu.com](https://cloud.baidu.com) → ② 注册百度账号 → ③ 控制台搜索"推广大使" → ④ 提交申请 → ⑤ 获取推广链接 |
+| **申请入口** | [https://cloud.baidu.com/campaign/Ambassador](https://cloud.baidu.com/campaign/Ambassador) |
+
+### 2.3 腾讯云推广大使
+
+| 项目 | 说明 |
+|------|------|
+| **佣金** | 新客 20-35%，最高月佣 8 万 |
+| **结算** | 月度 |
+| **门槛** | 个人可申请 |
+| **适配场景** | 云服务器是 AI 学习者刚需 |
+| **注册步骤** | ① 访问 [cloud.tencent.com](https://cloud.tencent.com) → ② 注册腾讯云账号 → ③ 控制台搜索"推广" → ④ 申请推广大使 → ⑤ 获取 CPS 链接 |
+| **申请入口** | [https://cloud.tencent.com/act/cps](https://cloud.tencent.com/act/cps) |
+
+---
+
+## 三、拓展推荐（中期接入）
+
+### 3.1 Canva Canvassador
+
+| 项目 | 说明 |
+|------|------|
+| **佣金** | 每推荐一个 Canva Pro 年付用户，佣金 **$36 USD**（约 ¥260） |
+| **结算** | PayPal，每月结算 |
+| **门槛** | 任何有社交媒体/网站的个人均可申请 |
+| **适配场景** | 工具库已有 Canva 入口，设计类用户匹配度高 |
+| **注册步骤** | ① 访问 [canva.com/p/canvassador](https://www.canva.com/p/canvassador) → ② 提交申请（审核 1-2 周） → ③ 审核通过后获取专属推荐链接 → ④ 更新 seed 中的 Canva 链接 |
+| **注意** | Canva 有 canva.cn 国内版域名，Canvassador 计划全球通用，PayPal 收款 |
+
+### 3.2 WPS AI（金山办公）
+
+| 项目 | 说明 |
+|------|------|
+| **佣金** | 会员推广约 30% |
+| **注册步骤** | 访问 [union.wps.cn](https://union.wps.cn) 注册 |
+| **建议** | 中等优先级——WPS AI 适合办公效率课程引流 |
+
+### 3.3 科大讯飞推广计划
+
+| 项目 | 说明 |
+|------|------|
+| **佣金** | AI 办公/教育产品 25-35% |
+| **注册** | 访问 [xfyun.cn](https://www.xfyun.cn) 搜索"推广大使" |
+| **适配** | 教育场景有天然优势，与"教育学习"分类吻合 |
+
+---
+
+## 四、暂不接入
+
+| 平台 | 原因 |
+|------|------|
+| OpenAI Partner | 需美国公司资质，OpenAI 在中国大陆不可直接销售 |
+| ChatGPT Affiliate | 不支持中国大陆用户注册和收款 |
+| Midjourney / Runway / Perplexity / Cursor | 无公开联盟计划 |
+| 印象笔记 / Notion | 与 AI 工具主题偏离 |
+
+---
+
+## 五、注册优先级排序
+
+```
+第一周：
+  ├── 阿里云云大使        ← 佣金最高(45%) + 用户画像最匹配
+  └── 百度智能云推广大使   ← 已用占位链接，优先替换
+
+第二周：
+  ├── 腾讯云推广大使       ← 云服务刚需，稳定收入
+  └── Canva Canvassador   ← 审核周期 1-2 周，尽早提交
+
+第三周：
+  ├── WPS 推广联盟         ← 会员返佣稳定
+  └── 科大讯飞推广大使     ← 教育场景补充
+
+长期关注：
+  └── 字节豆包推广活动      ← 不定期开放
+```
+
+## 六、技术接入
+
+### 链接替换
+
+注册后，更新 `backend/prisma/seed-tools-affiliate.ts` 中的 `affiliateLink`，然后运行：
+
+```bash
+cd backend && npx tsx prisma/seed-tools-affiliate.ts
+```
+
+### 验证
+
+1. 访问 `/tools` — 有返佣链接的工具显示绿色 **推荐** Badge
+2. 点击跳转到带正确联盟参数的地址
+3. 管理员可在 `/admin/tools/new` 创建，`/admin/tools/[id]` 编辑（含返佣链接字段）

docs/progress.md

@@ -71,11 +71,35 @@ cd backend && node prisma/update-skill.cjs  # 如果 system prompt 需要更新
 | **项目文档更新** | README.md 全面重写（技术栈、产品定位、功能表）；AGENTS.md 定位同步 | ✅ |
 | **生产部署** | 127 页面全部部署并验证 courses 详情页 200 OK | ✅ |
 
+### P8.2 — 返佣工具库扩充 + 管理后台完善（2026-06-23）
+
+| 子项 | 说明 | 状态 |
+|------|------|------|
+| **Admin 新建工具页** | 添加 `affiliateLink`（返佣链接）输入字段 + 提示文案 | ✅ |
+| **Admin 编辑工具页** | 重写为可编辑表单（原为只读展示且不保存）；添加 affiliateLink + PUT 保存 | ✅ |
+| **seed-enrich 破坏性修复** | `deleteMany()` → `upsert` by name，避免重新运行 seed-enrich 时清除国内工具 | ✅ |
+| **新增国内 AI 工具** | 豆包、通义千问、文心一言、WPS AI、Canva、腾讯元宝、讯飞星火、剪映专业版（8个） | ✅ |
+| **返佣链接配置** | 通义千问(阿里云云大使)、文心一言(百度智能云)、Canva(Canvassador)、腾讯元宝(腾讯云)、讯飞星火 共 5 个工具配置真实风格推广链接 | ✅ |
+| **工具总数** | 原有 6 个 + 新增 8 个 = **14 个工具**，其中 8 个有返佣链接 | ✅ |
+
+### P8.3 — 沙盒模型合规优化 + 返佣注册文档（2026-06-23）
+
+| 子项 | 说明 | 状态 |
+|------|------|------|
+| **AI Gateway 清理** | 移除 GPT-3.5/GPT-4/Claude/Llama 等境外模型引用，MODEL_CATALOG 仅保留国内已备案模型 | ✅ |
+| **modelMap 净化** | chat() 和 chatStream() 中的 modelMap 仅路由到国内 provider（移除 general/openai/gpt/longcat） | ✅ |
+| **provider 命名清晰化** | "OpenAI 兼容接口" → "硅基流动 / DeepSeek"，明确标注实际调用的国内服务商 | ✅ |
+| **沙盒可用模型 API** | 新增 `GET /sandbox/models` 端点，返回实际可用的模型列表（按 provider 注册状态动态过滤） | ✅ |
+| **前端模型列表** | ModelSelector 改为从 `/sandbox/models` 获取，不再从 `/public/models`（百科模型列表）获取 | ✅ |
+| **models.ts 清理** | 移除 foreign 模型，仅保留 deepseek-v4-flash 和 sensenova-6.7-flash-lite，DEFAULT_MODEL 改为 domestic | ✅ |
+| **返佣注册指南** | 新建 `docs/affiliate-registration.md`，收录 7 个平台的注册入口、佣金比例、申请流程 | ✅ |
+
 ### 待办/下一步
-1. **为工具库加返佣链接**：在管理后台 `/admin/tools/new` 和编辑页录入 affiliateLink 字段
+1. **注册联盟账号**：按 affiliate-registration.md 优先级注册阿里云云大使、百度智能云推广大使、Canvassador、腾讯云推广大使
-2. **注册 AI 工具联盟账号**：对接 Canva/Copy.ai 等工具的返佣计划
+2. **替换占位链接**：拿到真实联盟 ID 后替换 seed-tools-affiliate.ts 中的 `yuzhiran` 占位
-3. **内容策略**：批量生产 AI 工具评测文章做 SEO
+3. **生产部署**：`npm run build`（前端 SSG）+ 复制到服务器 + PM2 restart 后端
-4. **编程导师内容扩充**：按难度分级写更多 starter 问题
+4. **内容策略**：批量生产 AI 工具评测文章做 SEO
+5. **编程导师内容扩充**：按难度分级写更多 starter 问题
 
 ---