一、三步上手（初次使用）

1. 打开本网站，点击右上角「充值 / 余额」，在对应服务商（推荐 DeepSeek）充值并创建一个 API Key。
2. 点击右上角「设置」，选择服务商，把 API Key 粘贴进密钥框，点「测试连接」成功后「保存设置」。密钥只在你本机浏览器保存一次，以后无需重复配置。
3. 回到主页：粘贴代码或描述任务即可逐行讲解 / 生成代码；多文件项目可一键打包 ZIP 下载。

二、上传图片提问

点输入框左下角「图片提问」，可上传最多 9 张题目、代码、报错或图表截图（支持 JPG / PNG / WebP），再配上你的问题发送。图片会自动压缩。 DeepSeek 的 deepseek-flash 已支持看图；其它平台请在「设置」里切换到支持视觉的模型（如 gpt-4o、qwen-vl-plus 等）。

三、接入本机部署的 AI（免费、离线）

云端服务器无法访问你电脑上的模型，本机模型由浏览器直连，请在「设置」选择对应预设并按下面开启跨域：

• Ollama：安装后运行 ollama pull qwen2.5-coder:7b，再启动允许跨域的服务：
  • macOS：终端执行 OLLAMA_ORIGINS=* ollama serve
  • Windows（PowerShell）：$env:OLLAMA_ORIGINS="*"; ollama serve
  Base URL 填 http://localhost:11434/v1，密钥留空。
• LM Studio：加载模型后打开 Local Server，开启服务并勾选允许跨域（CORS），Base URL 填 http://localhost:1234/v1，模型名填 local-model。

四、部署到 Cloudflare（一次性，得到固定网址）

1. 登录 Cloudflare 控制台，进入 Workers & Pages → Create → Pages → Upload assets / Direct Upload。 请不要用 “Cloudflare Drop”（那是纯静态临时预览，不能运行后端），也不要选 Workers 静态站。
2. 把 codementor-cloudflare.zip 直接拖进上传框（也可以解压后拖文件夹，但要保证 index.html 与 _worker.js 在最外层，不要外面再多套一层文件夹）。起个项目名，点 Deploy site。
3. 部署后自检（重要）：在浏览器打开 https://你的项目名.pages.dev/api/config —— 看到以 {"service":"codementor-cloudflare" 开头的文字，代表后端正常；若看到的是网页 HTML，说明 _worker.js 没生效（入口选错或目录多套了一层），按上面重做即可。
4. 以后更新：进入该 Pages 项目，点 Create new deployment，重新拖入新的包。Mac/Safari 请按 Command + Shift + R 强制刷新一次以清缓存。
5. （可选）想用自己的域名 ccpppiceeee.com：先确认你已拥有该域名；在 Cloudflare 「Add a site」添加该域名，并按提示到域名注册商把 NS 服务器改为 Cloudflare 提供的地址；再到 Pages 项目 Custom domains → Set up a custom domain 填入 ccpppiceeee.com 与 www.ccpppiceeee.com，等待生效即可。
6. （可选，想让所有访客共用一把密钥）在 Pages 项目 Settings → Variables and Secrets 配置 AI_API_KEY、AI_BASE_URL、AI_MODEL。不配也没关系，每个人在网页设置里填自己的 Key 即可。

五、常见问题

• 提示 401/403：Key 错误、过期或未开通该模型，到「充值 / 余额」核对并重新填写。
• 提示 429 或答非所问：余额不足或限流，去充值中心查看余额/充值。
• 提示 404：Base URL 或模型名错误，结尾不要带 /。
• 提示 405 / 顶部橙色横幅 / “AI 没有返回有效内容”：后端 _worker.js 没有生效，当前是纯静态部署。请按第四步重新部署（用 Pages 的 Upload assets，不要用 Cloudflare Drop，保证 _worker.js 在根目录）。
• “已连接但返回格式异常” / 一直转圈不出正文：新版（v1.4.2）已对 DeepSeek 自动关闭默认“思考模式”，直接输出正文。若你接入其它带“思考”的模型仍遇到，请在「设置」里把“最大输出”调大（如 2000）。
• 本机模型连不上：确认模型已启动、已加载，并按上面第三步允许跨域。
• 历史记录：仅保存在当前浏览器，清理浏览器数据会删除；为节省空间，历史中的图片不保留原图。