前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。當插件列表逐漸豐富後,開發者常面臨兩個具體問題:安裝的插件是否真的被加載並運行?如何找到公開的評估板進行基準測試?@trapstreet/dsh-trapstreet 旨在解決這兩個問題。
這是一個聯網工具,由開發者 trapstreet 維護,開源協議爲 MIT。它不需要你手動排查配置,而是直接讀取 Harness 運行時的內部狀態,並對接公開的評估數據。
安裝與依賴¶
安裝前,請確保環境滿足以下依賴項:
@deepseek-ai/cordis@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-tools
安裝命令如下:
dsh plugin --profile <name> add @trapstreet/dsh-trapstreet
也可以跳過 npm,直接從 GitHub 添加:
dsh plugin --profile <name> add github:trapstreet/dsh-trapstreet
注意:安裝目錄路徑可能導致依賴解析失敗,建議使用 tarball 打包方式安裝。
核心功能¶
該插件提供了兩個主要工具和一種分類能力。
1. trapstreet_checkup:本地插件狀態檢查¶
trapstreet_checkup 是一個無網絡、無 API 密鑰的工具。它直接讀取 Harness 運行時的加載器樹,列出已安裝的插件條目及其激活狀態。
它能發現那些“安裝成功但未進入加載器樹”或“加載器樹中模塊加載失敗”的插件。通過傳入 classify 參數,它還能根據社區目錄(如 skillhub.cn)對插件進行分類,識別出會話型或編排型插件。
使用示例:
# 檢查插件狀態
trapstreet_checkup
# 檢查狀態並分類
trapstreet_checkup classify
2. trapstreet_boards:公開評估板查詢¶
trapstreet_boards 需要網絡連接,用於查找 trapstreet.run 上的公開評估板。這是一個只讀操作,不涉及賬號登錄、API 密鑰或啓動運行。
它會列出評估板總數,並分類顯示:包含 DeepSeek 基準的、未測試 DeepSeek 的、以及空的評估板。你可以通過傳入板 ID 來獲取詳情,包括測試內容、代碼版本以及哪些條目來自 DeepSeek 模型。
使用示例:
trapstreet_boards
配置項¶
插件支持以下環境變量配置:
TRAPSTREET_BASE_URL:API 主機地址,默認爲https://trapstreet.run。TRAPSTREET_CALL_LOG:若設置該路徑,每次工具調用都會追加一行日誌到該文件,便於排查工具是否被模型正確調用。
注意事項¶
- 僅讀取數據:
trapstreet_boards僅從trapstreet.run獲取公開數據,不會啓動任何運行或寫入本地文件。 - 目錄關係:社區目錄(如 skillhub.cn)與 DeepSeek 官方或 Harness 本身無官方從屬關係,僅作爲資源索引。
- 安裝方式:如前所述,安裝目錄路徑可能導致依賴解析失敗,務必使用 tarball 方式。
總結¶
@trapstreet/dsh-trapstreet 提供了從本地插件健康檢查到遠程評估板查詢的完整鏈路。對於需要驗證環境或尋找基準數據的開發者,這是一個務實的輔助工具。