whale-girl - 面向微信的本地优先 AI 陪伴机器人

whale-girl 是一个面向微信的本地优先 AI 陪伴项目。按项目自述，它会在群聊里回应 @ 提及与自己的名字，记住别人告诉它的事情，还能发送表情、语音消息和每日日记；所有操作都通过一个 Windows 启动器完成，没有浏览器界面，127.0.0.1:8787 只提供本地 HTTP API。它适合希望在个人微信账号上挂一个可控 AI 角色、并且愿意自行准备模型 API Key 与 Windows 环境的用户，尤其是想给群聊加一个「AI 群友」的个人使用者或小团队。

维护者与状态

项目由 Banan1cee 维护，仓库创建于 2026-10-26，最后一次提交在 2026-11-11。最新正式版本为 v4.0.8.2，发布于 2026-11-08。截至 2026-11-11，仓库星标数为 489。项目采用 AGPL-3.0 许可证。

从时间线看，这是一个创建时间很短、迭代节奏较快的项目：不到三周内已有多次提交，并发布了 v4.0.8.2 版本。项目自述中提供了较完整的文档目录，涵盖设置说明、微信接入、日记功能、朋友圈实现、搜索模块、维护手册、架构总览与打包签名等，说明维护者在文档上投入了一定精力。

主要能力

以下能力均据项目 README 自述整理，未经独立验证：

• 微信群回复：在群里回应 @ 提及和它的名字，在运行期间维持对话，话题结束后保持安静；据项目说明，它会忽略无关的争论。
• 记忆：记录私聊中的事实，压缩较早的群聊历史；当图片或表情无法读取时保持沉默。
• 拟人化发送：把一条回复拆成多个短气泡，避免句尾标点，并对重复或复读的回复重写一次。
• 附加功能：表情包（27 张内置图片加自定义分类，默认关闭发送）、朋友圈读取与手动互动、Markdown 日记（每天最多一篇，写入 data/diary/YYYY/MM-DD.md）、语音回复、网页搜索、热榜以及基础群管理。
• 统一控制面板：通过 WhaleLauncher.exe 完成启动、停止、配置与诊断。
• 群管理：禁言/解除禁言、切换模型、调整语气、清空记忆，以及低电量晚安等。
• 诊断：内置日志、账号检查、UIA 自检与更新检查。

项目自述还提到，回复由模型生成，支持 DeepSeek、智谱 GLM、SiliconFlow、Qwen、豆包、OpenCode 或任意 OpenAI 兼容端点，也可选配 Ollama 等本地 OpenAI 兼容服务。

使用入口

仓库地址为 Banan1cee/whale_girl。项目另有一个官网地址 whale_gril，注意其拼写与主仓库不同。

据项目说明，最简使用路径是从 Releases 下载 whale-girl-*-setup.exe 并运行。安装包自带 Node.js、Python 3.12 与 .NET 10 桌面运行时，无需额外下载，也不需要执行 npm install。首次运行流程为：打开桌面快捷方式，在启动器的「设置」中选择模型提供商并填入 API Key，进入「微信桥接」选择账号后按「开始」，等待状态页显示内核与桥接均在运行。

运行环境要求包括：Windows 10 或 11；已登录的微信 4.x 账号（项目建议使用小号）；一个模型 API Key；微信 UI 自动化需要管理员权限。项目特别提示，安装路径必须是纯 ASCII 路径，例如 D:\whale-girl，路径中含中文字符可能破坏微信自动化。停止时在启动器按「停止」再关闭；若仍有残留进程，可在关闭启动器后运行 powershell -File scripts\stop-all.ps1 清理，该脚本会写入 data\PAUSED 标记，避免自动重启。

许可与限制

许可证为 AGPL-3.0。项目自述说明，商业使用是允许的，但分发修改版本或通过网络提供服务时，必须提供完整的对应源代码，并保留 docs/NOTICE.md 中的署名信息。具体条款以仓库 LICENSE 为准。

项目自述列出的已知限制与边界包括：

• API 默认绑定 127.0.0.1:8787，没有登录层，不应暴露到公网。
• data/ 与 config.json 已被 git 忽略，不应提交 API Key、微信 ID、群 ID 或聊天记录。
• 桥接使用 UI 自动化并读取本地微信数据库，不修改微信、不注入代码，但仍可能违反微信服务条款，需自行承担风险。
• 回复由模型生成，在公开群中使用 admin.allowAll 与自动回复需谨慎。
• 当前发布构建尚未签名，Windows 可能提示「未知发布者」，安装前应核对发布页的 SHA256SUMS.txt。
• 仅应从 GitHub Releases 下载安装包。

此外，项目自述提到角色图标基于作者「上善无形」的原创角色衍生，相关署名见 docs/NOTICE.md；微信自动化部分基于 Apache-2.0 的 wechatauto-replica，可选语音发送使用 VB-CABLE 虚拟音频线。