Whirl：一个把多模型、工具、搜索和可编辑产物放在一起的 AI 聊天应用

先给判断：Whirl 是一款全栈 AI 聊天应用，试图把多模型对话、工具、联网搜索、长期记忆和可编辑产物做成一个统一界面。它更像一个可自托管、可改造的产品代码库，而不是可以脱离外部服务运行的桌面模型。其基础请求路径依赖 Convex、Clerk 和 OpenRouter；作者把 Exa 搜索、Supermemory 记忆、计费和遥测列为可选服务。适合想研究一套完整 AI chat 产品架构的开发者，是否适合普通用户长期使用则还要看托管服务、模型成本和数据边界。

README 描述的产品能力包含同一对话中的不同模型、可调 reasoning、侧栏内可继续编辑的文档/图表/交互页面、通过 MCP 连接自有工具和 OAuth、长期记忆、实时网页搜索、语音输入、文件附件和图片生成。Architecture 文档把一轮消息拆成发送、配置/套餐预检、历史与附件组装、OpenRouter 流式生成、工具阶段更新和最终 token/成本记账。这个结构有利于产品观察模型和工具进度；但多功能也意味着多个服务与权限边界要一并维护。

自托管并非只需把仓库 clone 下来。官方指南要求 Bun 1.2+、Git、Convex 项目、Clerk 应用和 OpenRouter API key；Convex 负责数据库、函数、stream 和 cron，Clerk 负责登录与账户，OpenRouter 承担每一次模型调用。启动时需配置 JWT issuer、Convex URLs、Clerk keys 和站点地址，再通过 Bun 同时运行 web、console 和后端。可以部署到自有服务器或兼容 Next.js 的托管平台，不过后端依赖 Convex，身份依赖 Clerk，因此“自托管 UI”并不等于整个系统离线或所有数据留在自己的服务器。

支出主要来自模型和托管服务。README 说 OpenRouter 为按用量计费，Convex 与 Clerk 提供免费层；搜索 Exa、记忆 Supermemory、计费 Autumn、分析 PostHog/Axiom、支持 Median 等按需配置。若关闭 Autumn，所有登录用户会被当作付费用户，不限额也不计费，这是个人/团队自建场景的默认便利，但公开服务必须自行补上身份、额度和反滥用策略。配置文档还说明所有 turn 都会记录 token 和 provider cost，用户设置页可查看使用量。

一个值得细看的是 locked chats。架构文档称锁定聊天历史在浏览器端用用户密码派生密钥加密，服务端存密文；由于服务器不能组装解密后的 prompt，浏览器会负责解密、调用 locked-stream，再加密回复，并只允许 OpenRouter 报告为 zero-retention 的模型。这个设计缩小了服务端可读范围，但模型请求仍由外部 provider 处理；密钥管理、浏览器安全、模型名单刷新和 provider 对 zero-retention 的定义都是评估项，不能简称为“完全本地聊天”。

状态也要如实说明。候选脚本记录仓库 2026 年 10 月 2 日创建、510 Stars、MIT 许可；GitHub API 最新一次 push 为 10 月 14 日，更新距离今天约半个月，查询不到正式 GitHub release。README 说 hosted service 是 whirl.chat，但本次评测没有做生产 SLA 或隐私政策审计。社区 Stars 是关注度指标，不证明服务成熟度；要用于团队，应检查依赖升级、Convex 函数权限、MCP OAuth 凭证、日志是否含 prompt、账号注销和数据删除路径。

结论：Whirl 的亮点是把聊天 UI、工具调用、搜索、memory 与 artifacts 放进可读的全栈代码；适合开发者做架构参考或搭建自己的内部聊天产品。它不适合把“一个仓库”误当成“一个完全离线、零运维应用”。试用时先用测试账号与低敏感资料，估算 OpenRouter 模型账单，决定哪些 optional service 真有必要，再审阅 MCP 权限和数据保留配置。

参考来源

1. Whirl repository and README
2. Whirl self-hosting guide
3. Whirl architecture
4. Whirl configuration reference
5. Whirl security policy
6. Whirl MIT license
7. Whirl hosted application