前言¶
在 DeepSeek Harness（DSH）里，常见用法是网页对话和插件扩展能力。若你希望在本机桌面上有一个可拖动、可聊天、并在你明确授权后观察选定窗口或屏幕的伙伴，而不是只在浏览器里打字，就需要一类带独立 Electron 窗口的客户端插件。dsh-friend（小鲸桌面陪伴）由 steady-sakura 维护，归类为客户端插件，把 dsh-pet 的动画角色、自备 API 的聊天，以及经授权的屏幕共享和本机记忆检索组合在一起；聊天与设置落在本机，向 API 发送记忆或画面需另行同意。
这是什么¶
dsh-friend 是 DSH 的桌面陪伴插件：桌边显示会动的小鲸，可双击展开聊天气泡、拖动与互动，也可在右键菜单里开启屏幕共享。它使用你自己配置的 Chat Completions 兼容接口（默认预填 DeepSeek 地址与 deepseek-flash），调用费用由对应服务商收取。插件通过 Cordis 注册网页侧栏入口与 /friend 等命令，桌宠按需启动，不随 Web 自动弹出。
维护者与仓库：steady-sakura，GitHub，SkillHub 目录页。当前 package 版本为 0.7.4，许可证 MIT。角色与 106 个动作素材来自 dsh-pet，桌面能力由 Electron 提供。
核心功能¶
聊天与界面¶
日常以桌边聊天气泡为主：双击桌宠展开，底部输入发送；长回复可在气泡内滚动。需要完整历史或更大窗口时，可打开「聊天记录」或「聊天面板」。模型回复可为文字、最多三个内置动作，或暂时沉默；轻点、拖动等互动会单独标注，与你的文字分开传给模型。
0.6.0 起默认采用自然正文与 companion_control 工具传递动作、记忆等控制；旧 JSON 接口可在设置里手动切到「旧 JSON 兼容模式」。
屏幕共享¶
可在右键或面板中选择应用窗口或整屏共享。共享需手动开启并授权，画面会发到你配置的 API 服务商；共享窗口可直接设置「多久看一次」（5 秒至 2 分钟）。可随时暂停或结束。使用前请先结束共享再升级或卸载。
本机记忆¶
默认开启本机记忆：完成的对话可按日期写入日记，长期摘记写入 memory/facts.json 等路径；检索在本机完成，不依赖向量库或额外嵌入 API。聊天时会按预算带入近期与相关记忆；向 API 发送长期记忆、日记或检索片段需在设置中勾选同意并核对接口地址。
可分别选择「角色文件夹」与「记忆文件夹」导入只读 .md / .txt；路径仅保存在本机，不发送绝对路径。
语音与其它¶
面板可开启本机语音朗读（默认关闭）；0.7 起使用内置离线中文引擎，需在设置中下载音色。默认每 300 秒可触发一次「自由活动」（会调用 API），可在设置关闭或调节。
网页侧栏 小鲸陪伴 通过 DSH Gateway 控制打开、关闭桌宠等固定操作，不另开本机 HTTP 服务，不把密钥送入 DSH 对话。远程浏览器连 DSH 时，桌宠显示在运行 DSH 的那台机器上。
安装与启用¶
环境要求：Node.js 22.12 或更新；建议使用 DSH 0.2.0-rc.2。插件已附带网页模块，安装时无需编译。
在 PowerShell 中执行官方安装命令：
dsh plugin --profile web add github:steady-sakura/dsh-friend
安装并启用后刷新 DSH 网页。左侧栏底部会出现 小鲸陪伴（README 中亦写作 🐋 小鲸陪伴），点 打开桌宠；首次通常会弹出设置窗口。仍可在 DSH 输入框执行 /friend。
若 0.5.0 出现 Failed to load plugins / dsh-friend: failed，README 建议更新到 0.5.1 及以上。从 0.4 或更早升级后若看不到网页入口，需正常重开一次旧 Web 进程。首次启动可能下载 Electron 43.3.0（准备阶段总限时 60 秒）；网络不可达时可设置环境变量 DSH_FRIEND_ELECTRON 指向兼容的运行时。
在设置中填入自己的 API Key 并 保存设置 后，双击桌宠即可聊天。API 地址应填根路径（例如带 /v1 的根），不要填完整 /chat/completions 路径。
典型用法¶
按 README 的首次使用顺序：
- 安装 Node.js 与 DSH，执行上一节安装命令并刷新网页。
- 点 小鲸陪伴 → 打开桌宠。
- 在设置窗口填入 API Key，保存。
- 双击桌宠聊天；右键打开设置、选择动作、屏幕共享或退出。
相处方式摘要：按住身体拖动，快速松手有甩动；右键可选 106 个动作之一或共享屏幕。只想聊天时可不开启屏幕共享与「向 API 发送记忆」选项。
升级前：先结束屏幕共享，在 设置 → 备份、更新与卸载 导出本机备份，再检查更新；完成后关闭旧桌宠并重新打开，在设置里核对运行版本。
卸载：通过 小鲸陪伴 → 卸载插件…、桌宠设置里的卸载入口，或 DSH 命令 /friend-uninstall 打开本机确认窗口，可选保留或删除聊天、日记、摘记等资料（详见 README「卸载与资料保留」）。
独立运行（不依赖 DSH 会话）：安装目录内可用 启动桌面陪伴.cmd（Windows）或 启动桌面陪伴.command（macOS / Linux），或在面板点 找到独立启动入口 定位目录。
适用场景与注意¶
适合已在用 DSH、希望桌面侧有可视化陪伴且 API 自控的开发者或用户。插件以当前 DSH 进程权限运行，屏幕与记忆涉及隐私与外传，安装前应阅读仓库 PRIVACY.md 与源码、MIT 许可证。SkillHub 目录为社区站点，与 DeepSeek / 幻方无官方从属关系。
直接使用 DSH 自带插件管理器或 CLI 移除不会经过插件的资料询问，本机资料需自行处理。Electron 与聊天数据保存在本机插件资料目录；多个 DSH 配置共用默认资料目录时，删除资料会影响其它配置。
结尾¶
dsh-friend 把 DSH 生态里的网页控制与独立桌宠窗口连在一起：自备 API 聊天、dsh-pet 动作、可选屏幕观察与本机记忆，边界在授权与设置里写清。进一步了解请查看 SkillHub 插件页 与 GitHub 仓库 的 README。
