DeepSeek Harness 的核心理念是“一切皆插件”。在使用過程中，開發者常面臨需要便籤記錄、API 成本追蹤、會話管理以及界面輔助功能的需求。dsh-toolkit 是一組純增量的原生插件合集，包含便籤、API 餘額與費用、推理等級、刪除會話、對話節點導航條和輕擬物皮膚。它通過官方插槽與獨立 API 路由注入，不修改 Harness 核心，卸載即可完全還原。
插件由 Vast-Unhurried 維護，遵循 MIT 許可證。安裝後需重啓 dsh 服務以加載宿主路由與客戶端 bundle。
安裝¶
推薦使用官方命令一鍵安裝全家桶：
dsh plugin --profile web add "github:Vast-Unhurried/dsh-toolkit"
如需按需安裝單個組件，可指定倉庫內的路徑：
dsh plugin --profile web add "github:Vast-Unhurried/dsh-toolkit#path:packages/dsh-note"
dsh plugin --profile web add "github:Vast-Unhurried/dsh-toolkit#path:packages/dsh-session-delete"
核心功能¶
便籤（dsh-note）¶
在輸入框工具行打開。支持新建便籤、查看歷史記錄（上限 30 條）、拖拽窗口。雙擊歷史條目即可進入行內編輯，停止輸入約 0.6 秒自動保存。文本上限 16,000 字符。數據落盤位置爲 $DSH_HOME/storages/dsh-note。
API 餘額與費用（dsh-api-balance）¶
在會話頭部操作行顯示餘額徽章。雙擊徽章可打開“模型計費管理”，配置多個供應商、模型及費率，支持峯谷計價（週一至週五 9:00–12:00、14:00–18:00 爲高峯）。懸停徽章可查看今日消耗。切換會話或供應商時，徽章會自動切換顯示對應餘額。
推理等級（dsh-reasoning-levels）¶
在官方模型選擇器中，爲 pi-ai 供應商的模型提供 low / medium / high / xhigh / max 五檔推理等級。支持五檔的模型默認檔位爲 Max。同一供應商內可混排支持與不支持檔位的模型，reasoningEfforts: false 的模型不顯示檔位。
刪除會話（dsh-session-delete）¶
在會話列表 ⋮ 菜單中新增“刪除會話”。點擊後徹底清理 JSONL 會話日誌、工作區登記及歸檔集合。刪除前會彈窗確認並展示會話 ID，拒絕刪除運行中的會話。
對話節點導航條（dsh-session-nav）¶
在文字列與滾動條之間的右緣常駐節點串。每條 user 提問一輪次一短橫條。支持懸停預覽（顯示該輪全部內容）、單擊跳轉並置頂、雙擊釘住（數量不限，localStorage 持久化）。最多同時顯示 6 條，超出部分可通過滾輪翻看。激活條（DeepSeek 藍）會跟隨閱讀位置自動滾入可視區。
輕擬物皮膚（dsh-softui-skin）¶
修改自 Lhy723/dsh-neu-theme。在設置 → 通用設置 → 外觀中開啓系統原生開關。啓用後，淺色（奶油暖白）/ 深色（墨藍夜）皮膚將跟隨系統原生外觀。關閉開關後，頁面與 Harness 原生完全一致。
卸載¶
# 卸載全家桶
dsh plugin --profile web remove dsh-toolkit
# 卸載單個組件
dsh plugin --profile web remove dsh-note
dsh plugin --profile web remove dsh-api-balance
注意事項¶
- 環境要求：需要 DeepSeek Harness v0.1.0-rc.7+（Web 界面），Windows 實測；pnpm ≥ 9。
- 安全校驗：所有 API 路由做同源校驗，要求 Host 爲迴環地址且 Origin 與 Host 精確一致。
- 數據保留：卸載後便籤數據文件默認保留，如需徹底清除需手動刪除
$DSH_HOME/storages/dsh-note。
