前言¶
在 DeepSeek Harness 里做「长期陪伴」型智能体时，常见做法是单独接 IM、单独做记忆层、再单独挂一个刷站插件。通道、人设、主人偏好和观影兴趣容易混在同一份上下文里，既难维护，也不利于隔离私聊内容。鲸伴（WhaleMate）把 QQ 私聊、经筛选的长期兴趣记忆，以及 Bili Whale 风格的 B 站选片与分享收进一个 DSH 插件；人设、刷站兴趣和主人私人偏好分开存放。下面介绍它是什么、能做什么，以及官方 README 中的安装与使用步骤。
这是什么¶
鲸伴是维护者 abbccdd 发布的 DSH 插件，GitHub 仓库为 abbccdd/dsh-WhaleMate。npm 包名为 dsh-pond（当前资料中版本 0.6.0），许可证 MIT。
它解决的核心问题是：在 Windows + DSH Web + QQ + B 站 这一组合下，让 Harness 中的伙伴通过 QQ 与主人聊天，记住经过筛选的长期兴趣，并把 Bili Whale 看过、分析过的视频按需分享到 QQ。微信与 X 在 README 中列为后续方向，当前没有实际接入。功能处于测试阶段：自动记忆是检索与提炼，并非训练模型；对话与视频记录是否准确仍需用户自行判断。
核心功能¶
资料中可核实的能力如下。
QQ 私聊与主人绑定。 通过配套腾讯 DSH QQ Bot 的主人保护适配版连接机器人；生成配对码后，由主人的 QQ 向机器人发送代码完成绑定。机器人只接受绑定主人的私聊，配对消息不进入模型。
长期记忆与资料连接。 可在设置中连接「公开人设」「报告和日记」，并开启「自动提炼长期记忆」。已有 Bili Whale 人设、偏好和文字记录不会被覆盖；连接前需确认要共享的资料内容。
B 站刷站与视频分享。 沿用附带兼容版 Bili Whale 的选片方式；鲸伴调用该组件分析视频。需要 B 站登录、可用网络与 FFmpeg。默认 4×4 抽帧是视频抽样，不等于完整观看。主动分享视频到 QQ 默认关闭，启用后只向已绑定主人发送，插件最多每 24 小时尝试一次；发送失败不会自动重试。
隐私与边界。 公开评论、动态和分享在附带版本中默认关闭。私聊敏感信息会尽力过滤、隔离，但不保证识别所有秘密。生物钟仅在 DSH 运行时工作。
安装与启用¶
安装前需已能运行 DeepSeek Harness、Node.js 20.3 或更高、pnpm；若要看视频画面还需 FFmpeg 且能在系统路径中找到。插件依赖下载需要联网。README 说明：安装仅在全新隔离环境测试过；已有复杂插件配置、其他操作系统和不同 DSH 版本尚需进一步验证。
1、安装鲸伴并重启 DSH
任选一种方式（命令与表述来自官方 README）：
dsh plugin --profile web add github:abbccdd/dsh-WhaleMate
若已安装支持自定义 GitHub 来源的社区插件市场，可在市场中输入 github:abbccdd/dsh-WhaleMate 并安装。DSH 原生插件列表不一定提供安装入口；是否被某市场收录由该市场决定。也可在 DSH 对话中请求安装到 web 配置，并按界面提示完成授权。
2、安装配套组件
打开 设置 → 鲸伴，点击「安装配套组件」，等待完成后再次重启 DSH。这一步安装本项目附带的兼容版 Bili Whale 和主人保护版腾讯 QQ 适配器，并准备缺失的默认资料；不会覆盖已有资料。当前界面安装功能支持 Windows 的 DSH Web 运行方式。
若遇到不同来源的同名组件，安装程序会停止且不会自动替换；同一目录已安装组件会跳过。已有 Bili Whale 或 QQ 插件的用户请先备份并手动处理版本冲突。
3、B 站与 QQ
在 设置 → 养鱼 填写 B 站登录信息并检查依赖；在 设置 → QQ 机器人 扫码连接机器人。
4、配对与可选能力
在 设置 → 鲸伴 点击「生成配对码」，用 QQ 向机器人发送显示的代码，再点击「完成配对」。按需点击「连接公开人设」「连接报告和日记」，并打开「自动提炼长期记忆」「主动分享视频到 QQ」。
QQ 主人配对、自动记忆、资料连接及主动分享均需本人操作；安装本身不会自动登录或开启发送。
典型用法与设置路径¶
可复现的流程与 README「使用和限制」一致，可按下面顺序自检。
- 完成安装与配套组件后，确认 B 站登录与 FFmpeg 可用。
- 完成 QQ 机器人扫码与主人配对。
- 在私聊中与伙伴对话；长期记忆依赖已开启的提炼与已连接的资料，而非安装即生效。
- 若启用主动分享，留意最多每 24 小时尝试一次的节奏，以及腾讯侧权限与平台规则。
不要将密码、密钥等交给机器人。视频评论、字幕和画面属于不可信内容；不要在公开会话中加载私聊。若给刷站会话完整文件权限，它仍可能访问本机文件；插件以当前 DSH 进程权限运行，安装前应阅读源码与 THIRD_PARTY_NOTICES.md 中的第三方声明。
组成与生态位置¶
本仓库附带 Bili Whale 的兼容修改版与 腾讯 DSH QQ Bot 的主人保护适配版；相关代码保留各自许可。DeepSeek Harness 的理念是「一切皆插件」；社区目录站点（如 SkillHub 上的插件页）与 DeepSeek / 幻方无官方从属关系，收录情况以各站点为准。
结尾¶
鲸伴面向需要在 DSH Web + QQ + B 站 上打通陪伴、分层记忆与观影分享、且接受测试阶段限制的 Windows 用户。经过上面的步骤，可以从官方仓库核对安装命令与限制说明，再决定是否接入生产环境。
