# 中国版部署方案 · 完全用国内 AI 引擎

> 把 Cloudflare / Groq / OpenRouter / HuggingFace 全部换成<strong>国内厂商</strong>。
> 大陆用户直接访问、人民币支付、不用 VPN、不需备案（如果用海外节点的中国云）。

---

## 一、四套替换方案对比

我们要替换的 4 个组件：

| 用途 | 海外原方案 | 国内对应 |
|---|---|---|
| **AI 推理（默认主力）** | Groq Llama-3.3-70B | **DeepSeek**（最便宜）/ 通义千问 / Kimi |
| **AI 推理（备选 / 多模型）** | OpenRouter | **通义百炼 (Dashscope)** 或 **火山方舟** —— 都是聚合多家 |
| **服务器运行 worker** | Cloudflare Workers | **腾讯云 EdgeOne Functions** 或 **阿里云函数计算 FC** |
| **Embedding（中文）** | HuggingFace bge-small-zh | **通义 text-embedding-v3** 或 **智谱 embedding-3** |
| **图像生成** | Cloudflare Flux | **通义万相**（Wanx）或 **豆包图像** |
| **语音转文字** | Groq Whisper | **浏览器原生 Web Speech API**（首选，免费）+ **讯飞** 或 **通义听悟**（备选） |

---

## 二、推荐架构 · 中国版

```
            [孩子的浏览器（中国大陆）]
                    │
            kindlingAI.chat({ ... })
                    │
                    ▼
       ┌───────────────────────────────┐
       │ 你的服务器（在国内）              │
       │ ai.你的域名.com / .cn           │
       │ 跑在 EdgeOne Functions          │
       │  或阿里云函数计算 FC             │
       └───────────────────────────────┘
                    │
        ┌───────────┼───────────────┬─────────────┐
        ▼           ▼               ▼             ▼
   [DeepSeek]  [通义百炼]      [通义万相]    [智谱 GLM]
   主力，便宜    多模型聚合      图像生成      备选 + 推理 (GLM-Z1)
   ¥0.5/M tok  ¥1-30/M tok    ¥0.16/张      免费层 / ¥1-5/M
```

---

## 三、各家详细对比

### 1. AI 推理供应商（推荐顺序）

| 供应商 | 最强模型 | 中文质量 | 价格（输入 / 输出，¥/百万 token）| 免费额度 | 推荐场景 |
|---|---|---|---|---|---|
| **DeepSeek** | DeepSeek-V3.2 / R1 | ⭐⭐⭐⭐⭐ | **¥0.5 / ¥1.5**（V3）；R1 推理 ¥1 / ¥4 | 注册送 ¥10 | **默认首选**：超便宜、质量极高、注册简单 |
| **通义千问 (Dashscope/百炼)** | Qwen-Max / Qwen3 | ⭐⭐⭐⭐⭐ | ¥0.4-30 视模型 | 大部分模型有免费层（如 qwen-turbo 免费 100 万 tok） | 中文最强、模型最全 |
| **Kimi (Moonshot)** | k2 / k1.5 | ⭐⭐⭐⭐ | ¥1 / ¥3（128k）；¥6 / ¥18（200k） | 注册送 ¥15 | 长文本场景王者（200 万字上下文） |
| **智谱 GLM** | GLM-4.6 / GLM-Z1 | ⭐⭐⭐⭐ | ¥0.5 / ¥4 | 部分模型免费 | 推理强、有免费 GLM-Z1-Flash |
| **百度文心一言 (Qianfan)** | ERNIE-4.5 / X1 | ⭐⭐⭐⭐ | ¥1-120 视模型 | 部分免费 | 老牌、企业接入多 |
| **火山引擎方舟 (字节)** | 豆包 1.5 Pro / Doubao | ⭐⭐⭐⭐ | ¥0.8-9 | 注册赠送 | 字节系生态、价格透明 |
| **MiniMax** | abab7 / 海螺 | ⭐⭐⭐⭐ | ¥1-10 | 部分免费 | 角色扮演 / 语音场景强 |
| **讯飞星火** | Spark Lite / Pro | ⭐⭐⭐ | ¥1.5-30 | Spark Lite 完全免费 | 适合"完全不花钱"模式 |

**最佳搭配**：
- **主力**：DeepSeek-V3（便宜 + 好）
- **备选**：通义千问 Qwen-Plus（中文场景升级）
- **完全免费降级**：智谱 GLM-Z1-Flash 或 讯飞 Spark Lite

### 2. 多模型聚合 API（替代 OpenRouter）

