前言¶
DeepSeek Harness（DSH）把能力拆成可安装的插件，开发者通常在本地 Terminal 或 Desktop 里跑 agent、调工具。若你希望有一个带持续对话状态、又能把任务下发到你本机 dsh 的「数字生命」侧车，而不是每次都在 dsh 会话里从零开始，就需要在 Desktop 里接一条独立聊天通道，并处理聊天记录存放与反向执行的安全边界。
下面介绍社区插件 muche-dsh-plugin（维护者 NEINC1，SkillHub 分类：工作流）：它连接小沐（MuChe 数字生命），在 DSH Desktop 左下角提供聊天浮层，聊天记录由服务端持有；同时通过出站常驻连接做反向桥接，让小沐在你本机 dsh 进程内执行任务，无需为本机开入站端口。
这是什么¶
muche-dsh-plugin 的定位是：连接小沐后端的 DSH 插件。你可以和有持续状态的小沐聊天；小沐在授权与桥接就绪时，可调用你当前 profile 下的 dsh 执行任务。
与「把聊天塞进 dsh agent 循环」不同，README 说明小沐聊天走插件自绘面板并直连后端（HTTP 收发 + 后端 WebSocket 下行），不进 dsh agent 循环、不建 dsh 会话，以避免会话内 LLM 注入 AGENTS.md 等上下文噪音。
- 目录页：https://www.skillhub.cn/plugins/NEINC1/muche-dsh-plugin
- 源码与说明：https://github.com/NEINC1/muche-dsh-plugin
- 许可证：MIT（见仓库 LICENSE）
核心功能¶
以下能力均来自仓库 README 与 package.json 描述，可按需裁剪使用。
聊天浮层¶
- 左下角「小沐」入口，面板可拖动；聊天气泡、未读红点、主动消息实时弹入。
- 输入框支持
Ctrl+V粘贴图片（与点「图」按钮选图一样进入预览、校验与发送）；纯文本粘贴保留浏览器原行为。
服务端直读¶
- 聊天记录只在服务端；面板首屏单页、增量归一、游标翻页。
- 0.5.0 起本机不存任何聊天文件，重装或换机无需迁移本地聊天目录；旧版遗留的
~/muche-dsh-workspace/messages/若存在需手动删除。
反向桥接¶
- 小沐通过出站常驻连接调用你本机 dsh 执行任务，不开入站端口。
- 桥接协议自 0.7.0 起为 v2（见 README）；后端把任务帧经该用户的桥接连递下来，插件在本地 dsh 进程内执行并原路回传；桥不在时后端明确失败，不回退到服务器侧代跑。
设置与连接¶
- 设置页：每用户各自配置后端地址与 API key（小沐后台生成）。
- 后端地址填实际基址（例如
<公网基址>/api）；插件不再自动补/api后缀，是否可用以设置页「测试连接」为准。 - 统一健康检查：
GET /api/muche/health，一次返回鉴权、历史与 WebSocket 三段结论。
面板状态提示¶
标题栏表示聊天通道是否可收发（与反向桥接在线与否无关）：
| 显示 | 含义 |
|---|---|
| 连接中 | 启动后正在建立聊天连接 |
| 在线 | 收发两侧都已就绪 |
| 离线 | 连接不可用 |
配置类问题统一提示「请检查配置」；网络中断为「连接暂时中断，正在重连」；额度耗尽为独立提示，不影响「在线」状态。
安装与启用¶
环境要求¶
package.json 声明：
- Node：
>=22 - DSH 宿主：
0.2.0-rc.2（engines.dsh；与市场阻断旧宿主安装的策略一致） - 当前插件版本：0.8.2
peer 依赖需与宿主同 cohort（如 @deepseek-ai/dsh-llm、@deepseek-ai/dsh-tools 均为 0.2.0-rc.2）。
安装¶
在 DSH Desktop 的 DSH Terminal 中执行（裸命令默认装到当前激活 profile；装完后在托盘重启 DSH Desktop）：
dsh plugin add muche-dsh-plugin
升级重跑同一条命令即可。README 提醒：不要使用 dsh --profile desktop plugin add 这类父 flag 写法，应使用 plugin 子命令自带的 --profile，否则会报 required option '--profile <name>' not specified。
配置与开聊¶
- 打开 dsh 设置 → 小沐，填写后端地址和 API key，保存。
- 点击左下角「小沐」开始聊天。
- 反向桥接在 key 配置正确后即在线，无需额外开关。
典型用法¶
经过上面的安装与配置，日常使用可以概括为：
- 文本与图片对话：在浮层输入文字，或用
Ctrl+V/ 「图」按钮发送图片。 - 查历史：首屏从服务端拉取，翻页走游标；本机无聊天文件副本。
- 本机任务：小沐侧下发任务时，由插件经桥接 v2 在本机 dsh 内执行（含会话创建、prompt、事件订阅及交互式提问/授权等，细节见 README「技术细节」折叠段）；执行权限等同于当前 dsh 进程与用户环境。
卸载插件不会删除 profile 里 muche 的配置段，重装可免配：
dsh plugin remove 'muche-dsh-plugin'
若要彻底清掉密钥与地址，需手动删除 profile patch 里 muche 条目的 config 段。卸载后同样要在托盘重启 Desktop。
适用场景与注意¶
适合谁
- 已在用小沐（MuChe）并希望把对话入口固定在 DSH Desktop 的开发者。
- 需要「服务端持久对话 + 本机 dsh 执行」组合，且接受出站连接、不暴露本机入站端口的部署方式。
务必知晓
- 插件以当前 dsh 进程权限运行；反向桥接会在本机执行小沐下发的任务。安装前应阅读源码与 MIT 许可证，并只连接你信任的小沐后端与 API key。
- DSH 插件生态遵循「一切皆插件」思路；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系，本文不构成安全审计。
- 排障时 README 提到宿主
bridgeId经官方 settings 保存，同宿主双挂载共享，不要随意删除或复制该身份。
结尾¶
muche-dsh-plugin 把「有状态的小沐聊天」和「本机 dsh 反向执行」收进 DSH Desktop 一条工作流：聊天在浮层、数据在服务端、任务在本机 dsh。若你要从目录或源码进一步了解，可从 SkillHub 插件页与 GitHub 仓库 README 对照版本与 cohort 要求。
- https://www.skillhub.cn/plugins/NEINC1/muche-dsh-plugin
- https://github.com/NEINC1/muche-dsh-plugin
