diff --git a/docs/affiliate-registration.md b/docs/affiliate-registration.md new file mode 100644 index 0000000..7f550c2 --- /dev/null +++ b/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]` 编辑（含返佣链接字段） diff --git a/docs/progress.md b/docs/progress.md index ce49062..a51f3d5 100644 --- a/docs/progress.md +++ b/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 字段 -2. **注册 AI 工具联盟账号**：对接 Canva/Copy.ai 等工具的返佣计划 -3. **内容策略**：批量生产 AI 工具评测文章做 SEO -4. **编程导师内容扩充**：按难度分级写更多 starter 问题 +1. **注册联盟账号**：按 affiliate-registration.md 优先级注册阿里云云大使、百度智能云推广大使、Canvassador、腾讯云推广大使 +2. **替换占位链接**：拿到真实联盟 ID 后替换 seed-tools-affiliate.ts 中的 `yuzhiran` 占位 +3. **生产部署**：`npm run build`（前端 SSG）+ 复制到服务器 + PM2 restart 后端 +4. **内容策略**：批量生产 AI 工具评测文章做 SEO +5. **编程导师内容扩充**：按难度分级写更多 starter 问题 ---