前言¶
DeepSeek Harness 的核心理念是插件化。在本地開發或運行智能體時，管理連接的服務器往往需要手動維護 SSH 連接。dsh-server-deck 作爲一個插件，爲 DSH 客戶端提供了可視化的服務器管理入口。
插件簡介¶
dsh-server-deck 是 DeepSeek Harness 的服務器卡片儀表盤，由 meyaomiao 維護，採用 MIT 許可證。它解決了在 DSH 環境中缺乏直觀的服務器狀態監控和交互終端入口的問題。
核心功能¶
該插件提供以下能力：
- 服務器卡片儀表盤：實時監控在線狀態、CPU、內存、磁盤和延遲。狀態點通過顏色區分在線（帶呼吸光暈）、離線、探測中或未知。
- xterm.js 交互終端：點擊卡片可直接進入終端，支持 5000 行回滾、256 色顯示以及窗口尺寸實時同步。
- 趨勢視圖：獨立記錄並可視化 CPU/內存/磁盤的變化，支持多時間窗口（1小時、24小時、一週、一個月等）。
- 雙形態掛載：支持 better-sidebar 側邊欄頁籤或獨立抽屜。若安裝了 better-sidebar，會優先註冊爲側邊欄頁籤；未安裝則顯示爲獨立抽屜。
- SSH Config 導入：自動解析標準
~/.ssh/config文件，支持 Host、HostName、User、Port、IdentityFile、ProxyJump 等字段的解析與導入。 - 安全模型：API 與 PTY 升級路由僅迴環放行（127.0.0.1/::1），防止 DNS rebinding 與局域網直連。密碼與私鑰口令單獨存儲在
~/.dsh/server-deck.secrets.（權限 0600），臺賬文件不包含祕密。
安裝與啓用¶
使用以下命令安裝插件：
dsh plugin --profile web add dsh-server-deck
安裝完成後，需要重啓 dsh web 命令並強制刷新瀏覽器（Ctrl+F5）。重啓後，側邊欄的“+”菜單中會出現“服務器”頁籤。
典型用法¶
- 打開“服務器”頁籤，點擊工具欄的“📈 趨勢”按鈕，可以查看歷史數據趨勢。
- 點擊任意服務器卡片，即可進入 xterm 交互終端進行操作。
注意事項¶
- 安全：API 與 PTY 僅允許迴環訪問。祕密文件存儲在
~/.dsh/server-deck.secrets.，權限需設爲 0600。 - 系統兼容：Linux / macOS / BSD 走只讀 POSIX sh 探針；Windows OpenSSH 無 sh 時使用 PowerShell。
- 指標採集：指標採集在主機側常駐，默認間隔 10 秒（可選 30s / 1m），與面板是否打開無關。
總結¶
dsh-server-deck 爲 DeepSeek Harness 提供了從監控到終端交互的一站式解決方案，適合需要在 DSH 中管理多臺服務器的場景。
