lsz-asd/dsh-plugin-device-info

dsh-device-info

为 DeepSeek Harness 代理提供只读的 Windows 设备信息 â€?12 个 win_ 工具，每个对应一个 Win32 设备类别。

@huanlin/dsh-plugin-device-info 为模型提供对宿主机的结构化、只读访问：时间、系统、CPU、内存、磁盘、GPU、网络/WiFi、电池、进程、USB、音频、打印机。无写入、无安装、无网络。

为什么需要这个插件

临时的 PowerShell 探测每次查询都会消耗 token â€?模型每次都要重新生成命令（约 40â€?00+ token，如果出现拼写错误或权限提示后重试则更多）。而插件调用针对预先测试、版本化的查询仅需 约 6 token。安装一次，即可调用任意工具；无需编写命令，无需反复试错。（估算：scripts/token-estimate.mjs；真实基准测试计划中，见路线图。）

安装

dsh plugin --profile  add github:lsz-asd/dsh-plugin-device-info   # 发布后
dsh plugin --profile  add link:C:/path/to/dsh-device-info           # 本地检出

重启配置文件。lib/ 已预构建（无 prepare 脚本）。

工具

| 工具 | 报告内容 | 来源 |
|---|---|---|
| win_time | ISO/epoch 时间、IANA 时区、UTC 偏移、运行时间、启动时间 | Node os â€?任意平台 |
| win_system | 操作系统、主机名、用户、厂商、型号、BIOS、序列号（配置） | Win32_ComputerSystem / Win32_OperatingSystem / Win32_BIOS |
| win_cpu | 型号、核心数、最大时钟、负载 % | Win32_Processor |
| win_memory | 已用/空闲/总计、已用 %、模块 | Node os + Win32_PhysicalMemory |
| win_disk | 驱动器 + 卷（容量、空闲） | Win32_DiskDrive / Win32_LogicalDisk |
| win_gpu | 名称、显存、驱动、分辨率 | Win32_VideoController |
| win_network | 适配器、IP、实时 WiFi（SSID/信号/速率/认证） | Get-NetAdapter + netsh wlan + Node os |
| win_battery | 电量 %、交流/直流、运行时间、电源方案 | Win32_Battery + powercfg |
| win_processes | 数量 + 按内存/CPU 排序的前 N 个（top_n、sort_by） | Get-Process |
| win_usb | USB 设备 | Win32_PnPEntity |
| win_audio | 音频设备 | Win32_SoundDevice |
| win_printers | 打印机（驱动/端口/默认/离线） | Win32_Printer |

配置

| 字段 | 默认值 | 描述 |
|---|---|---|
| pwshEnabled | true | 主开关；false 时除 win_time 外全部禁用。 |
| pwshTimeoutMs | 8000 | 每次查询超时时间（1000â€?0000）。 |
| topProcesses | 10 | win_processes 的默认前 N 个（1â€?00）。 |
| includeSerialNumber | true | 在 win_system 中报告 BIOS 序列号。 |
| pwshPath | powershell.exe | PowerShell 可执行文件（powershell.exe/pwsh.exe）。 |

示例

用户：  这台电脑还剩多少内存？电池呢？
模型： [win_memory] â†?72.8% used, 2× Samsung 8 GB DDR5-4800
[win_battery] â†?100%, AC online, scheme 381b4222â€?(平衡)

所有工具返回规范 JSON；可空字段保持 null（schema oneOf: [type, null]），以保证结构稳定：

{ "supported": true, "platform": "win32",json
"name": "13th Gen Intel(R) Core(TM) i7-13700HX",
"cores": 16, "logical_processors": 24,
"max_clock_mhz": 2100, "current_load_percent": 3 }

架构

model ──tools──�win_ tools ──�execute �canonical JSON value
�       render  �pure text projection
â–?              CollectContext {run, signal, platform, config}
�  Node os (no subprocess)         PowerShell child (WMI/CIM · netsh · powercfg)
win_time, totals, addresses     killed on exec.signal · hard timeout

src/index.ts 入口 · src/tools.ts 12 个工具 + 渲染 · src/collect.ts 采集器 · src/pwsh.ts 运行器 + 解析器 · src/types.d.ts 环境对等类型

亮点

- 值/渲染分离 â€?execute 返回纯字节/毫秒/百分比；render 是纯投影，可安全重放
- 与区域设置无关的解析 â€?netsh wlan 字段在本地化 Windows 上仍保持英文；powercfg GUID 正则与语言无关；CIM /Date(ms)/ â†?ISO-8601
- 哨兵值处理 â€?交流电下电池续航是垃圾值（0x04444444）â†?null；AdapterRAM uint32 回绕已记录
- 取消/超时 â€?exec.signal 终止子进程；每个查询有硬超时；无孤儿进程，无挂起
- 领域失败与基础设施失败 â€?缺少电池/WiFi/非 Windows â†?supported: false 值；spawn/超时/中止 â†?抛出（isError）

质量

59 个单元测试（真实机器夹具）· 真实 powershell.exe 冒烟测试 · 通过生产 @deepseek-ai/dsh-tools 的真实组合冒烟测试（scripts/di-smoke.mjs）· 严格 TS，tsc + tsdown â†?lib/。

开发
sh
pnpm install && pnpm run typecheck && pnpm test && pnpm run build

@deepseek-ai/dsh-tools 由宿主提供，不在 devDependencies 中（其对等依赖链引用了一个未发布的包）；类型检查使用 src/types.d.ts 环境声明，测试模拟该模块，真实模块在冒烟脚本/Loader 中运行。

模型体验

这 12 个固定 schema 加入生成的工具目录 â€?无动态提示注入。Token 影响：固定（schema 恒定；每次调用一条结果消息）。KV 缓存：前缀稳定（schema 在运行时永不改变）。

路线图

- Token 效率基准 â€?真实每任务用量：插件调用 vs 临时命令（含重试/提示）；结果将在此发布
- 更多平台 â€?Linux/macOS（/proc、sysctl、system_profiler）
- 更多类别 â€?蓝牙、显示器、流量统计、温度（LibreHardwareMonitor）、已安装软件

已知限制

传感器需要第三方守护进程 · 蓝牙/显示器/流量统计暂缓 · 进程 CPU 是累计秒数，不是实时速率 · 非 Windows 上仅有 win_time。

许可证

AGPL-3.0