█████╗ ██████╗ ██╗██████╗  ██████╗██╗  ██╗ █████╗ ████████╗
██╔══██╗██╔══██╗██║╚════██╗██╔════╝██║  ██║██╔══██╗╚══██╔══╝
███████║██████╔╝██║ █████╔╝██║     ███████║███████║   ██║   
██╔══██║██╔═══╝ ██║██╔═══╝ ██║     ██╔══██║██╔══██║   ██║   
██║  ██║██║     ██║███████╗╚██████╗██║  ██║██║  ██║   ██║   
╚═╝  ╚═╝╚═╝     ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝   ╚═╝   
  

一个零知识、无后端的通用 LLM 访问界面

API2CHAT 是一个轻量（小于 13KB）、纯客户端的图形界面，用于对接任意兼容 OpenAI 协议的 LLM 接口。它无需臃肿的后端、数据库或订阅，让你安全地接入自己的 API Key。

v2 新特性！ 默认内置 OpenRouter 的免费模型（https://openrouter.ai/openrouter/free），直接粘贴 OpenRouter Key 即可使用。注意： OpenRouter 免费档通常每天 200 次请求；若充值至少 10 额度（约 $10），每日免费请求上限会提升到 1000 次 :)

💡 查看在线演示

上面是上游原版演示。你也可以把自己的仓库部署到 GitHub Pages，获得专属的可公网访问地址（见下文「部署到 GitHub Pages」）。

🚀 核心特性

• 🛡️ 100% 零知识安全： 任何数据都不会发往或存到任何中心服务器。聊天记录仅保存在你本地浏览器（localStorage），不上传、不共享；API Key 仍不持久化，每次重开需重新填写。
• 🔌 最大兼容性： 原生支持 OpenAI、Google（Gemini 通过 OpenAI 兼容层）、DeepSeek、OpenRouter；并提供「自定义」模式对接任意本地（如 LM Studio、Ollama）或远程服务商（OpenAI 标准）。
• 📎 本地文件上下文： 文件在浏览器本地读取并注入 LLM Prompt，无需上传服务器；即使是 PDF 这类附件也不会被存储到任何地方。
• 💻 随处托管： 不需要 PHP / Python / Node.js，可托管到 GitHub Pages、S3、廉价虚拟主机（如 Namecheap），或直接双击桌面上的 index.html（Windows / Linux / iOS / Android / 树莓派均可）。
• 🎨 极简美学： 暗色终端风 UI，完整 Markdown 渲染 + 代码语法高亮。
• 🌗 白天 / 黑夜主题： 一键切换，并用 localStorage 记住你的偏好。
• 🔑 对话中不中断切换 API Key： 聊天过程中随时点「🔑 切换 API」，换另一家 Key 后继续当前对话。
• 📋 一键复制： 每条 AI 回复和每个代码块都带复制按钮，方便取用。
• 🕘 本地历史记录： 左侧「💬 历史记录」面板自动保存每次对话，支持新建、加载、删除会话；刷新浏览器后仍在，记录仅存于本机 localStorage。
• 🔍 联网搜索（可选）： 内置 SearXNG 数据源（也支持 DuckDuckGo / 维基百科 / 自定义接口）。检索到的网页结果会注入 Prompt，让模型基于实时网络信息作答。自建 SearXNG 的方法见 searxng/README.md。

📸 界面与功能

API2CHAT 采用简洁、终端风格的界面，为高效、低摩擦的交互而设计。

📎 本地文件读取（零上传）

API2CHAT 可原生读取本地文件并直接注入 LLM Prompt。文件永远不会被上传到服务器。你的浏览器在本地读取文本，直接发给 API 服务商。

🛠️ 本地部署 / 廉价虚拟主机起步

1. 克隆或下载本仓库，或下载 ZIP 发布包（小于 13KB）。
2. 解压内容到你的设备或任意托管商（低端 Namecheap、Hostgator 等均可）。
3. 双击 index.html 在任意浏览器与系统中打开（无需 PHP / Python / Node.js……什么都不需要）。
4. 选择服务商、粘贴你的 API Key，开始聊天。你可以复制/粘贴文本或上传文件来向 LLM 提问。
5. （可选） 想清掉当前对话内容，点输入框旁的 「🔄 清空会话」（历史仍保留在左侧面板，可单独删除）；想彻底退出并清除连接，直接关掉页面或切到别的会话即可。API Key 始终只存在内存中，关闭页面即失。

🌐 部署到 GitHub Pages

想免费托管一个属于你自己的、安全的在线实例？

1. 把本仓库 Fork 或上传到你的 GitHub。
2. 进入仓库 Settings（设置） > Pages（页面）。
3. 在 Branch（分支） 选择 main，点击 Save（保存）。
4. 几分钟后就会生成你的在线地址：https://<你的用户名>.github.io/API2CHAT/。

🕘 历史记录（本地保存）

API2CHAT 现在会把对话自动保存到浏览器的 localStorage，刷新或重开页面后仍能找回：

• 左侧 💬 历史记录 面板列出所有会话，点击即可加载，悬停可 🗑 删除。
• ➕ 新建会话 开启一段全新对话；当前会话会实时自动保存（按消息落盘）。
• 🔄 清空会话（输入框旁）仅清掉当前消息，历史仍保留在面板里，可单独删除。
• 保存范围仅限聊天内容；API Key 不落盘，刷新后恢复历史需重新填写密钥（符合零知识）。
• 注意：localStorage 按「浏览器 + 域名」隔离，换浏览器 / 设备 / 隐身窗口或清除站点数据都会让历史丢失。

🔍 联网搜索（SearXNG）

默认不开启联网；在设置里把「数据源」切到 SearXNG 并填入你的实例地址即可（例如 https://你的域名/search?q={q}&format=json）。

• 完全可私有化：自己用 Docker 部署一个 SearXNG（模板见 searxng/ 目录），数据不经过任何第三方。
• 引擎建议：国内网络下保留 baidu / 360search / sogou / bilibili 等可直连引擎（详见 searxng/README.md 的排错章节）。
• 也支持 DuckDuckGo 即时答案、维基百科、或任意返回文本/JSON 的自定义接口。

🤖 默认服务商示例（推荐：点「自定义」填你自己的）

服务商	Base URL	默认模型
OpenAI	https://api.openai.com/v1	gpt-4o-mini
DeepSeek	https://api.deepseek.com	deepseek-chat
OpenRouter	https://openrouter.ai/api/v1	qwen/qwen3.5-flash-02-23
Custom	用户自定义	用户自定义

👨‍💻 作者与许可

原版由 Dr. Manuel Herrador（mherrador@ujaen.es，西班牙哈恩大学）创建；本分支在此基础上增加了白天主题、对话中切换 Key、复制按钮与联网搜索等功能。

基于 Apache 2.0 License 发布。你可以自由修改、分发，并在私人或商业场景使用本软件。作者不对任何损坏或数据丢失承担责任。

---

Made with ❤️ for the Local AI Community