前言¶

在 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