Chatbox 免费开源 AI 桌面客户端上手指南本地模型接入与魔改实操【免费下载链接】chatboxPowerful AI Client项目地址: https://gitcode.com/GitHub_Trending/ch/chatbox你有一台装着 Ollama 的机器想写周报又不想让内容离开本机——打开 Chatbox把模型切到本地全程零外发。Chatbox 是一款免费开源的 AI 桌面客户端GPLv3支持 OpenAI、Claude、Ollama 等多家模型服务商API Provider即模型接口的提供方对话数据存在本地覆盖 Windows、macOS、Linux。图1Chatbox 浅色主题完整界面左侧为会话与提示词库三步从克隆到启动环境只需 Node.js建议 16 及以上和 npm这是 Electron用网页技术写桌面应用项目的标配。拉源码、装依赖git clone https://gitcode.com/GitHub_Trending/ch/chatbox cd chatbox npm install第一条命令把仓库拉到本地npm install安装全部依赖装完后会自动执行postinstall顺带构建好开发用的资源包。启动开发模式npm run dev它以热更新模式启动 Electron 主进程和前端渲染进程改代码即时生效想发布安装包再执行npm run package当前平台或npm run package:allWin/Mac/Linux 全平台。场景一接入本地 Ollama 模型对话不出内网适合对数据敏感、或不想依赖境外 API 的用户。在机器上装好 Ollama本地模型运行框架并拉取一个模型打开 Chatbox 设置把 AI Provider 切到OllamaAPI Host 保持默认http://localhost:11434模型下拉框会自动列出本机已拉取的模型供你挑选开始对话即可所有请求都发往本机。图2设置页选择 Ollama 作为 AI Provider模型列表自动拉取背后的逻辑可以直接读源码确认src/renderer/packages/models/ollama.ts 里的listModels()请求 Ollama 的/api/tags接口所以下拉框里的模型就是本机真实已有的。场景二读懂模型适配层为加新供应商做准备models/ 目录下每个文件对应一家供应商openai.ts、claude.ts、ollama.ts、siliconflow.ts……新增一家供应商思路是三步在该目录新建文件继承Base类实现callChatCompletion发起对话请求并流式吐字需要模型列表的话再实现listModels在 models/index.ts 的getModel函数和AIModelProviderMenuOptionList菜单里注册。以 Ollama 适配类为例看看需要填多少东西export default class Ollama extends Base { public name Ollama async callChatCompletion(rawMessages, signal, onResultChange) { const res await this.post(${this.getHost()}/api/chat, ...) await this.handleNdjson(res, (message) { ... }) return result } async listModels(): Promisestring[] { ... } }以上为 ollama.ts 的结构节选。Base已封装好 fetch 重试、SSE/NDJSON 流式解析、错误分类所以新供应商的实现非常薄——照抄一家、换掉 URL 和报文即可。场景三让团队共享一个 OpenAI Keyteam-sharing/ 目录提供一套现成方案成员共用一个 OpenAI 账户的 API 资源但 Key 只保存在服务器上客户端不暴露。准备一台能访问 openai.com 的服务器任意云厂商均可装好 Docker启动共享服务把 Key 通过环境变量注入镜像容器内的 Caddy反向代理会自动完成域名与密钥的替换和 HTTPS 证书处理docker run -p 80:80 -p 443:443 \ -v ./caddy_config:/config -v ./caddy_data:/data \ -e KEY你的 OpenAI Key \ -e HOST你的域名 \ bensdocker/chatbox-team把https://你的域名发给成员他们在设置里把这个地址填进API Host字段不用填 Key 即可共享资源域名映射后约五分钟生效。图3Chatbox 深色主题长时间使用的护眼选项详细步骤见 team-sharing/README-CN.md。踩坑备忘发消息提示Failed to fetch→ 网络连不上你填的 API Host → 检查当前网络能否访问该地址或改走代理。突然报You exceeded your current quota→ OpenAI 账户免费额度用尽或过期 → 登录 OpenAI 控制台充值或绑定支付方式。回复慢、答非所问→ 温度参数Temperature控制回复随机程度或上下文过长 → 在设置里调低温度或减少携带的历史消息数。npm install报错→ Node.js 版本过低 → 升到 16 后清空 npm 缓存重装依赖。更多答案见 doc/FAQ-CN.md。行动入口Chatbox 的定位是一手的 AI 对话客户端数据本地、供应商可换、代码可读可改适合想摆脱网页端、用本地模型、或给团队搭共享通道的用户。文档看 doc/README-CN.md问题提 Issue想动手就从 fork 一份开始提交 PR。【免费下载链接】chatboxPowerful AI Client项目地址: https://gitcode.com/GitHub_Trending/ch/chatbox创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考