前言¶
在模型推理的監控與評估中，平均數往往掩蓋了數據的分佈細節。爲了更準確地評估性能瓶頸或Token消耗的極端情況，計算百分位數是必要的手段。DeepSeek Harness（DSH）作爲插件化架構，允許社區開發者擴展基礎能力。dsh-percentile 專注於在本地進行百分位數的計算，無需額外的網絡請求。
是什麼¶
dsh-percentile 是一個針對 DeepSeek Harness 的插件，用於在模型推理流程中計算數據的百分位數值。該插件由開發者 uckkk 維護。其核心定位是提供輕量級的統計計算能力，不依賴外部網絡服務，確保在離線或內網環境下也能穩定運行。
安裝與啓用¶
安裝該插件需要具備 DeepSeek Harness 的運行環境，並且環境內必須滿足其依賴的 peer dependencies。
1、在終端中執行以下命令安裝插件：
dsh plugin add github:uckkk/dsh-percentile
2、確保當前 DSH 進程依賴的庫版本符合要求：
* @deepseek-ai/cordis 版本需在 ^4.0.1 以上
* @deepseek-ai/dsh-tools 版本需大於或等於 0.1.0-rc.6
核心功能¶
- 純 Node 實現：插件底層邏輯完全使用 Node.js 原生編寫，運行效率高。
- 無網絡依賴：所有的計算邏輯都在本地進程內完成，不會向外部 API 發起請求，降低了延遲並避免了網絡故障的影響。
適用場景與注意¶
- 適用對象：需要深入分析推理鏈路中各項指標（如耗時、Token 數量）分佈情況的開發者或運維人員。
- 運行權限：插件以當前 DSH 進程的權限運行，在安裝前建議查閱 GitHub 倉庫的源碼與 LICENSE（MIT），確認其行爲符合你的安全與合規要求。
結尾¶
dsh-percentile 爲 DSH 生態提供了一個輕量、本地的百分位計算方案，適合對數據分佈敏感的監控場景。更多細節與源碼，請參考 GitHub 倉庫 或 DSH 插件目錄。
