前言¶

在 DSH 里做智能体或本地 MCP 编排时，右侧栏往往要分别打开不同入口：上下文检索是否在跑、本地 embedding 是否加载、MCP 进程或容器是否存活、当前有哪些 Harness 会话。信息分散时，排查「卡在哪一环」要来回切换。维护者 askred-dot-ru 的 dsh-pult（界面称 Пульт）把上述能力收进 DSH 右侧栏同一列：一个浏览器 bundle、统一样式，不做本地 сборка。插件归类为 客户端，当前版本 1.20.1，许可证 MIT。

下面按定位、功能、安装、配置与注意点说明，事实与 GitHub README 一致。

这是什么¶

dsh-pult 是 DSH 插件，占用右侧边栏一个 tab（「Пульт」）。一列内自上而下为四个区块，外加设置页可开关各区块（关闭后不渲染、不发对应请求）：

交付物为已打包的 client.js；宿主侧仅用 node: 与 fetch，无额外 npm 依赖。插件不修改已安装的 dsh 本体，通过 Cordis patch 注入 bundle。

环境与可选依赖¶

必需：

• dsh 使用包含 connection 与 ui-sidebar-right 的 profile（属于 composition dsh-web-app，即常见 desktop/web 交付）。
• Node.js ^22.19 || >=24（与 dsh 一致）。

按区块可选：

• Docker：容器行需要；无 Docker 时带 container 的行无状态，操作会报错。
• LM Studio 默认 http://127.0.0.1:1234：模型区块。
• cfsmcp2 默认 http://127.0.0.1:8559/mcp/：上下文目录。
• zstd（README 示例：brew install zstd）：会话导出；会话日志为 zstd 帧链，内置 zlib 只读首帧。

缺少某一后端时，对应区块会提示不可用，不影响其他区块。

安装与启用¶

插件 直接从 GitHub 安装，无需 clone、无需构建。

通过 DSH 界面¶

1. 侧栏 → Plugins → Add plugin。
2. 填入仓库地址：

github:askred-dot-ru/dsh-pult

（亦支持 https://github.com/askred-dot-ru/dsh-pult.git 或本地已有克隆路径。）
3. Install → 等待 pnpm → Enable now（自动写入 profile bundle，不必手改 package.json）。
4. 重启 dsh：Loader 行在进程启动时读取。

通过 CLI¶

dsh plugin --profile desktop add github:askred-dot-ru/dsh-pult
# 随后将 bundle 列入 profile：在 ~/.dsh/profiles/desktop/package.json 的
# dsh.profile.bundles 中加入 "dsh-pult"（plugin add 仅安装依赖）
pnpm install            # 若手改过 package.json，在 profile 目录执行

profile package.json 结构示例（README）：

{
  "dependencies": {
    "dsh-pult": "link:/путь/к/клону/dsh-pult"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-pult"
      ]
    }
  }
}

验证与回退¶

• 插件卡片应出现 dsh-pult；侧栏出现 「Пульт」 tab 与四个分区。
• Git 源插件不会自动更新；卡片 Обновить 即重装较新版本。
• 回退：在卡片禁用，或从 dsh.profile.bundles 与 dependencies 移除 dsh-pult，在 profile 目录 pnpm install 后重启 dsh。
• 若曾安装 @local/mcp-panel（同一面板的旧名），请禁用：共用 TAB_ID，并存会争用侧栏位置。

会话与其它近期能力（版本说明）¶

README「Что нового」中与运维相关的要点（便于判断是否升级）：

• 1.20.1：侧栏与 tab 统一命名 Пульт；服务器分组文案为「Серверы」。
• 1.19.0：标题栏 ⚙ 可开关五块：cfsmcp2 目录、LM Studio、服务器与容器、Oh!MyMind、会话。
• 1.18.0：标签设置中 「применять cfsmcp2」：关闭后会话列表完全不访问 cfsmcp2。
• 1.17.x：会话列表过滤（名称 + cfsmcp2 标签 + 自定义标签）、标签分组与符号、按组导出列、归档（📦）、运行时长、访问级别颜色等。

配置¶

所有 bundle 配置键均为可选；默认来自包内 cordis.patch.yml，可在 profile 的 cordis.patch.yml 或 插件卡片 中覆盖。

- insert:
    - id: pult
      name: 'dsh-pult'
      config:
        targets: []
        pollMs: 5000
        probe: true
        confirmActions: false
        url: http://127.0.0.1:8559/mcp/
        contextsTtlMs: 300000
        contextsTimeoutMs: 8000
        indexTtlMs: 3000
        importTimeoutMs: 120000
        lmStudioUrl: http://127.0.0.1:1234
        lmStudioTimeoutMs: 4000
        # sessionsRoot: ~/.dsh/sessions
        # exportDir: ~/Downloads
        # openExport: true

常用键含义（摘自 README 表格）：

targets 为空时不会猜测第三方 MCP；要在「服务器与容器」看到行，需在配置中显式声明监控对象（具体字段格式见仓库 README 后续章节）。

典型用法¶

1. 本地 RAG / cfsmcp2：启动 cfsmcp2 后打开 Пульт，在上下文区查看索引进度，必要时对单个上下文执行加载；会话区可用 cfsmcp2 标签与会话自定义标签联合过滤。
2. embedding 就绪检查：在 LM Studio 加载 embedding 模型后，该区块应显示模型；仅 LLM、无 embedding 时区块以红色提示（README 截图场景）。
3. MCP 与 Docker 运维：在 targets 配置进程或容器后，用中部列表查看状态并执行 start/stop/restart（confirmActions: true 时可防误触）。
4. 会话整理与导出：使用置顶、归档、按日分组；跨时段导出依赖系统安装 zstd。

适用场景与注意¶

适合谁： 已在 desktop/web profile 使用 DSH，并同时维护 cfsmcp2、LM Studio embedding、若干 MCP/容器与 Harness 会话的开发者——需要一块侧栏总览而非多工具切换。

安全与权限： 插件以 当前 dsh 进程的用户与权限 运行；可触发 Docker 操作、读写会话目录与导出路径。安装前请阅读源码与 MIT 许可，确认 targets 与 URL 指向你信任的服务。

生态说明： DSH 奉行「一切皆插件」；社区目录 SkillHub 条目 与 GitHub 仓库由社区维护，并非 DeepSeek / 幻方官方应用商店。

结尾¶

dsh-pult 把 cfsmcp2 上下文、LM Studio embedding、MCP/容器与会话列表收成 DSH 右侧栏 Пульт 一页，安装来自 GitHub、无构建步骤。进一步了解与问题反馈：

• 目录页：https://www.skillhub.cn/plugins/askred-dot-ru/dsh-pult
• 仓库：https://github.com/askred-dot-ru/dsh-pult