| 平台 | 支持模型数 | 优势 |
|---|---|---|
| **通义百炼 (bailian.console.aliyun.com)** | Qwen 全系列 + Llama / DeepSeek / 文心 / 智谱 等 30+ | 阿里官方背书，模型最全，可一个 key 调多家 |
| **火山方舟 (volcengine.com/product/ark)** | 豆包 + DeepSeek + Qwen 等 20+ | 字节系，速度快，企业级可靠性 |
| **硅基流动 SiliconFlow (siliconflow.cn)** | Qwen / DeepSeek / Llama / Stable Diffusion 等 50+ | **类 OpenRouter 体验，OpenAI 兼容 API**，注册送 ¥14 |
| **OpenRouter 国内代理（不推荐）** | 一些第三方有，但稳定性差 | 可作为最后手段 |

**强烈推荐 [硅基流动 SiliconFlow](https://siliconflow.cn)** —— 这是国内最像 OpenRouter 的平台：
- 一个 key 调几十个模型
- OpenAI 完全兼容（代码不改一行）
- 大陆访问极稳定、人民币支付
- 注册送 ¥14 试用

### 3. 服务器（替代 Cloudflare Workers）

中国大陆部署 worker 有 3 个选项：

#### 选项 A · 腾讯云 EdgeOne Pages 和 Functions（最像 Cloudflare）
- [edgeone.ai/zh](https://edgeone.ai/zh) —— 国内访问极快
- 函数 + 边缘网络，<strong>免费层每月 100 万次请求</strong>
- 体验最接近 Cloudflare Workers
- ✅ **首选推荐**

#### 选项 B · 阿里云函数计算 FC
- [fcnext.console.aliyun.com](https://fcnext.console.aliyun.com)
- 免费层每月 100 万次调用 + 400000 GB-秒
- 接 SLB 或 API 网关做 HTTP endpoint
- 配置稍复杂但能力最全

#### 选项 C · Vercel China 替代品 · Sealos / Zeabur
- [Sealos.io](https://sealos.io) 提供云开发环境
- [Zeabur.com](https://zeabur.com) 一键部署各种语言
- 适合不想配置云服务的人

### 4. 图像生成

| 模型 | 价格 | 质量 | 特点 |
|---|---|---|---|
| **通义万相 (Wanx 2.1 / 2.5)** | ¥0.16-0.34/张 | ⭐⭐⭐⭐⭐ | 中文 prompt 理解最好 |
| **豆包图像 (Doubao Image)** | ¥0.20/张 | ⭐⭐⭐⭐ | 字节系、稳定 |
| **智谱 CogView-4** | ¥0.06/张 | ⭐⭐⭐⭐ | 便宜，质量 OK |
| **百度文心一格** | ¥0.20-0.50/张 | ⭐⭐⭐ | 老牌 |

**推荐**：通义万相 2.5（质量最好）或 CogView-4（最便宜）。

### 5. Embedding（中文）

| 模型 | 价格 | 维度 |
|---|---|---|
| **通义 text-embedding-v3** | ¥0.5/M tok | 1024 |
| **智谱 embedding-3** | ¥0.5/M tok | 2048 |
| **DeepSeek embedding** | 暂未开放 | — |

**推荐**：通义 v3（最常见，质量好）。

### 6. 语音

- **首选**：浏览器原生 Web Speech API（Chrome / Edge 都支持中文，<strong>完全免费、零配置</strong>）—— 不需要换
- **服务端 ASR 备选**：通义听悟、阿里 Paraformer、讯飞、腾讯 ASR

---

## 四、备案问题（重要！）

如果你的<strong>服务器在中国大陆境内</strong>（阿里云、腾讯云的国内节点），需要：

1. **ICP 备案**：约 2-3 周，免费，要求企业 / 个体户资质
2. **公安备案**：网站上线后 30 天内，免费

**怎么避免**：
- ✅ <strong>用海外节点</strong>：阿里云香港、腾讯云香港、Cloudflare 等 —— 不需要备案
- ✅ <strong>用 EdgeOne</strong>：腾讯云 EdgeOne 默认走全球边缘节点，可能不需要备案（确认下当前政策）
- ✅ <strong>静态网站 + AI API 单独部署</strong>：网站托管在海外（GitHub Pages / Cloudflare Pages），只 AI 后端用国内云

最省事的方案：**网站继续用 GitHub Pages + AI 后端用硅基流动（不需要自己部署 worker）**。

---

## 五、最简方案 · 完全不需要部署 worker

如果你不想搞 worker、不想备案、不想配域名，<strong>最快上线方案</strong>：

### 核心思路：硅基流动允许"前端直连"+ 设置允许域名白名单

**步骤**：

1. 注册 [硅基流动 SiliconFlow](https://siliconflow.cn)，充 ¥10
2. 创建一个 API key，设置"允许的来源域名"为你的网站域名（如 `kindling-edu.cn`）
3. 在前端 SDK 里直接调硅基流动 API（OpenAI 兼容格式）

**安全性**：硅基流动后台限制了"只能从某个域名调"，所以即便 key 被前端看见，别人也<strong>不能从别的网站盗用</strong>。

代码大致这样：
```js
// kindling-ai-sdk-china-direct.js
const SF_KEY = 'sk-xxxxx';   // 这个 key 已经被锁定到你的域名
const SF_URL = 'https://api.siliconflow.cn/v1/chat/completions';

async function chat({ system, user }) {
  const res = await fetch(SF_URL, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${SF_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'deepseek-ai/DeepSeek-V3',
      messages: [
        { role: 'system', content: system },
        { role: 'user', content: user },
      ],
      stream: false,
    }),
  });
  return await res.json();
}
```

⚠️ **注意**：硅基流动确实支持白名单（叫"Origin 限制"），但请<strong>仔细确认</strong>当前是否有这个功能。如果没有，还是要走 worker 方案。我下面假设有，因为绝大多数国内 API 平台都支持。

---

## 六、推荐的"完全国产化"上线路径

### 路径 A · 最省心（适合一个人 + 不想运维）

```
[GitHub Pages / Cloudflare Pages] ← 网站静态托管，免费、不要备案
        ↓
[硅基流动 SiliconFlow] ← AI 调用，前端直连，¥10 试水
        ↓
完成。无 worker、无备案、无服务器、无运维。
```

**首月成本**：约 **¥10-30**（硅基流动充值）

### 路径 B · 国内全栈（适合长期用、流量大）

```
[国内 GitHub 平替（Gitee Pages / 自建静态托管）] ← 备案后走国内 CDN
        ↓
[腾讯云 EdgeOne Functions / 阿里云 FC] ← worker 跑国内
        ↓
[DeepSeek + 通义百炼 + 通义万相] ← 主力 AI
        ↓
完成。完全国内，国内孩子访问飞快。
```

**首月成本**：约 **¥50-100**（含小流量 + 备案文档准备成本）

### 路径 C · 海外 worker + 国内 AI（折中）

```
[GitHub Pages] ← 静态托管
        ↓
[Cloudflare Workers]（海外节点不需备案，对中国访问也较快）
        ↓
[DeepSeek API] ← 国内 AI，¥/月支付
        ↓
完成。Worker 是海外的（不用备案）但 AI 全是国内的。
```

**首月成本**：约 **¥30-50**

---

## 七、3 个最关键的供应商 · 注册链接 + 拿 key

### 1. DeepSeek（首选，最便宜，质量极高）

1. 打开 [https://platform.deepseek.com](https://platform.deepseek.com)
2. 微信或邮箱注册
3. 注册送 ¥10 试用额度
4. 控制台 → "API Keys" → "创建 API key"
5. 复制 `sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx`
6. 充值（最少 ¥1，建议先充 ¥10-20）

**API 兼容性**：完全 OpenAI 兼容。
**价格**：DeepSeek-V3.2 = ¥0.5 输入 + ¥1.5 输出（每百万 token）。
**比 GPT-4 便宜 100 倍**，质量接近。

### 2. 硅基流动 SiliconFlow（多模型聚合，类 OpenRouter）

1. 打开 [https://siliconflow.cn](https://siliconflow.cn)
2. 微信注册
3. 注册送 ¥14 试用
4. 控制台 → "API 密钥" → 创建
5. 复制 key

**模型选择**：
- DeepSeek-V3 / R1
- Qwen2.5-72B
- Llama-3.3-70B
- Stable Diffusion / Flux 系列（图像）
- BAAI/bge-large-zh-v1.5（embedding）

**API 兼容性**：完全 OpenAI 兼容。一个 key 通吃。

### 3. 通义千问 Dashscope / 百炼平台

1. 打开 [https://bailian.console.aliyun.com](https://bailian.console.aliyun.com)
2. 用阿里云账号登录（需要先有阿里云账号，免费注册）
3. 实名认证（免费、5 分钟）
4. 进入"API-KEY 管理" → "创建"
5. 复制 `sk-xxxxxxxx`

**价格**：很多模型有免费层。Qwen-Turbo 完全免费 100 万 token / 月。
**API**：兼容 OpenAI 格式。

---

## 八、改 worker.ts 用 DeepSeek（5 分钟）

把 `worker/worker.ts` 里的两段改一下：

**原版**（用 Groq）：
```ts
upstream = {
  url: 'https://api.groq.com/openai/v1/chat/completions',
  key: env.GROQ_API_KEY,
  model: 'llama-3.3-70b-versatile',
};
```

**中国版**（用 DeepSeek）：
```ts
upstream = {
  url: 'https://api.deepseek.com/v1/chat/completions',
  key: env.DEEPSEEK_API_KEY,
  model: 'deepseek-chat',  // 默认是 V3，最新最快
};
```

OpenRouter 那段也改成硅基流动：
```ts
upstream = {
  url: 'https://api.siliconflow.cn/v1/chat/completions',
  key: env.SILICONFLOW_API_KEY,
  model: body.model || 'Qwen/Qwen2.5-72B-Instruct',
};
```

部署：
```bash
wrangler secret put DEEPSEEK_API_KEY
wrangler secret put SILICONFLOW_API_KEY
wrangler deploy
```

完成。

---

## 九、各种"我国内能不能用 X"问答

| 问题 | 答案 |
|---|---|
| 国内能用 Cloudflare Workers 吗？ | **能** —— Workers 海外节点对国内访问大约 100-200ms 延迟，可用，无需备案 |
| 国内能用 Groq / OpenRouter 吗？ | **不稳定** —— Groq 偶尔被封、OpenRouter 时通时断。强烈不推荐主用 |
| 国内能用 GitHub Pages 吗？ | **能但慢** —— 大陆访问慢但可用。要快可用 Vercel China 联动版 / Cloudflare Pages / Gitee Pages |
| 一定要 ICP 备案吗？ | **不一定** —— 只有把"主域名指向中国大陆 IP"才需要。海外节点 / Cloudflare / 香港机房都不用 |
| 国内 AI 真的够用吗？ | **够用且更便宜** —— DeepSeek-V3 在很多榜单上接近 GPT-4 / Claude 3.5 Sonnet 的水平，价格 1/100 |
| 多模态（图像 / 看图）国内行不行？ | **行** —— 通义万相 / Qwen2.5-VL 都很强 |

---

## 十、如果你只想做一件事：先注册 DeepSeek

如果你只读一行内容：

> <strong>立刻去 [platform.deepseek.com](https://platform.deepseek.com) 注册，领 ¥10 试用额度，拿一个 API key。</strong>

它便宜到一个孩子用一年都用不完 ¥10。
代码完全 OpenAI 兼容，<strong>只要把 worker.ts 里的 url 和 key 改一下就行</strong>。
不需要 VPN、不需要 PayPal、不需要美元、不需要备案。

之后再决定要不要加硅基流动 / 通义。

---

## 十一、完整的"中国版"上线 checklist 调整

把上一份 [LAUNCH-CHECKLIST.md](LAUNCH-CHECKLIST.md) 的阶段 1-2 改成：

### 阶段 1 · 注册中国账号（30 分钟）
- ✅ DeepSeek（必选，主力 AI）
- ✅ 硅基流动 SiliconFlow（多模型聚合，可选但推荐）
- ✅ 阿里云（用通义千问 + 通义万相，可选）
- ✅ Cloudflare（worker 部署，海外节点，不需要备案）

### 阶段 2 · 充值
- DeepSeek：充 ¥10（够 1 万次以上调用）
- 硅基流动：注册送 ¥14，可不充

### 阶段 3-6 与原版基本一样
只是把 secret 改成：
```bash
wrangler secret put DEEPSEEK_API_KEY
wrangler secret put SILICONFLOW_API_KEY
wrangler secret put DASHSCOPE_API_KEY  # 通义，可选
```

**首月总花费**：约 **¥10-50**（视充值多少）。
**之后每月**：1000 孩子级别约 **¥30-150**（看用量，DeepSeek 比海外便宜很多）。

---

## 十二、对比总结表

| 维度 | 海外方案（原版） | 中国方案（本文） |
|---|---|---|
| **AI 主力** | Groq Llama 3.3-70B | DeepSeek-V3 |
| **AI 升级** | OpenRouter | 硅基流动 SiliconFlow |
| **服务器** | Cloudflare Workers | EdgeOne / 阿里云 FC / 仍用 CF（海外节点） |
| **付款方式** | 美元信用卡 | 微信 / 支付宝 / 人民币 |
| **备案** | 不要 | 看你用哪条路径 |
| **大陆访问速度** | 100-300ms | 30-100ms |
| **首月成本** | $20-30 | ¥10-50 |
| **每月成本（1k 孩子）** | $30-50 | ¥30-150 |
| **中文质量** | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |

**最佳推荐**：
- 主要服务大陆孩子 → 走<strong>路径 A（GitHub Pages + 硅基流动直连）</strong>，最简单
- 全球都要服务 → 走<strong>原版海外方案</strong> + 增加 DeepSeek 作为 OpenRouter 的中国节点
- 想要完全国产化（数据不出国） → 走<strong>路径 B（国内全栈）</strong>，但要备案

---

**Bottom line**：DeepSeek 是 2025 年中国 AI 应用的事实标准。比 Groq 便宜，比 GPT-4 便宜，质量却接近。
**别犹豫，先注册 DeepSeek 拿一个 key，今晚就能跑起来。**