前言¶

DSH 的插件結構允許把工具加入 profile 的 layer stack。對智能體來說，很多判斷依賴當前環境：平臺是什麼、shell 是什麼、哪些命令在 PATH 上、軟件版本是多少、CPU、內存、磁盤還剩多少。如果這些靠模型猜，或靠多條慢發現命令逐條試，既不穩定也浪費工具調用。

下面介紹 @deepseek-ai/dsh-tool-scout。它提供 environment_probe 工具，按需讀取運行時環境、PATH 命令、軟件版本和主機資源，輸出規範化 JSON 對象，同時保留人類可讀文本。

這是什麼¶

它是一個面向 DeepSeek Harness 的模型可見環境探測工具，以 dsh bundle 形式安裝，自帶 cordis.patch.yml，並加入 profile 的 layer stack。

包名爲 @deepseek-ai/dsh-tool-scout，版本爲 0.0.1-rc.2，許可證爲 MIT，package.json 標記 private: true。package.json 標記 author 爲 ExDragine；倉庫路徑線索爲 omdsh-dev/dsh-scout，README 標題爲 dsh-tool-scout。已抓取資料未直接說明最終維護者。

核心功能¶

• 提供 environment_probe 工具。
• scope 支持 environment、commands、software、resources、apps、serial、usb、network、gpu、ports、services、workspace、printers。
• names 可限定命令、軟件、應用或打印機名稱；對 environment、resources、serial、usb、network、gpu、ports、services、workspace 無效。
• 探測運行時環境，如 platform、arch、hostname、user、home、cwd、Node、shell、timezone、locale、endianness、PID、dsh home。
• 檢測 PATH 上可解析的命令。
• 檢測已安裝軟件及版本。
• 檢測 CPU、內存、磁盤等主機資源。
• 檢測 TCP 監聽端口及可見進程。
• 檢測系統服務狀態。
• 檢測工作區工具鏈信號。
• 檢測 serial、usb、network、gpu 等硬件或主機信息。
• apps 僅在 macOS 上可用，其他平臺報告不可用。
• 所有 scope 只讀；不以模型輸入調用 shell；僅讀取精選環境變量 allowlist，不讀取完整 process.env。
• 版本探測使用 execFile(name, ['--version'])，並帶超時、併發上限和 TTL 緩存。
• 輸出規範化 JSON 對象，同時保留人類可讀文本。
• 插件貢獻 tool:scout prompt section，建議在假設平臺、shell、命令可用性、軟件版本、資源限制、監聽端口、服務狀態、項目工具鏈或打印機前先探測，並只請求需要的 scope。

安裝與啓用¶

包作爲 dsh bundle 安裝。已覈實資料給出的安裝命令是本地路徑形式：

# from the public Harness source checkout:
cd /path/to/deepseek-harness
pnpm dsh plugin --profile web add /path/to/dsh-scout

執行後需要重啓 dsh 進程。profile 的 dsh.profile.bundles 會增加 @deepseek-ai/dsh-tool-scout，environment_probe 工具會出現在工具列表中。

已覈實資料未給出 registry 安裝命令；不要按插件名拼接其他安裝形式。

典型用法¶

默認 scope 是 environment。scope 可爲單個類別、有序類別數組或 all。

{ "scope": "environment" }

若只關心機器人調試相關的硬件或主機信息，文檔示例爲：

{ "scope": ["serial", "usb", "network"] }

names 可限制探測的命令、軟件、應用或打印機名稱；但對 environment、resources、serial、usb、network、gpu、ports、services、workspace 無效。

apps 僅支持 macOS；其他平臺會報告不可用。

插件貢獻的 prompt section 建議：在假設平臺、shell、命令可用性、軟件版本、資源限制、監聽端口、服務狀態、項目工具鏈或打印機前先調用 environment_probe，並只請求需要的 scope。

配置¶

配置位於 profile patch layer（cordis.patch.yml），屬於 Host-side-only out-of-tree plugin；沒有 settings-page card。

可在 profile 的 cordis.patch.yml 中通過 id tool-scout 覆蓋配置，例如 softwareProbeTimeoutMs、softwareCacheTtlMs、maxNames。

- id: tool-scout
  name: '@deepseek-ai/dsh-tool-scout'
  config:
    softwareProbeTimeoutMs: 2000
    softwareCacheTtlMs: 0
    maxNames: 30

適用場景與注意¶

適合需要讓 DSH 智能體在推理前讀取環境事實的開發者，尤其是機器人/嵌入式調試、多平臺主機檢查和項目工具鏈檢查。

注意：插件以當前 dsh 進程權限運行；安裝前應檢查源碼、許可證和 profile 配置。

已覈實資料中還有以下限制：

• 包名、倉庫路徑和 README 標題存在不一致。
• 維護者信息不一致：package.json author 爲 ExDragine，倉庫路徑線索爲 omdsh-dev/dsh-scout。
• 安裝命令僅給出 /path/to/dsh-scout 本地路徑形式，未給出 registry 安裝命令。
• README 和 package.json 部分字段被截斷，無法確認完整 scripts。
• 使用前以倉庫完整文件爲準。

環境要求：

node: ^22.19.0 || >=24.0.0
packageManager: pnpm@11.7.0

依賴信息：

peerDependencies:
  @deepseek-ai/cordis ^4.0.1
  多個 @deepseek-ai/dsh-* ^0.1.0-rc.6

dependencies:
  @deepseek-ai/schemastery ^3.18.1

鏈接¶

GitHub：https://github.com/omdsh-dev/dsh-scout

目錄頁線索：https://www.skillhub.cn/plugins/omdsh-dev/dsh-scout（未完全確認）