Chatbox 跨平台 AI 客户端 v1.23.5：本机会话，接多家模型

日常用大模型，最容易被打断的不是模型能力，而是入口。浏览器开一个页签，登录态过期要重扫一次；换台机器，历史会话全丢；内网部署的那套推理服务，网页版根本连不上。写代码、翻文档、改一段文案的时候，你得在编辑器和浏览器之间来回切，切一次掉一次思路。

Chatbox 把这件事收进一个本地客户端：Windows 装 Setup.exe，Linux 装 deb 或直接跑 AppImage，会话与配置全部落在本机。它内置了多家主流模型服务商的接口配置页，也支持自定义的接口与本地模型接口——自建推理服务、局域网里的模型网关，都能当成一个「提供方」接进来。许可方面是 GPL-3.0，源码随包提供。功能上，多会话列表、提示词管理、知识库文件问答、会话附件检索、代码块高亮与流程图渲染、深色模式、托盘常驻、启动检查更新这些都在。

我在 Windows 11 上把安装包装了一遍并且完整跑了一轮，数字都来自当次运行的日志：从进程初始化到应用初始化完成 2.003 秒，托盘 0.909 秒就绪，知识库子系统初始化 47 毫秒，会话附件检索子系统 28 毫秒；10 个页面截图全部正常，控制台报错 0 条，4xx/5xx 响应 0 条。Linux 侧我用 dpkg-deb 把 deb 拆开逐项核对：包名 xyz.chatboxapp.app、版本 1.23.5、架构 amd64，可执行文件落位 /opt/Chatbox/xyz.chatboxapp.app，带桌面入口和 10 个尺寸的图标。结论先说：它适合想把多家模型接口收在一个客户端里、又不想把会话留在别人服务器上的人；不适合指望它替你管理模型额度，也不适合想要一个能离线自己跑推理的引擎——它是客户端，不是模型。

Chatbox 是什么

一句话：装在本机的桌面聊天客户端，模型能力由你自己配置的接口提供，会话与配置留在本地。

• 项目名：Chatbox，本次收录版本 v1.23.5
• 许可：GPL-3.0，源码随包提供
• 形态：Electron 桌面应用，应用包名 xyz.chatboxapp.app
• 平台：Windows 64 位安装包；Linux amd64 的 deb 与 AppImage
• 体积：成品包 409.83 MB，其中 Windows 安装包 232.55 MB、Linux deb 131.15 MB、AppImage 14.06 MB
• 数据：不需要数据库服务，会话与配置写在本机用户目录

功能面按用途分一遍：

• 对话：多会话列表、新建对话、模型切换，消息里的代码块带语法高亮，流程图用 Mermaid 渲染
• 模型提供方：内置多家服务商的配置项，也支持自定义接口地址与本地模型接口
• 本地能力：提示词管理、知识库文件问答、会话附件检索
• 界面：浅色与深色两套主题、托盘常驻、每小时自动检查一次更新
• 系统集成：注册 chatbox:// 协议，可以从系统里直接唤起客户端

和网页版、浏览器插件差在哪

同类入口有好几种，分工其实挺清楚：

• 托管网页版：登录态和会话都在别人服务器上，换网络环境要重新登录，内网模型接不进来
• 浏览器插件、侧边栏：依附于浏览器，浏览器一关就没了，也没有托盘和系统级唤起
• 自建 Web 前端：界面可以自己改，但要额外部署一套服务端，多一层运维
• Chatbox：纯客户端，没有服务端依赖，会话落本机，能接自建与本地模型接口

差别主要在三点：需不需要服务端、会话归谁、能不能接非官方接口。前两点决定成本，第三点决定它能不能进内网。

我的测试环境

• 系统：Windows 11 64 位
• 实测时间：2026-10-30
• Windows 侧：用包内的 Chatbox-1.23.5-Setup.exe 完成安装，安装目录内 Chatbox.exe 201,591,184 字节，文件版本 1.23.5
• Linux 侧：deb 以 dpkg-deb 解包核对，没有在图形环境下重复跑一遍
• 截图：桌面视口 1400×950 共 7 张，移动端视口 390×844、2 倍像素比共 3 张，实际输出 780×1688
• 未验证项：没有做多账号并发，也没有拿付费模型接口跑长会话压测，性能数字全部来自启动日志

