Chat panel for the MuChe companion with per-user backend settings, plus an outbound bridge that runs tasks on the user's local dsh.
Install
# from npm (prebuilt)
dsh plugin --profile web add muche-dsh-plugin
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:NEINC1/muche-dsh-plugin
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
连接小沐（MuChe 数字生命）的 dsh 插件：可以和有持续状态的小沐聊天，小沐可调用本机 dsh 执行任务。
- 聊天浮层：左下角「小沐」入口，可拖动面板，微信式气泡，未读红点，主动消息实时弹入。
- 反向桥接：小沐可调用你本机 dsh 执行任务（出站常驻连接，不开入站端口）。
- 设置页：后端地址 + API key，每用户各自配置。
安装
在 DSH Desktop 的 DSH Terminal 里执行（裸命令默认装到当前激活 profile， 装完在托盘重启 DSH Desktop 即用）：
dsh plugin add muche-dsh-plugin
升级是同一条命令（重跑即升到最新版）。当前插件版本见 package.json 的 version（现为 0.4.6），dsh 本体须为上游锁定的 0.1.5-rc.2 同 cohort（见 pnpm-workspace.yaml）。
注意 dsh --profile desktop plugin add 的父 flag 写法上游不接受（plugin
子命令自带 --profile，见上游 rejectParentOptions），必报
required option '--profile <name>' not specified——别写。
使用
- 打开 dsh 设置 → 小沐，填后端地址和 API key（小沐后台生成），保存。
- 点左下角「小沐」开聊。反向桥接配好 key 即在线，无需额外操作。
后端地址口径：远端用户填 <公网基址>/api（公网入口只把 /api 反代到后端，少写前缀会打到 SPA 首页）；与后端同机时填 http://127.0.0.1:8000。
卸载
dsh plugin remove 'muche-dsh-plugin'
remove 只摘层与代码；本机配置（settings muche 命名空间）保留，重装免配。装完在托盘重启 DSH Desktop 生效。彻底清掉：按 dsh settings 用法删掉 muche 命名空间。
故障排查
| 现象 | 原因 | 做法 |
|---|---|---|
| 面板显示“连接不上” | 后端地址缺 /api 前缀，打到 SPA 首页 |
远端地址改为 <基址>/api |
| 面板 401，桥接也不在线 | API key 失效（账号重置或后台吊销） | 去小沐后台重签，到设置页更新 |
| 小沐说“dsh 没连上” | 本机 dsh 未运行，或插件版本低于桥接要求 | 先启动本机 dsh，再重跑安装命令升级插件 |
| 面板正常但桥接不工作 | dsh 本体缺本地执行依赖，或插件被加载两次（桌面端市场与 bundles 双挂载） | 看 dsh 日志有无反向桥接停用警告，升级 dsh 本体；桌面端到插件页确认小沐只装了一处 |
| 要看桥到底什么状态 | 面板“在线”只证明路由可达，工具要的是桥接池在线 | 同机 GET /api/muche/status（需过 dsh 鉴权），看 fibers[].mode/reason |
| 反向桥接任务无响应 | 同会话串行排队，或会话已失效 | 等待在途任务完成；sN 别名超 3 天消除后重开 |
| 安装时报 peer 缺失（cordis/schemastery） | 新 profile 的宿主镜像还没建，属一次性瞬态 | 不用管，重启 Desktop 后 dsh 启动镜像即补齐；dsh plugin list 见 muche-dsh-plugin 在列即正常 |
| 安装时报某子依赖 deprecated（如 node-domexception） | 警告来自桌面基础包的子树，不是本插件带的（本包零 bundle 依赖，ws 自身也零依赖） |
可忽略，不影响加载；等上游更新 |
反向桥接只调用户本机：后端把任务帧从该用户的桥接连递下来，插件在本地 dsh 进程内执行、结果原路回传。桥不在时后端明确失败，不回退服务器。
技术细节
小沐聊天 = 插件自绘面板 + 直连后端（HTTP 历史 + WS 双向），不进 dsh agent 循环、不建 dsh 会话（dsh 会话的隐藏机制与可聊天互斥，会话内 LLM 调用会注入 AGENTS.md 等噪音——面板形态从根上消除注入面）。
| 文件 | 职责 |
|---|---|
cordis.patch.yml |
组合包层：dsh plugin add 自动进 profile 层列表，免手写 YAML |
lib/index.js |
Host 入口（inject/apply） |
lib/config.js |
settings 命名空间 muche + 旧 JSON 配置迁移 |
lib/http.js |
后端 JSON 请求封装 |
lib/routes.js |
/api/muche/{chat,history,config,test} 同源路由 |
lib/backend_ws.js |
后端 WS 常驻客户端（桥接通道） |
lib/ws-proxy.js |
浏览器 WS 同源代理（backendUrl path 原样保留，远端须带 /api 前缀） |
lib/dsh-bridge.js + lib/dsh-call.js |
反向桥接：出站收 dsh_task，进程内直调 sessionController 执行，结果原路回传 |
反向桥接语义（一任务只执行一次）：同 session_id 串行、task_id 去重、断连在途即失败；会话复用/新建由小沐在工作区别名里决定。message_id 幂等（服务端 Redis SET NX 300s）。
执行核按上游锁定的 0.1.5-rc.2 接口编写：进程内直调 sessionController.create/prompt（与人用客户端同一实现），回复走 session/event 事件订阅（assistant/message 累积文本，turn/end 按 reason.kind 判定完成）。turn/end 共六种终态（completed/aborted/blocked/error/max-tokens/interrupted），调用方按种收敛，不静默。
依赖：@deepseek-ai/schemastery 为 peer（用宿主那份）；ws 自带。改动依赖前后必跑 pnpm test（deps.test.js 守卫）；重启 Desktop 前必跑全量测试，全绿才动。
开发
cd dsh && pnpm test # 重启 Desktop 前必跑，全绿才动
许可
MIT
Links
More in this category
FuRongJun-1999/dsh-memory★ 244
White-box AGI architecture exploration: metacognition (self-cognition loop), continual learning (knowledge flywheel), world model (condition space, spatiotemporal memory graph), self-improvement (bootstrap discipline), zero-LLM white-box pipeline, and auditable trust guardrails.
kenz1117/dsh-engram★ 7
Cross-session long-term memory under the "memory palace" metaphor: dual-scope SQLite stores (user + per-git-origin project), hybrid FTS5 + local-vector retrieval with RRF fusion and recency/proof ranking boost, automatic capture from the session log (including the final turn), provenance audit chains, consolidation distillation and decay forgetting, and a settings-page Memory Library panel with corridor topology, tour butler, and refurb list.
Jonah-Wu23/dsh-gungnir#dsh-plugin★ 5
Evidence-driven goal verification plugin for DeepSeek Harness. Locks goals via /ultragoal and verifies completion against command exit codes and generated artifacts, preventing the model from falsely reporting task completion.
MichengAI/dsh-pua★ 5
Adds /pua to steer the agent to try another approach and verify results before claiming completion, with 15 company styles, persona modes, global and per-conversation settings, and an optional loop that continues until a verification command passes, the iteration limit is reached, or the user cancels.
dsh-answer-reviewer★ 4
Agentic answer reviewer for DeepSeek Harness: each final assistant turn is re-reviewed by a separate LLM graded 1-100; below-threshold scores steer the agent back with concrete feedback. The score is shown as a chip on the answer's action row (green pass / red needs-work, with retry count and reason on hover). Live gate config over a 127.0.0.1 HTTP server, plus a collapsed dock above the composer and an optional right-sidebar tab via dsh-better-sidebar.
Kanadego/dsh-heartbeat★ 4
Heartbeat loop for DeepSeek Harness: every 20 minutes (by default) the agent wakes on its own to keep a local profile of your interests and preferences, search the web for things you care about, and keep what it finds. When it has something worth sharing, it sends a short package of notes to the sessions you link it to. A set of rules in code - quiet hours, busy windows, a daily limit, a cooldown - decides whether it may speak at all, and the agent in that session decides whether to actually say anything. Windows only.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.