前言¶

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（未完全确认）