安装：Windows

1. 双击「Windows安装包/Chatbox-1.23.5-Setup.exe」
2. 按向导选择安装位置，一路下一步，过程中不需要联网拉额外组件
3. 安装完成后从开始菜单启动，也可以直接运行安装目录里的 Chatbox.exe
4. 卸载走系统的「应用与功能」，或运行安装目录里的 Uninstall Chatbox.exe

这一步实测没有出现安全软件拦截，也没有白屏。

安装：Linux（deb 与 AppImage）

deb 包适合 Debian 与 Ubuntu 系：

sudo dpkg -i Chatbox-1.23.5-amd64.deb
sudo apt -f install                       # 提示缺依赖时先补齐，再装一次
/opt/Chatbox/xyz.chatboxapp.app           # 命令行启动

deb 声明的依赖有 libgtk-3-0、libnotify4、libnss3、libxss1、libxtst6、xdg-utils、libatspi2.0-0、libuuid1、libsecret-1-0。这套依赖在纯服务器系统上通常不全，装之前有心理准备。

AppImage 免安装，缺点是依赖系统的 FUSE：

chmod +x Chatbox-1.23.5-x86_64.AppImage
./Chatbox-1.23.5-x86_64.AppImage
./Chatbox-1.23.5-x86_64.AppImage --appimage-extract   # 没有 FUSE 时先解包再运行

解包核对的结果：包名 xyz.chatboxapp.app，版本 1.23.5，架构 amd64，可执行文件 196,249,160 字节，资源包 resources/app.asar 162,945,995 字节，图标覆盖 16 到 1024 共 10 个尺寸，桌面入口是 usr/share/applications/xyz.chatboxapp.app.desktop。没有桌面环境时，需要有显示服务才能起来。

首次启动：三步接上模型

1. 首次打开会出现引导页，可以直接点「跳过引导」
2. 进「设置 - 模型提供方」，选要用的服务并填入对应的 API Key
3. 回主界面新建对话，选好模型就可以开始，会话默认保存在本机

不填 API Key 也能打开，本地会话、提示词管理这些照常可用，但对话必须有至少一个能用的模型提供方。

实测数据

• Windows 安装包：Chatbox-1.23.5-Setup.exe 243,846,384 字节，约 232.55 MB
• 安装后主程序：Chatbox.exe 201,591,184 字节，约 192.2 MB，文件版本 1.23.5
• 启动时间：进程初始化 02:32:01.760，托盘创建 02:32:02.669（0.909 秒），应用初始化完成 02:32:03.763（2.003 秒）
• 子系统初始化：知识库 47 毫秒，会话附件检索 28 毫秒
• 启动维护：读取已有会话 11 个、消息 44 条
• 更新检查：02:32:07.678 发起，返回「已是最新 1.23.5」，并且明确不允许降级
• Linux 包：deb 137,521,828 字节，包名与架构核对一致；AppImage 14,745,528 字节
• 源码归档：zip 17,242,994 字节，tar.gz 16,365,928 字节
• 截图实测：10 个页面全部正常，控制台报错 0 条，4xx/5xx 响应 0 条，失败请求 0 条
• 成品包：429,743,004 字节，共 9 个条目

界面长什么样

主界面是左侧会话列表加右侧对话区的经典两栏，输入框在底部，模型可以随时切换：

模型提供方是这套客户端最核心的一页。服务商一项一项列出来，填好 Key 就能用，自定义接口也在这页配置：

常规设置里是语言、主题、数据目录这些开关，深色模式和托盘行为都在这一页：

多会话列表能看出它怎么组织历史记录：一次对话一个条目，可以随时切回来接着聊：

深色模式下同一套界面换了一身配色，代码块和引用块的对比度也跟着调：

设置页的深色样式，长时间在暗环境下改配置会舒服一些：

关于页能看到版本号和许可信息，本次装好后显示的就是 1.23.5：

