前言¶
用 DeepSeek Harness 跑任务时，你多半关心的是模型有没有在干活、卡没卡住；朋友那边也一样，但普通 IM 只能告诉你「人在不在线」，看不到 Harness 会话里正在发生什么。若想在同一套 DSH 环境里和同样用 Harness 的人互通在线与任务状态，又不想搭账号服务器，可以装社区插件 dsh-friends（鲸友）。它通过公共 MQTT 中继只传密文，密钥来自双方约定的 6 位好友码，属于「零注册、零自有服务器」的端到端方案。
下面介绍插件定位、能力、安装步骤和典型用法；事实以 GitHub 仓库 README 与 package.json（当前版本 0.5.0，MIT）为准。
这是什么¶
dsh-friends 由维护者 zlwzk 发布，目录页：skillhub.cn/plugins/zlwzk/dsh-friends，源码：github.com/zlwzk/dsh-friends。
一句话：和同样在用 DeepSeek Harness 的好友互相看见是否在线、模型是否在跑任务、最近忙什么；支持个性签名、心情、戳一戳、加密聊天，以及小文件与插件分享。README 强调的重点不是传统「好友在不在」，而是「他的 AI 在不在、忙不忙」——一种人机混合的 presence。
DSH 生态里是「一切皆插件」；SkillHub 等社区目录与 DeepSeek / 幻方无官方从属关系，本文仅介绍该插件本身。
核心功能¶
以下均来自 README 功能表与说明。
在线与任务
- 实时在线：开着 DSH 即在线，关掉即离线；8 秒心跳，约 40 秒无心跳判离线。
- 任务状态：模型跑任务时显示「忙碌」，好友可见正在做什么。
- 异常提醒：任务卡住或报错时好友侧可显示红色提示。
好友关系
- 好友申请：默认需对方同意；可在「加好友设置」切为「无需同意，谁加都直接通过」。
- 邀请链接：形如
dsh-friends://add?code=…，粘贴到添加框可识别好友码。 - 申请收件箱：待处理（同意/拒绝）与已发出（撤回），标题栏有未处理数量徽章。
互动与资料
- 1v1 加密聊天、未读计数，记录存本地。
- 文件分享：≤64KB 内联直传，对方可保存到本机；更大文件会提示未发送（公共中继不适合大二进制）。
- 插件分享：从已安装插件里选一个发给好友，对方可复制安装命令。
- 给 AI 留言：好友打开鲸友时可见。
- 个性签名、心情 emoji、戳一戳（在线才生效）、仅自己可见的备注名、隐身模式（在线但不广播）。
安全与隐私（README 摘要）
- 端到端加密：AES-GCM 256，密钥由好友码经 HKDF 派生；中继只见密文。
- 6 位好友码即共享密钥，无账号体系。
- 关闭 DSH 页面时默认发
bye，好友立刻看到你下线。
给模型用的工具
安装后 AI 可用：friend_profile（昵称/签名/心情等）、friend_task（忙/忙完/卡住）、friend_sign_idea（根据最近活动写签名）、friend_inbox（申请收件箱只读）。可直接对模型说「更新一下我的鲸友签名」「告诉好友别戳我」等。
安装与启用¶
README 写明插件尚未发布到 npm，需用下列命令之一（桌面版把 --profile web 换成 --profile desktop）。装完重启 DSH，左侧栏会出现「鲸友」入口。
方式一：预构建包（推荐）
dsh plugin --profile web add https://github.com/zlwzk/dsh-friends/releases/latest/download/dsh-friends.tgz
方式二：从 GitHub 源码安装
dsh plugin --profile web add github:zlwzk/dsh-friends
package.json 要求 Node ^22.19.0 || >=24.0.0，peer 依赖 @deepseek-ai/cordis（>=4.0.0，可选）。插件以当前 DSH 进程权限运行，安装前建议自行浏览源码与 MIT 许可证。
典型用法¶
用好友码加人¶
- 打开鲸友面板，复制「我的好友码」那一行的 6 位码发给朋友。
- 对方点「＋ 添加好友」，粘贴码或链接后「发送申请」。
- 你收到申请（标题栏徽章 +「好友请求」）后点「同意」。
- 成为好友后即可互见在线与任务状态。
用邀请链接¶
在「加好友设置」→「邀请链接」复制链接；对方粘贴进添加框即可识别好友码。
会话里能做什么¶
点好友行上的气泡进入会话：底部输入框发消息；输入框左侧 ＋ 可「发送文件」「分享插件」「给 AI 留言」。
收不到申请时¶
面板右上角 ⟳ 刷新；确认连接状态为「已连接」，必要时用 ⇄ 换中继；确认对方当时开着 DSH（离线时申请不会自动重投，需重发）；若你设为「无需同意」，对方加你会直接成功，不会进申请列表。
适用场景与注意¶
适合谁
- 小团队或朋友间都用 DSH，需要轻量互通「Harness 是否在跑、忙什么」，并偶尔加密聊几句、分享小文件或插件安装命令。
技术侧已知限制（README）
- 公共 broker 不保证 SLA，高峰期可能延迟；状态约 8 秒广播一次，非毫秒级。
- 双方至少一方要开着 DSH 网页或桌面端才能互见。
- 好友申请需对方在线才能送达；对方离线时申请留在本地待发，下次上线不自动重发。
运维与信任
- 「无需同意」模式下好友码一旦公开，任何人可直接加你；不确定时保持默认「需要我同意」。
- 聊天记录与文件内容走加密通道并存本机浏览器，不上传明文到中继。
结尾¶
dsh-friends 把 DSH 用户的在线、任务与轻社交收进一个插件：好友码作密钥、公共 MQTT 只传密文、Host 侧负责本机持久化与模型工具。若要安装或查更新，可看目录页 skillhub.cn/plugins/zlwzk/dsh-friends 与仓库 github.com/zlwzk/dsh-friends。
