前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”，旨在通過模塊化擴展來增強應用能力。dsh-kit 是一個面向 DSH 瀏覽器界面的能力插件包，它通過零依賴、零構建的架構，爲 DSH 的界面加裝可選能力。當所有功能關閉時，DSH 保持原版狀態，不影響原有體驗。
安裝與啓用¶
在宿主環境滿足要求後，使用以下命令安裝最新版本：
dsh plugin --profile web add "github:zhouzhencheng07/dsh-kit#semver:*"
安裝或更新後，重啓 dsh web，工具行會出現文件樹、源代碼管理、知識庫、終端四個開關，工作臺以官方右側邊欄承載各類 dock 籤。
核心功能¶
dsh-kit 提供了以下獨立的能力模塊：
- 終端：底部多標籤終端塢，綁定開啓時所在會話。引擎爲官方
webTerminals服務，支持 PTY。 - 文件樹：以會話工作區爲根瀏覽，支持新建/重命名/刪除（回收站）/複製路徑/@到對話。
- 源代碼管理：頁內 git 工作臺，支持暫存/取消暫存/放棄/提交、分支切換、提交圖譜。
- 日程：只讀面板，數據結構化落盤至
$DSH_HOME/dsh-kit/schedule/（包含events/和entries/目錄）。 - 知識庫：左欄搜索+目錄樹，右欄閱讀籤。支持雙鏈跳轉（
[[頁#標題]]），支持導入本地文件並自動處理引用。 - 內置瀏覽器：Agent 驅動，支持快照、動作、斷言的 GUI 測試循環，支持人機共駕。
- 技能管理：設置面板新增頁面，支持複製、移動、刪除、禁用/啓用技能。
- 手機訪問：設置面板新增頁面，提供令牌鑑權網關（默認端口 3090）。
- 網頁搜索：免費多源引擎鏈，替換付費的
deepseek-official。 - 會話監視：自動重試 429 錯誤，流式輸出重複內容時自動停止回合並續跑。
- 會話通知：桌面通知 API，在回合收尾、上下文壓縮完成或等待批准時彈窗。
- 餘額與用量：顯示芯片與用量百分比（DeepSeek 出餘額，OpenCode Go / GLM Coding Plan 出窗口用量）。
使用說明¶
- 啓用功能：使用工具行開關或快捷鍵（
Ctrl+/、Ctrl+,、Ctrl+Alt+.、Ctrl+Alt+K）啓用終端、文件樹、源代碼管理、知識庫。 - 配置功能：在側欄“插件”中找到 dsh-kit 的“配置”頁，可自定義各功能開關、快捷鍵、搜索條數、會話監視參數等。配置保存即寫入 profile 並熱生效。
環境與依賴¶
- 宿主版本要求：dsh ≥ 0.1.5（依賴官方右側邊欄服務
sidebar.right）。 - Node.js：≥ 22。
- 依賴聲明：零依賴聲明；運行時從 profile fallback node_modules 解析。
- 數據目錄：知識庫數據目錄默認爲
dsh-kit/vault。 - 編輯權限：工作區文件不做插件內編輯，編輯需通過 agent 文件工具或本地編輯器。
