前言¶
在 DSH 中使用搜索類能力時,如果希望模型直接把 s1_search、s1_news、s1_crawl 等工具調用起來,dsh-s1 提供了一條更直接的插件路徑:它把 s1 相關能力註冊爲 DSH 的一級工具,而不是讓模型額外執行 shell 命令。下面介紹它的定位、能力、安裝方式和注意事項。
這是什麼¶
dsh-s1 是 superagents-lab 維護的 DeepSeek Harness(DSH)插件,用於把 s1 能力註冊爲 s1_* 形式的一級工具。
基本信息:
- 許可證:MIT
- Node 要求:
>=20.0.0 - GitHub:
https://github.com/superagents-lab/dsh-s1
核心能力¶
dsh-s1 註冊以下工具:
s1_searchs1_newss1_crawls1_sitemaps1_trending
它還會註冊一個 bundled s1 skill,用於幫助模型理解如何選擇合適的 s1 工具和參數。
當前未實現:
s1_screenshots1_deepcrawl
安裝與啓用¶
如果使用已發佈或可直接安裝的包,執行:
dsh plugin --profile web add dsh-s1
如果使用本地 checkout,可以先構建,再用文件路徑添加到指定 profile:
cd /Volumes/More/Products/search1api/ecosystem/dsh-s1
npm run build
cd ~/.dsh
dsh plugin --profile web add file:/Volumes/More/Products/search1api/ecosystem/dsh-s1
這裏的 npm run build 用於生成本地構建產物;後面的 dsh plugin 命令負責把本地路徑註冊到 web profile。
認證¶
dsh-s1 使用一個憑據變量:
export S1_KEY=...
需要注意:缺少 S1_KEY 時,工具調用會失敗,而不是插件激活失敗。
OAuth 流程尚未實現。
開發與構建¶
本地開發時可以按以下步驟執行:
npm install
npm run typecheck
npm run build
npm run typecheck 用於類型檢查,npm run build 用於生成可加載的構建產物。
適用場景與注意¶
dsh-s1 適合需要把 s1 搜索、新聞、抓取、站點地圖和趨勢能力接入 DSH profile 的場景。
安裝前建議檢查源碼、許可證和依賴環境;插件會以當前 dsh 進程權限運行。
另外,不要把 s1_screenshot 和 s1_deepcrawl 當成已可用能力。
鏈接¶
GitHub:
https://github.com/superagents-lab/dsh-s1