前言¶
DeepSeek Harness (DSH) 側重於插件化架構。開發者在使用過程中常遇到兩個具體痛點：一是無法直觀預估單次請求的 token 消耗，二是缺乏跨會話的消耗統計與成本追蹤，以及提示詞優化的重複操作。dsh-plugins 是一個個人維護的插件集合包，旨在通過一個倉庫安裝三個常用插件，解決上述問題。
核心功能¶
該插件集包含以下三個主要組件：
* tokprev：單輪 token 輸入預告與真實消耗徽標。
* tokstats：跨會話 token 消耗統計面板。
* promptopt：Composer 草稿提示詞 AI 重寫工具。
功能詳解¶
tokprev：Token 預告與實報¶
該插件提供單輪 token 消耗的“事前預告 + 事後實報”閉環。
1. 發送前預告
在 Composer 底部顯示下一輪輸入的預估值。該數值由三部分組成：上下文基座、排隊消息和草稿內容。隨着打字實時跳動。同時顯示輸入佔比及輸出預估區間。
2. 真實消耗徽標
每輪對話結束後的最後一跳 assistant 消息上，會渲染一行弱化小字，顯示該輪所有調用的真實消耗。計費輸入口徑包含 inputTokens、cacheReadTokens 和 cacheWriteTokens。
tokstats：跨會話統計¶
DSH 宿主的 StatsLine 僅支持單會話統計，本插件通過側欄腳按鈕打開彈層面板，展示跨會話的詳細數據。
1. 統計維度
支持按時間段（今日、本週、累計）查看請求數與 token 桶。支持按工作區聚合（子會話沿 parent 鏈歸併到根工作區），以及按模型分組查看成本估算。
2. 初始化
首次安裝後，面板顯示“統計中…”，直到任一會話被打開或統計推送到達。
promptopt：提示詞優化¶
在 Composer 卡片內部工具行（模型選擇與發送按鈕之間）提供星標按鈕。點擊後調用模型對草稿進行重寫，原文與優化文上下對照，僅“採納”後纔將優化結果寫回輸入框。
1. 語言與限制
優化產物跟隨草稿語言，不進詞典。若草稿包含引用 chip、圖片或 / 命令，按鈕會被置灰禁用。
2. 性能與開銷
這是一個旁路模型調用，不會計入跨會話統計日誌，也不支持在配置面板選擇模型。
安裝與啓用¶
本插件包採用 pnpm 作爲安裝轉接器，支持從 GitHub 倉庫直接安裝。
npx @deepseek-ai/dsh plugin --profile web add github:PlusQi/dsh-plugins
安裝後需要重啓 dsh web 進程，profile 組合僅在啓動時生效。
單插件開關¶
若需臨時關閉單個插件而不修改代碼，需編輯宿主的配置文件：
# 編輯 ~/.dsh/profiles/web/cordis.patch.yml
- id: tokprev
disabled: true
重啓生效。注意，禁用插件僅移除宿主側的 fiber，對於純界面插件（如 tokprev），瀏覽器側界面可能不會立即消失，需等待包內無其他存活插件時纔會卸載。
注意事項¶
- Locale 依賴：插件依賴宿主的 locale 服務。若宿主未開啓或被禁用，整包將不加載，表現爲插件 UI 消失且無日誌。
- 成本估算：tokstats 的金額爲估算值，基於 DeepSeek 官方高峯單價，可通過 patch 文件覆蓋。
- Promptopt 行爲：優化產物不落盤，無 checkpoint；採納時以發起時刻的草稿快照爲準，會覆蓋後續的改動。
