前言¶
DeepSeek Harness（DSH）的設計理念是「一切皆插件」。在開發智能體或工作流時，模型經常會遇到瑣碎的重複性任務：按路徑取值、比對兩段文本的差異、轉換時區、給一列數字算分位等。心算容易出錯，臨時寫腳本又慢且不通用。
dsh-toolbox 插件就是爲了解決這類問題而生。它提供了一組本地運行的純函數工具，裝上就有十個，能夠替代手寫腳本，讓模型直接調用確定性工具。
是什麼¶
dsh-toolbox 是 DSH 的工具箱插件，由 qlheric 維護。它包含十個核心工具：json、calculator、encoding、diff、time、csv、regex、stat、markdown、schema。
這些工具全部在本地計算，不聯網、不讀寫文件、不執行代碼。它們零運行時依賴、零構建，純 ESM 模塊。這意味着相同的輸入永遠產生相同的輸出，非常適合用於寫斷言和自動化流程。
核心功能¶
插件內置了十個工具，覆蓋數據解析、編碼、計算、統計和校驗。
- json：按路徑取值（
$、.a.b、['鍵']、[下標]，支持負數和[*]通配）、獲取 keys、獲取 type、validate、format。 - calculator：算式求值。
- encoding：base64、base64url、url、hex 互轉，以及 md5~sha512 哈希、生成 uuid。
- diff：生成 unified diff、JSON 路徑級差異、CSV 逐行差異。
- time：獲取當前時間、時間轉換、時間加減、時間差計算。
- csv：解析 RFC 4180 格式 CSV、按列查詢、數值列統計、轉換爲 GFM 表格。
- regex：正則測試、查找、替換、解釋。
- stat：描述統計、分位、頻數、Pearson/Spearman 相關係數。
- markdown：生成標題、目錄、規範表格、去除標記、統計字數。
- schema：JSON Schema 子集校驗，支持本地
$ref。
安裝與啓用¶
使用官方命令安裝，注意不要使用 npm install（該包暫未發佈至 npm）。
dsh plugin --profile <你的 profile> add github:qlheric/dsh-toolbox
安裝完成後需要重啓 DSH 才能生效。
典型用法¶
json¶
獲取嵌套結構中的數據，支持多種語法：
* $：取根對象
* .a.b：點號路徑
* ['鍵']：鍵名取值
* [下標]：數組下標（支持負數）
* [*]：通配符
calculator¶
執行算式求值，安全地計算結果。
encoding¶
進行常用的編碼與哈希轉換，包括 base64、base64url、url、hex 互轉，以及 md5、sha256、sha512、sha1、sha384 和 uuid 生成。
diff¶
比較文本、JSON 或 CSV 數據的差異，支持 unified diff 格式輸出。
time¶
處理時間相關操作，包括 now、convert、add、diff。
csv¶
處理 CSV 數據，包括 RFC 4180 解析、按列篩選、數值列統計以及轉換爲 GFM 表格。
regex¶
提供正則表達式的測試、查找、替換和解釋功能。
stat¶
對數值數據進行統計分析，包括描述統計、分位數、頻數統計以及 Pearson 和 Spearman 相關係數計算。
markdown¶
輔助 Markdown 文檔處理，包括生成標題、目錄、規範表格、去除標記以及字數統計。
schema¶
校驗 JSON 數據是否符合 JSON Schema 子集規範，支持引用本地文件。
注意事項與適用場景¶
運行環境與依賴¶
- 不聯網、不碰工作區、不跑代碼：所有計算都在本地內存完成，不會訪問外部網絡或修改本地文件系統。
- Electron 桌面端兼容性：Electron 桌面端的
desktopprofile 不支持上述安裝命令（CLI 會拒絕接管）。在該環境下，需要手動修改package.json的dsh.profile.bundles配置，再使用包管理器安裝。 - npm 說明：目前該包尚未發佈至 npm，請勿嘗試
npm install。
安全與穩定性¶
- calculator 安全機制：不使用
eval，標識符必須命中白名單內的函數和常量。 - regex 安全機制：先體檢再運行。如果檢測到高風險量詞（如嵌套量詞）且輸入超過 4KB，會直接拒絕運行，防止災難性回溯。
- schema 校驗：遇到不認識的關鍵字會報出
schemaIssues，不會靜默忽略。 - 錯誤提示：失敗時提供人話提示，例如取不到鍵時會明確告知”沒有這個鍵”，而不是拋出堆棧。
- 時區處理：
time工具的時區隻影響呈現，內部計算一律按 UTC 進行。
適用場景¶
適合需要將模型與確定性工具結合的開發者。如果你正在構建 DeepSeek Harness 工作流，需要模型進行數據清洗、格式轉換、統計分析或文本對比，這是一個理想的工具箱選擇。
結語¶
dsh-toolbox 提供了一套標準化的工具集，旨在減少模型幻覺和手動腳本的工作量。通過這些本地化的純函數工具，可以顯著提升工作流的可靠性和複用性。
