前言¶
用 DeepSeek Harness（DSH）做智能體開發時，常見做法是：左側 Web 對話，右側再開 IDE 或終端查文件、跑命令、看 Git 狀態。窗口來回切，上下文也容易斷。
下面介紹 loadingvx 維護的 deepseek-harness-workbench-plugin（npm 包名 dsh-workbench-plugin）。它在 DSH Web UI 的 Conversation 裏嵌入三欄工作臺：左側保留聊天，中間是編輯器與智能終端，右側是文件樹、Git、用量與 Ultra Slash。新建會話即可打開，不必先發第一條消息。
這是什麼¶
dsh-workbench-plugin 是面向 DeepSeek Harness Web UI 的工作臺插件。維護者爲 loadingvx，GitHub 倉庫約 26 stars。SkillHub 分類爲「模型推理」。
插件通過 Cordis patch 注入前端模塊，在瀏覽器內提供 CodeMirror 6 編輯器、本地 PTY 終端、Git 面板、API 用量視圖，以及不中斷當前輪次的 Ultra Slash 斜槓命令。許可證爲 MIT。
界面佈局¶
工作臺採用三欄結構：
- 左側：Conversation 聊天區
- 中間：編輯器（默認首 tab 爲 Agent Control Plane）與 Smart terminal
- 右側 dock：Files、Source Control、Usage、Ultra Slash
列寬可拖拽調整，雙擊分隔條可重置；各欄可摺疊爲圖標軌。摺疊狀態、右側 dock 當前 tab、Usage 固定位置會在全局記住，刷新或新建會話後仍保留。頁頭 Workbench 按鈕可整體顯示或隱藏工作臺。
核心功能¶
Agent Control Plane¶
編輯器第一個 tab，默認開啓，可在 Settings → Agent control plane 關閉。
Execution trajectory（默認頁）按時間線展示用戶消息、每輪 LLM 調用、工具執行與 Agent 回覆，左側魚骨線區分類型，可展開查看完整 I/O。
Capabilities 列出當前會話 Agent 的模型、工具、prompt 分段、子 Agent 與會話旋鈕，支持在線調整；約每 4 秒自動刷新，也可手動 Refresh 或 Clear all knobs。
Usage 用量面板¶
右側 dock 的 Usage tab，或固定到左側 Settings 按鈕上方（摺疊圖標軌時顯示緊湊條），用於查看：
- 官方 API 餘額（幣種隨 API，CNY 顯示 ¥，USD 顯示 $）
- 本機觀測支出（餘額下降累計，充值不清零；非官網終身消費）
- 本會話 token（輸入 / 輸出 / 緩存命中 / 緩存寫入 / 命中率）
- 當前上下文佔用
狀態欄 Feedback 左側同步顯示餘額。點擊 Official usage 打開 platform.deepseek.com/usage。
Ultra Slash¶
斜槓命令向下一輪模型注入指引，不中斷當前 turn。在右側 Ultra Slash tab 管理；聊天框輸入 /，在底部「插件命令」分組選用。
內置命令（不可改名或刪除）：
| 命令 | 作用 |
|---|---|
/steer |
注入指引 |
/new |
空白會話；/new <text> 以該消息開啓新會話 |
/skill |
任務結束後保存到 .dsh/skills/ |
/docs |
任務結束後寫入 docs/ |
/canvas |
任務結束後在 .canvas/ 創建或更新 Canvas |
自定義 /name 快捷鍵存於 ~/.dsh/ultra-slash/commands.json，本機所有會話共享，最多 40 條。
Canvas¶
Agent 寫入的 Canvas 文件位於工作區 .canvas/*.canvas.tsx（不在 IDE 配置目錄）。工作臺對 TSX 轉譯後在瀏覽器掛載 React 組件，支持編輯 / 預覽 / 分屏（類似 Markdown）。Agent 寫入後自動以預覽模式打開。發送 /canvas <topic> 可在不中斷當前輪次的情況下引導模型。
工作區編輯器¶
CodeMirror 6，支持 JavaScript、TypeScript、JSX、TSX、JSON、HTML、CSS、Markdown、Python、XML、YAML 語法高亮。鍵位模式 Plain / Emacs / Vim，默認 Emacs（直接插入，非 Vim normal mode）。
另支持 Markdown 編輯 / 預覽 / 分屏（含 Mermaid）、圖片與表格預覽（csv / tsv / xlsx）、Git diff 標籤頁、多文件 tab 與髒文件關閉確認。選中內容或整文件可通過 Add to chat 送入對話，無需複製粘貼。
Smart terminal 與 AI command assist¶
編輯器內嵌本地 xterm.js PTY，工作目錄爲當前 workspace。真實 shell 命令（含粘貼的 $ ls）直接執行；自然語言由 AI command assist 翻譯後寫入當前終端會話。
Alt + I或工具欄 ✨ 按鈕：打開 AI 命令輔助Alt + J：新建終端 tab（各 tab 獨立 PTY）- 問候、警告等說明性文字以不可執行形式寫入，不會當作命令運行
- 可配置破壞性命令黑名單（僅限制助手寫入的命令，用戶手動輸入不受限）
POSIX 側支持 bash / zsh / sh / dash；Windows 優先 Git Bash，其次系統 PowerShell。
文件、Git 與 Add to chat¶
Files：樹形瀏覽、過濾、隱藏文件、.gitignore 標記、新建 / 重命名 / 刪除；可在外部編輯器（Cursor、VS Code 等已安裝應用）打開。
Source Control：git status、暫存、提交（支持流式 AI 提交消息，模板可編輯）、fetch / pull / push（髒樹、落後遠程、detached HEAD 等會攔截危險操作，不支持 --force）、分支切換與合併、提交圖（GRAPH）。對話側提供 git_status、git_diff、git_log、git_branch、git_commit 工具。
Add to chat：從文件樹拖入文件或 DevTools 網絡請求；終端輸出右鍵添加選中或近期輸出（含 pwd / shell 上下文）；嵌入式瀏覽器點選頁面元素。均以引用 chip 形式進入輸入框，隨下一條消息發送。
通知音效與其他¶
會話結束或等待用戶（審批、計劃確認、提問）時播放提示音。Settings 中可選 5 種內置 Web Audio 音效或上傳自定義音頻（mp3、ogg、wav、webm、m4a、flac，最大 50 MB），支持循環提醒（默認每 10 秒，直至處理）。
界面支持中文與英文；內置升級檢查器；路徑與錯誤中的 token 會被脫敏。
安裝與啓用¶
前提：已安裝 DeepSeek Harness，且 dsh web 可正常啓動。
- 安裝插件（須指定版本；pnpm 11 對新版本有 24 小時延遲，省略版本可能裝到舊版 0.1.0）：
dsh plugin --profile web add dsh-workbench-plugin@0.1.31
若仍因版本過新被拒絕，在 ~/.dsh/profiles/web/pnpm-workspace.yaml 添加後重試：
minimumReleaseAgeExclude:
- dsh-workbench-plugin
-
重啓
dsh web。 -
打開 http://127.0.0.1:3080，進入 Conversation 並新建會話。工作臺右側立即出現，無需先發消息。
SkillHub / GitHub 源安裝（使用已構建的 lib/，源碼-only 提交會失敗）：
dsh plugin --profile web add github:loadingvx/deepseek-harness-workbench-plugin
典型用法¶
固定用量面板：打開右側 Usage，點擊固定圖標，面板移到左側 Settings 上方，聊天時可持續查看餘額與會話 token。
不中斷輪次注入指引：模型仍在運行時，在聊天框選 /steer 或自定義 Ultra Slash 命令，文本排隊到下一輪模型訪問，無需點 Stop。
終端自然語言轉命令：在 Smart terminal 按 Alt + I，輸入「列出當前目錄下所有 .ts 文件」，助手將翻譯後的 shell 命令寫入當前 PTY。
Canvas 原型預覽：發送 /canvas 儀表盤佈局，任務結束後 Agent 在 .canvas/ 寫入 .canvas.tsx，工作臺自動打開預覽。
AI 提交消息：在 Source Control 暫存變更後，生成提交消息，文本流式寫入提交框，確認後提交。
適用場景與注意¶
適合在 DSH Web UI 內完成對話驅動開發、希望同一界面內編輯代碼、跑終端、看 Git 與 API 用量的用戶。Agent Control Plane 適合調試多輪工具調用與在線調整會話旋鈕；Ultra Slash 與 Canvas 適合長任務中追加指引而不打斷當前推理。
安裝前請注意：
- 插件以當前
dsh進程權限運行，終端與 Git 操作作用於工作區，安裝前應閱讀源碼與 MIT 許可證。 - npm 當前 latest 爲 0.1.31（包名
dsh-workbench-plugin）；SkillHub 目錄頁顯示版本可能滯後。 - 0.1.1 不含升級提示器，需手動安裝 0.1.31；之後版本可在 UI 頂部看到升級通知，終端會以
#註釋形式給出安裝命令。
鏈接¶
- SkillHub 目錄：https://www.skillhub.cn/plugins/loadingvx/deepseek-harness-workbench-plugin
- GitHub：https://github.com/loadingvx/deepseek-harness-workbench-plugin
- npm：https://www.npmjs.com/package/dsh-workbench-plugin
