dsh-console：DeepSeek Harness 控制台插件

DeepSeek Harness (DSH) 是一個智能體開發框架，插件化是其核心特性之一。在開發或調試過程中，通常需要在瀏覽器中操作 Web 界面，或在終端中管理 SSH 隧道。dsh-console 插件將 Web 服務管理、SSH 隧道操作以及單次提問功能直接集成到了 DSH 的命令行平面（Slash-Command Plane）中，減少了窗口切換的繁瑣。

核心功能¶

該插件由 Isanti2016 維護，提供以下能力：

管理 Web 服務：通過命令行啓動、停止、重啓或查看 DSH Web UI 的狀態。
管理 SSH 隧道：快速建立 SSH 隧道，將遠程服務映射到本地端口。
單次提問：使用無頭配置文件發送一次請求並獲取結果。
控制台 TUI：在終端中啓動圖形化控制台界面。

安裝與啓用¶

安裝該插件需要指定 --profile web，因爲它主要服務於 Web 上下文。執行以下命令：

dsh plugin --profile web add dsh-console

安裝完成後，重啓 dsh web 服務即可使用相關命令。

典型用法與配置¶

零配置狀態檢查¶

在 cordis.patch.yml 未配置具體參數前，插件提供默認行爲。重啓 dsh web 後，直接運行以下命令即可查看基礎狀態：

/web status：檢查 Web UI 是否運行（包含端口和 PID）。
/tunnel status：檢查 SSH 隧道是否已建立。

配置 SSH 隧道¶

若需使用 /tunnel start 啓動隧道，必須在 profile 的 cordis.patch.yml 中配置目標主機信息。

- id: dsh-console
  config:
    tunnelHost: '192.168.1.100'        # SSH 服務器地址
    tunnelUser: 'root'                  # SSH 用戶名
    tunnelKey: 'C:\\Users\\you\\.ssh\\id_rsa'  # SSH 私鑰路徑（可選）
    tunnelLocalPort: 3081               # 本地監聽端口
    tunnelRemotePort: 3080              # 遠程轉發端口

配置完成後，再次運行 dsh plugin --profile web 並重啓，/tunnel start 命令即可生效。插件會執行 ssh -N -L <tunnelLocalPort>:127.0.0.1:<tunnelRemotePort> ... 命令。

配置控制台 TUI¶

若需使用 /console 啓動 TUI 界面，需配置啓動命令。若 consoleCommand 爲空，該命令將被禁用。

- id: dsh-console
  config:
    consoleCommand: 'python C:\\tools\\dsh-tui\\main.py'

單次提問¶

使用 /ask <問題> 命令運行無頭配置文件。結果會通過命令平面渲染，不會進入模型歷史記錄。該命令受 askTimeout 限制（默認 150 秒），超時會被終止。

安全與注意事項¶

進程終止：在 Web Profile 中運行 /web stop 或 /web restart 會終止當前正在提供 UI 服務的進程。
SSH 密鑰：/tunnel start 使用配置的 SSH 密鑰進行連接。請僅對可信來源配置密鑰。
自動檢測：dshBin 參數默認爲空，插件會自動檢測運行進程中的 bin.js 路徑（通過 process.argv[1]）。若從源碼運行，通常無需配置此項。

生態背景¶

DeepSeek Harness 的理念是「一切皆插件」，社區目錄（如 SkillHub）與 DeepSeek 官方無從屬關係。本文介紹的插件是開發者自主貢獻的工具，使用前建議檢查源碼與許可證。

插件目錄: https://www.skillhub.cn/plugins/Isanti2016/dsh-console
項目地址: https://github.com/Isanti2016/dsh-console