dsh-tool-scout

English | 中文

面向 DeepSeek Harness 的模型侧环境探测工具：按需向 agent 提供当前运行环境（平台、shell、用户、时区……）、PATH 上可解析的命令、已安装软件及其版本、以及 CPU/内存/磁盘资源 —— 无需猜测，也不用浪费工具调用去跑慢速的发现命令。

安装

本包是一个 dsh bundle：自带补丁层（cordis.patch.yml），安装后自动加入 profile 的图层栈。

# 从公开版 Harness 源码检出执行：
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 工具进入目录。

工具

environment_probe

参数	类型	说明
scope	string、枚举数组或 all	单个类别、类别数组（按请求顺序每个类别返回一个结果对象）、或 all（全部）。类别：environment（默认）—— 平台/内核/架构/主机名/用户/家目录/cwd/Node 版本/shell/时区/locale/endianness/pid/dsh home；commands —— 哪些命令名在 PATH 上可解析（仅 stat，不启子进程）；software —— 已安装工具的 --version 探测（短超时子进程、短时缓存）；resources —— 会话工作区所在磁盘的 CPU 核数/负载、内存总量、磁盘用量、电池状态与设备信息（型号/厂商/CPU）；apps —— macOS 应用 bundle；serial —— 串口（/dev/cu.*、ttyUSB*、COM）；usb —— USB 设备；network —— 本机 IP 与接口（纯 Node）；gpu —— GPU 名称与显存；ports —— TCP 监听套接字（地址/端口/可见的所属进程）；services —— 系统服务状态（running/stopped/failed…）；workspace —— 当前目录的项目工具链信号（包管理器/版本钉/构建标记，纯文件读取、零子进程）；printers —— 打印机与默认目标。
names	string[]	限定只探测这些命令/软件/应用/打印机名（替换配置的默认列表；对 apps/printers 是按显示名或 Bundle ID 的大小写不敏感精确匹配）。environment/resources/serial/usb/network/gpu/ports/services/workspace 忽略。

apps（仅 macOS；其他平台报告不可用）列出配置的应用目录里的 app bundle：显示名、版本、Bundle ID 来自每个 bundle 的 Contents/Info.plist，纯 Node 解析（二进制 bplist00 与 XML）—— 无 shell、无 Spotlight 依赖。