whale-gril - 基于大模型的微信陪伴机器人

whale-gril 是一个面向微信场景的陪伴型聊天机器人项目，由 Banan1cee 维护，采用 MIT 许可证。按项目自述，它的定位是「真的会聊天的陪伴机器人」：在微信群里自动接话，能读取 Bilibili、微博等平台的热点话题，也能按需联网查询，人设是一位蓝发鲸鱼少女，说话短、有情绪，时而甜时而毒舌。它适合希望在自己的微信群里挂一个长期在线、有记忆、有性格的对话角色，并且愿意自行准备模型 API 的用户。

维护者与状态

仓库由 Banan1cee 维护，创建于 2026-10-26，最后一次提交在 2026-11-06，最新 release 为 v4.0.6，发布于 2026-11-06。截至 2026-11-06，仓库获得 225 个星标。项目迭代节奏较快，从创建到 v4.0.6 只用了不到两周，README 中也专门写了 3.x 数据向 4.0 格式迁移的说明，说明版本之间确实存在不兼容的数据结构变化，升级前需要留意。

主要能力

以下能力均据项目 README 自述，未做独立验证。

• 统一入口：启动器（WPF + .NET 10）是唯一的图形界面，没有浏览器控制台，本地 8787 端口只提供 HTTP API。
• 群聊回复：响应 @ 与被叫到名字的消息，话题还在时继续接话，话题冷掉就安静下来；被点名辱骂时会回击，但不介入他人之间的争吵。
• 拟人节奏：一条回复拆成 2 到 3 个短气泡，句尾不加波浪号或句号；对方只发一个「？」时，她也回一个「？」。
• 记忆：私聊中对方陈述的关于自己的事实会被记录，较早的群聊会被压缩成摘要；图片或表情识别失败时保持沉默。
• 避免复读：当模型重复自己（相同文本、文本加问号、「不，你才是……」之类）时，回复会被重写一次。
• 网络用语与回怼：内置缩写词表与九档回怼语料库，均可通过 assets 目录下的文本文件扩展；回怼不涉及性、家人、歧视与现实威胁。
• 语音输入：收到的语音消息会先转写再回复，但她只发送文字。
• 联网：由模型判断是否需要查询，接入 Bing 与 Bilibili、微博热点、头条热榜及链接正文提取，受全局超时约束，提示词中带当前日期。
• 群管理：禁言与解除、切换模型、调整语气、清空记忆，低电量时自动道晚安。
• 一键停止：通过脚本或启动器按钮同时停掉内核与桥接，并写入暂停标记。
• 微信桥接：examples 目录下的桥接脚本采用只读数据库访问加窗口自动化，不向微信进程注入。
• 零 npm 依赖：内核不需要 npm install，发布包自带运行时，仓库本身是源码版。

此外，README 还介绍了一个默认关闭的实验性表情包功能：模型在回复末尾写出 [[sticker:category]] 标记来选择分类，标记在展示前被剥离；标记缺失、分类不存在或分类下没有图片时，什么都不发，机器人不会猜测情绪或随机挑选。内置傲娇、生气、开心三类，也可自建分类，支持 GIF、PNG、JPEG、WebP，单文件上限 4 MB。上传只保存原文件，不发送微信消息，也不对 GIF 重新编码。项目说明中还提到可设置触发频率与「无标记也发一张」选项，并强调队列中的测试发送并不等于已送达，结果「未确认」时不要重复按发送。

使用入口

仓库地址：Banan1cee/whale_gril。项目官网字段同样指向该仓库。

据项目说明，普通用户可直接从 Releases 下载安装包，安装器自带 Node、Python 3.12 与 .NET 10 桌面运行时，安装完成后无需再下载依赖，安装过程不触发 UAC，只有机器上没有 .NET 10 时会多一次提权提示。安装路径需使用纯 ASCII 字符，路径中含中文时微信自动化会持续报「拒绝访问」。安装完成后通过桌面快捷方式打开启动器，点右上角「Start」拉起内核与桥接，状态页显示两者均在运行即可使用。

从源码运行有两种方式：执行 powershell -File scripts\setup-runtime.ps1 下载运行时并把微信依赖装进 runtime 目录；或自行安装 Node 18+ 后运行 npm start，微信部分另需 Python 3.12 与 pip install -r requirements.txt。项目说明提醒，wechatauto 来自仓库内的 vendor 目录，pip 不会安装它，从源码运行桥接时需要把 vendor 加入 PYTHONPATH。更新方面，启动器内的「检查更新」会下载官方安装包、校验 SHA256 后静默覆盖安装，保留 data 目录与 config.json；源码版则使用 powershell -File scripts\update.ps1。记忆可通过 node scripts\memory-tool.js export 与 restore 导出和恢复。

许可与限制

许可证为 MIT。使用前需要了解的边界条件，据项目说明整理如下：

• 仅支持 Windows，安装器与启动器均面向 Windows 桌面环境。
• 安装路径必须是纯 ASCII，否则微信自动化无法工作。
• 需要自备 OpenAI 兼容的模型服务，README 举例包括 DeepSeek、智谱 GLM、Qwen 与本地 Ollama，但项目本身不附带密钥。
• 仓库是源码版，不含 runtime 目录；直接下载 ZIP 只得到约 400 KB 的源码树，没有运行时、密钥与聊天记录。
• 表情包功能默认关闭，且发送结果可能「未确认」，项目明确不自动重试，也不会替用户删除草稿。
• 关闭表情包开关无法撤回已发出的消息，重启服务不会重放旧任务。
• 从 3.x 升级时旧版 data/store.json 会被自动转换为 4.0 格式，原始文件保留在 data/memory/legacy 下。

需要说明的是，以上功能描述与限制均来自项目自身的 README，属于维护者自述，实际表现可能随版本变化，建议以仓库最新文档与 CHANGELOG 为准。