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

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 / Drag and drop。
2. 把本文件包解压后的整个文件夹（或 ZIP）拖进去，起个项目名，点 Deploy site，即可得到 https://你的项目名.pages.dev 固定网址，以后随时打开即用。
3. （可选）想用自己的域名 ccpppiceeee.com：先确认你已拥有该域名；在 Cloudflare 「Add a site」添加该域名，并按提示到域名注册商把 NS 服务器改为 Cloudflare 提供的地址；再到 Pages 项目 Custom domains → Set up a custom domain 填入 ccpppiceeee.com 与 www.ccpppiceeee.com，等待生效即可。
4. （可选，想让所有访客共用一把密钥）在 Pages 项目 Settings → Variables and Secrets 配置 AI_API_KEY、AI_BASE_URL、AI_MODEL。不配也没关系，每个人在网页设置里填自己的 Key 即可。

五、常见问题

• 提示 401/403：Key 错误、过期或未开通该模型，到「充值 / 余额」核对并重新填写。
• 提示 429 或答非所问：余额不足或限流，去充值中心查看余额/充值。
• 提示 404：Base URL 或模型名错误，结尾不要带 /。
• 本机模型连不上：确认模型已启动、已加载，并按上面第三步允许跨域。
• 历史记录：仅保存在当前浏览器，清理浏览器数据会删除；为节省空间，历史中的图片不保留原图。