移动端视口下的同一套界面

把视口压到 390 宽、2 倍像素比重新截一遍，能看出同一套界面在窄屏上的实际观感，输入框会撑满宽度：

设置项在窄屏下改为纵向堆叠，不再左右分栏：

移动端深色模式的表现和前两张一致，只是换了配色：

需要提醒的是：它本身是桌面客户端，移动端这几张是把窗口压窄之后的效果，实际手机上的使用体验不在本次实测范围内。

本地存储与知识库

这几块是它和「网页版」最实质的区别，细节都写在启动日志里：

• 配置路径：日志里直接打印了 config path，Windows 下是用户目录的 AppData\Roaming\xyz.chatboxapp.app\config.json，所有数据都在这个目录下
• 本地库：包内 node_modules 里带了 libsql 的原生模块，分了 win32-x64-msvc、linux-x64-gnu、linux-arm64-gnu 等多个平台版本，说明本地数据走的是 SQLite 系
• 知识库：把文档丢进知识库后按块入库，日志显示初始化只用了 47 毫秒，并且会自动清理上一次会话残留的「处理中」文件
• 会话附件检索：独立子系统，启动 28 毫秒，同时会做一次会话数据维护
• 存储迁移：日志里有一条 migrateStorage，首次启动时 version 是 0，程序自己初始化数据；升级版本时迁移也由它自己完成
• 内置技能：启动时会同步一份内置技能清单，本次拉到 8 个，其中 7 个有更新

有一点必须说清楚：会话存在本地，指的是聊天记录的落盘位置，对话内容本身仍然要发给你配置的模型服务商。本地存储解决的是「记录归谁」，不是「内容不外发」。

一个真实的坑：启动日志里两条吓人的警告

第一次看它的启动日志，很容易以为装坏了。安装后第一次启动的日志里有这么两行：

Warning: Cannot load "@napi-rs/canvas" package: "Error: Cannot find module '@napi-rs/canvas'
[40856:1101/023202.061:ERROR:network_change_notifier_win.cc(188)] WSALookupServiceBegin failed with: 10108

第一条是可选依赖 @napi-rs/canvas 没打进去，第二条是 Windows 的网络位置感知服务查询失败。我这一轮实测里，界面打开、模型提供方配置、多会话切换、深色模式、关于页全部正常，控制台报错 0 条，所以这两条当作噪声看就行，不必去补装那个包。

日志里还有一行是正常行为，别误判：

[app-updater] Update for version 1.23.5 is not available (latest version: 1.23.5, downgrade is disallowed)

它每小时检查一次更新，返回的是「已是最新」，只是措辞像报错。

Linux 侧的坑更实际：deb 声明的依赖里 gtk3、nss、atspi 这些在最小化安装的系统上往往缺席，直接 dpkg -i 会报依赖不满足，要补上 apt -f install；AppImage 则需要 FUSE，没有 FUSE 就得先 --appimage-extract 解包再运行。另外这两个包的体积差得远——deb 131.15 MB，AppImage 只有 14.06 MB，如果你在意「一次装好、以后不联网」，优先用 deb。

这几类人适合，这几类不适合

适合：

• 同时用着好几家模型服务，想把 Key 和对话收在一个客户端里，而不是开一堆页签
• 内网或本机跑着推理服务，需要一个能填自定义接口地址的桌面客户端
• 在意聊天记录留在自己机器上，不想让它躺在别人的服务器里
• 习惯键盘和托盘，需要一个常驻后台、随叫随起的对话入口

不适合：

• 希望客户端替你管额度、管计费。它就是接口的壳，额度问题还是在服务商那边
• 想要一个能离线自己跑推理的引擎。它不含模型权重，断网只能看历史记录
• 只用一家服务、且网页端已经够顺手的人。多装一个客户端收益有限
• 需要多人协作、共享会话的团队。它是单机客户端，没有团队空间这回事

常见问题

源码获取

建议先转存到自己网盘再下载。手机上打开链接点右下角「保存到网盘」，回头在夸克 App 的「我的网盘」里下。