鲸伴 v1.47 · 上手指南

1. 取得完整客户端
从项目提供方取得完整纯净发行包，解压到可写目录。
双击“鲸伴.exe”或 start.bat。启动器需要与完整程序及运行环境一起使用。

2. 连接聊天模型
到“设置”填写自己的模型 API 配置。模型与在线语音按服务提供方规则计费。
QQ 图片理解需使用支持视觉的模型，当前项目配置要求 deepseek-flash。

3. 管理记忆
“长期记忆”可搜索、编辑、确认和删除，确认方式支持手动或自动。
“记忆方案”查看事件索引与整理状态，事件整理会产生正常 API 用量。
原始消息与记忆保存在本机，模型生成依然需要相应服务。

4. QQ 接入
到“QQ 接入”配置内置 OneBot 桥接并自行完成 QQ 登录。
设置自动回复白名单与相关权限。
到“跨端同步”手动填写本人 QQ 并保存。
绑定后两端合并读取近期对话，可按范围检索历史、图片、事件和有来源的长期记忆。
可单独开启客户端工具任务结果通知。普通闲聊不全部转发。
鲸伴和 QQ 桥接须保持运行，无需额外部署记忆服务器。

5. 会话迁移
到“设置 → 会话与记忆 · 导出 / 导入备份”管理迁移。
迁移包不含 API 配置、QQ 令牌、运行环境和本地语音模型，新电脑需重新配置。

本指南依据项目 v1.47，2026 年 10 月。