前言¶

DeepSeek Harness (DSH) 採用插件化架構，默認的控制台界面通常較爲基礎。對於需要頻繁查看 TRACE、JOBS 狀態或管理多會話的開發者而言，缺乏可視化的交互層會增加操作成本。dsh-phosphor 提供了一個全屏的基於終端的用戶界面 (TUI)，將 React 和 Ink 技術應用於 Cordis bundle 插件，解決了 DSH 交互層可視化的需求。

是什麼¶

dsh-phosphor 是一個爲 DeepSeek Harness 設計的全屏、矩陣風格 TUI 前端。它作爲一個 Cordis bundle 插件運行，旨在爲 DSH 提供沉浸式的交互體驗。該項目由 yaotongsb 維護，採用 MIT 許可證。

核心功能¶

該插件主要提供以下能力：

• 全屏 TUI 界面：提供沉浸式的終端操作體驗。
• 多主題支持：內置 matrix 和 terminal 兩種主題，可通過命令或配置切換。
• 側邊欄面板：支持 TRACE（追蹤）、JOBS（任務）、FILES（文件）三個側邊欄面板，用於查看 Agent 狀態和上下文。
• 命令系統：
  • /help：查看幫助。
  • /model：模型選擇器，支持輸入過濾。
  • /new：創建新會話（快捷鍵 Ctrl+N）。
  • /resume：會話恢復選擇器。
  • /attach <path>：爲下一條消息附加圖片（僅支持 png/jpeg/webp/gif）。
  • /settings：運行時設置面板。
  • /theme matrix|terminal：切換主題。
• 配置項：支持通過 cordis.patch.yml 配置 theme、matrixRain（數字雨背景）、scanlines（掃描線）、panelMode 等參數。

安裝與啓用¶

目前該插件僅限源碼分發，不支持通過 dsh plugin add github:... 命令安裝。你需要將 DeepSeek Harness 的源碼檢出與該插件位於同一父目錄。

1. 準備環境：確保安裝了 Node.js (>= 22.19 或 >= 24) 和 pnpm。
2. 檢出並構建 DSH：

    git clone https://github.com/deepseek-ai/deepseek-harness.git
    cd deepseek-harness && git checkout b150a551b8 && pnpm install && pnpm run build

3. 檢出插件：

    git clone https://github.com/yaotongsb/dsh-phosphor.git
    cd dsh-phosphor && pnpm install && pnpm build

4. 註冊插件：
   從 deepseek-harness 目錄運行以下命令，確保相對路徑正確：

    cd ../deepseek-harness
    pnpm dsh plugin --profile tui add ../dsh-phosphor

典型用法¶

啓動插件後，可以通過以下方式進行操作：

• 切換主題：輸入 /theme matrix 或 /theme terminal。
• 新建會話：輸入 /new 或按下 Ctrl+N。
• 恢復會話：輸入 /resume，通過鍵盤選擇並回車。
• 附加圖片：輸入 /attach <圖片路徑>（需配合支持視覺的模型使用）。
• 查看面板：在輸入爲空時，按下 Alt+T (TRACE), Alt+J (JOBS), Alt+F (FILES) 打開對應側邊欄。

適用場景與注意¶

• 源碼依賴：必須手動檢出 deepseek-harness 源碼，插件通過相對鏈接解析依賴，兩者需位於同一父目錄。
• 版本鎖定：嚴格鎖定在 dsh v0.1.1-rc.2。升級 DSH 主程序可能會導致插件功能異常或崩潰，直到插件發佈正式版本。
• 開發環境：插件在 Windows Terminal 下開發與測試，其他終端兼容性未知。
• 圖像渲染：終端環境不支持渲染圖片，附件僅顯示佔位符（▣ name (W×H)）。
• 性能限制：非常長的會話恢復速度較慢，且插件會根據系統負載自動調整背景動畫幀率。
• 歸檔功能：V1 版本中不支持反歸檔操作。

短結尾¶

dsh-phosphor 爲 DSH 提供了一個可視化的交互層，適合習慣終端操作並需要豐富狀態監控的開發者。由於目前處於源碼分發階段且依賴特定版本，使用前需仔細覈對環境配置。

GitHub 倉庫 | 插件目錄