research + prototype + integration plan

把 AI 直接接到网站里，孩子点一下就能跑

现状：每个项目都是"复制 prompt → 跳到通义千问"。
目标：在薪火网站原地跑 AI，零注册、零跳转、零 API key。
这一轮：5 份文档 + 4 个能跑的原型 + 1 个 Cloudflare Worker。

📚 研究 + 设计（先读这两份）

技术调研、架构选型、各能力实现路径、成本估算、安全策略 —— 全部写在文档里。

研究文档

RESEARCH.md · 技术调研

对比 4 种主流路径（WebLLM / 单一 API / 硅基流动 / 自建 Ollama）+ 7 个上游 AI 供应商 + 详细成本估算。最终为什么选 DeepSeek + 硅基流动 + Cloudflare Workers AI。

读全文 架构设计

ARCHITECTURE.md · 系统架构

完整请求流图、SDK 接口、Worker 路由、限流方案、降级链、各能力具体实现、错误处理、隐私设计。

读全文

🧪 能跑的原型（在浏览器里直接试）

演示模式（不连真后端）—— 体验 UX 流程。每页都有"部署后会怎样"的说明。

原型 1 / 4

📃 文字聊天 + system prompt

这是所有项目的基础。预置 4 个 system prompt（爷爷做菜 / 恐龙小专家 / 凶度检测 / 9 岁能懂的话），孩子点一下就跑、改 prompt 立刻再跑。

打开原型 原型 2 / 4

⚖️ 判官 AI（LLM-as-judge）

给一份 rubric + 一段候选回答 → AI 自动打分 + 分项 breakdown + 解释。审美工作室项目 07/08 + 进阶项目 11 同款。

打开原型 原型 3 / 4

🎨 图像生成 + 看图说话

① 描述一句话生成 4 张图（FLUX schnell）。② 上传孩子画的画，让 Qwen-VL 看图评论 + 给写作灵感。萌芽版"画一画"必备。

打开原型 原型 4 / 4

🎙️ 语音输入 → AI 回答

按麦克风说话，浏览器原生 Web Speech API 转文字（免费、零延迟），AI 立即回答。8-10 岁打字慢的孩子福音。

打开原型

🔌 整合演示 + 部署

怎么把这套接进现有 100+ 项目页 + 怎么部署后端。

改造演示

把中阶项目 03 升级成"点一下就跑"

对比版 / 现状 → 改造后。孩子做出的网页直接就能问 AI，不用跳转。完整代码可以照搬。

看演示 整合文档

INTEGRATION.md · 怎么接进现有页面

3 步迁移现有 100+ HTML 页面 + ai-runner 组件实现 + 上线 checklist + 后续迭代方向。

读全文

⚙️ 后端代码

完整可部署的 Cloudflare Worker，配上详细 README。

部署说明

worker/README.md · 部署到 Cloudflare

从注册 3 个 API key（Groq / OpenRouter / HuggingFace）到部署 Worker 到自己域名 —— 全程 7 步，约 30 分钟。

读全文 代码 · 海外版

worker/worker.ts · 海外版 Worker 源码

~200 行 TypeScript。DeepSeek + 硅基流动 + Cloudflare AI + 通义。处理 6 个 endpoint + 限流 + 成本守门 + CORS。

看源码 代码 · 🇨🇳 中国版

worker/worker-china.ts · 中国版 Worker 源码

同样的接口，全部换成国内供应商：DeepSeek（chat / judge）+ 硅基流动（多模型）+ 通义万相（图像）+ Qwen-VL（视觉）+ 通义 embedding。

看源码 前端 SDK

kindling-ai-sdk.js · 前端 SDK

挂在 window.kindlingAI 上的统一 API：chat / judge / image / vision / transcribeNative / embed / VectorStore。包含流式 SSE 解析。

看源码 配置

worker/wrangler.toml · Cloudflare 配置

Worker 配置文件。CORS 域名、KV 绑定、AI binding —— 复制改 3 个值就能 deploy。

看配置

🚀 真上线指南

三条路。如果你的服务器是阿里云 ECS + 宝塔面板（最常见的国内方案），直接看第一张卡就够了。

🇨🇳 阿里云 + 宝塔 · 强烈推荐

ALIYUN-BAOTA-DEPLOY.md · 国内最常见的部署方式

阿里云 ECS + 宝塔 Linux 面板 + Node.js + DeepSeek/通义/硅基流动。 全步骤照点鼠标的顺序写，约 2-3 小时上线。含 ICP 备案、Nginx 反代、PM2 守护、SSL 证书全部细节。

读全文（中国主流方案） 代码 · Node.js 服务

server/server.js · Express.js 后端

纯 Node.js + Express，跑在阿里云 ECS 上。同样 6 个端点（chat / judge / image / vision / embed / transcribe）。配 PM2 ecosystem.config.js + .env.example + package.json，clone 下来改 key 就能 npm install + pm2 start。

看源码 改造旧页指南

RETROFIT-GUIDE.md · 旧静态页 → 真 AI

把现有 100 多个 HTML 页面"两步之内"接上 AI。7 种常见场景的复制即用模板（聊天/打分/画图/看图/语音/多轮/批量）。

读全文 改造演示

demo-retrofit-china.html · 同一页：占位 vs 真 AI

左右对比 3 个模块（聊天 / 打分 / 画图）：左边写死的占位；右边一行 SDK 接通后真的能跑。看完就知道怎么改自己的页面。

打开演示 🇨🇳 Cloudflare 中国版（备选）

CHINA-DEPLOY.md · Cloudflare Worker + 国产 API

如果你的部署不在阿里云上、用 Cloudflare Workers，这是另一条路：Worker 反代到 DeepSeek / 通义 / 硅基流动。比阿里云方案少备案，但在国内访问 Cloudflare 速度稍慢。

读全文 海外版上线 checklist

LAUNCH-CHECKLIST.md · 海外用户用

6 个阶段、约 3 小时、首月 $20-30。Cloudflare + DeepSeek + 硅基流动 + 通义。适合服务海外用户 / 有 VPN。

读全文

建议的执行顺序（阿里云 + 宝塔版）

  1. 今天：注册 DeepSeek + 阿里云百炼 + 硅基流动账号，各拿一把 API key（10 分钟）
  2. 今天 / 本周：跟着 ALIYUN-BAOTA-DEPLOY.md 走完第 1-5 步，让 /api/health 返回 200（约 2 小时）
  3. 本周末：照着 demo-retrofit-china.html 改一个真项目页（中阶项目 03 是好起点），看孩子反应
  4. 下周：照着 RETROFIT-GUIDE.md 批量改其他项目页
  5. 再下周：接图像 + 语音 → 萌芽版项目页
  6. 之后：班级模式 / 老师面板 / 作品 publish 这些产品功能