DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在構建智能體時，如果全量暴露工具集，會佔用大量 Token 且容易導致模型選錯；如果只暴露極簡工具集，又缺乏擴展能力。dsh-standard-toolkit 是一個裝進 DSH 的「工具管家」，通過暫存區管理工具，按需加載，用完自動收走。
定位與維護者¶
dsh-standard-toolkit 是一個 DeepSeek Harness 插件，由開發者 suanniniu 維護。它解決了智能體開發中工具管理混亂的問題，核心價值在於：節省 Token、按需自動擴展、支持現場造工具。
插件採用 MIT 許可證開源。
核心功能¶
該插件通過一系列機制實現工具的自動化管理：
- 工具暫存區：工具默認收在倉庫，不加載不佔 schema；被取用才「擺上桌面」。
- 按需自動擴展：通過觸發詞匹配，自動加載對應工具。
- 會話隔離：動態工具註冊在 agent 層，隨會話銷燬自動卸載，避免不同會話間的工具污染。
- 能力自我進化：模型可通過
register_new_tool現場創造工具，自動完成規範審查、冒煙測試、分類、入庫及立即可用。 - 兩級觸發詞匹配：支持強觸發（1 詞即匹配）和普通觸發（≥2 詞組合匹配），避免誤觸發。
- 安全機制：工具納入前必過規範審查（vetTool），訪問未注入服務會被拒絕，入庫前會進行冒煙測試。
安裝與啓用¶
安裝前請確保已安裝 Node.js (>=18)。
npm i dsh-standard-toolkit@1.1.1
發佈策略說明（v1.1.1 起）：npm 包僅包含插件核（index.js + skills/ + vendor/ + docs/），工具集不隨包發佈。toolbox/ 目錄是本地資產，需自行克隆倉庫或通過 register_new_tool 生成。
手動掛載插件通常涉及複製文件到 DSH 運行時目錄並注入配置。安裝腳本 install.sh 或 install.bat 可以完成複製、掛載和校驗工作：
# Linux/macOS/git-bash
./install.sh /path/to/dsh/runtime
# Windows
install.bat D:\path\to\dsh\runtime
安裝後重啓 DSH，日誌應出現類似 mode=auto 暫存區=N 雷達=M 的信息。
使用方式¶
用戶側¶
用戶側使用無感。正常對話即可，插件會根據觸發詞自動加載工具。
示例：
你：算一下2026-08-01到2026-08-16隔多少天
dsh：→（命中觸發詞，自動加載 days_between）→ 返回 15 天
模型側¶
插件會將可用工具名錄注入系統提示。模型可以使用以下兩個「鑰匙」工具：
load_tool(name)：按名加載工具到當前會話。register_new_tool(def)：現場創造新工具。
register_new_tool 支持參數包括 name、execute（源碼字符串）、parameters、smoke、triggerKeywords 等。註冊新工具需提供 smoke 參數進行冒煙測試。
自定義工具¶
自定義工具定義文件放在 toolbox/<分類>/ 目錄下，文件名即工具名。文件需默認導出對象，包含 name、execute、parameters、metadata（含 triggerKeywords 和 smoke）等字段。
export default {
name: 'days_between',
description: '計算兩個日期（YYYY-MM-DD）之間相隔的自然日天數',
parameters: {
type: 'object',
properties: { date1: {type:'string'}, date2: {type:'string'} },
required: ['date1','date2']
},
execute: async function (args, exec) { /* 純邏輯 */ },
metadata: {
triggerKeywords: ['算','隔','天'],
smoke: { date1:'2026-08-01', date2:'2026-08-16' }
},
}
安全與驗證¶
插件內置了安全審查機制：
* 規範審查：vetTool 檢查字段、JSON Schema、命名和服務訪問白名單。
* 異常捕獲：全鏈路異常捕獲，歸一化返回，絕不阻塞請求流。
* 冒煙測試：入庫前僅運行作者顯式聲明的 smoke 參數，避免誤觸真實副作用。
可以通過以下命令驗證插件邏輯：
cd dsh-standard-toolkit && npm test
適用場景與注意¶
- 適用人羣：DSH 智能體開發者，需要精細控制工具暴露範圍和會話環境的場景。
- 權限注意：插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
- 生態背景：DSH 生態目錄（如 skillhub.cn）是社區站點，與 DeepSeek 或幻方無官方從屬關係。
總結¶
dsh-standard-toolkit 提供了一套從工具定義、暫存、自動加載到銷燬的全生命週期管理方案。它通過暫存區和會話隔離，解決了 Token 佔用和工具污染問題，並通過 register_new_tool 降低了造工具的門檻。
