dsh-device-info

Read-only Windows device info for DeepSeek Harness agents â€?12 win_* tools, one per Win32 device category.

@huanlin/dsh-plugin-device-info gives the model structured, read-only access to the host machine: time, system, CPU, memory, disk, GPU, network/WiFi, battery, processes, USB, audio, printers. No writes, no installs, no network.

Why this plugin

Ad-hoc PowerShell probing costs tokens every query â€?the model re-generates a command each time (~40â€?00+ tokens, more with retries after a typo or a permission prompt). A plugin call is ~6 tokens against pre-tested, versioned queries. Install once, call any tool; no command-writing, no trial-and-error. (Estimates: scripts/token-estimate.mjs; real benchmark planned, see Roadmap.)

Install

dsh plugin --profile <profile> add github:lsz-asd/dsh-plugin-device-info   # after publishing
dsh plugin --profile <profile> add link:C:/path/to/dsh-device-info           # local checkout

Restart the profile. lib/ ships pre-built (no prepare script).

Tools

| Tool | Reports | Source | |---|---|---| | win_time | ISO/epoch time, IANA timezone, UTC offset, uptime, boot time | Node os â€?any platform | | win_system | OS, hostname, user, vendor, model, BIOS, serial (config) | Win32_ComputerSystem / Win32_OperatingSystem / Win32_BIOS | | win_cpu | Model, cores, max clock, load % | Win32_Processor | | win_memory | Used/free/total, used %, modules | Node os + Win32_PhysicalMemory | | win_disk | Drives + volumes (capacity, free) | Win32_DiskDrive / Win32_LogicalDisk | | win_gpu | Name, VRAM, driver, resolution | Win32_VideoController | | win_network | Adapters, IPs, live WiFi (SSID/signal/rates/auth) | Get-NetAdapter + netsh wlan + Node os | | win_battery | Charge %, AC/DC, runtime, power scheme | Win32_Battery + powercfg | | win_processes | Count + top-N by memory/CPU (top_n, sort_by) | Get-Process | | win_usb | USB devices | Win32_PnPEntity | | win_audio | Audio devices | Win32_SoundDevice | | win_printers | Printers (driver/port/default/offline) | Win32_Printer |

Config

| Field | Default | Description | |---|---|---| | pwshEnabled | true | Master switch; false disables all but win_time. | | pwshTimeoutMs | 8000 | Per-query timeout (1000â€?0000). | | topProcesses | 10 | Default top-N for win_processes (1â€?00). | | includeSerialNumber | true | Report BIOS serial in win_system. | | pwshPath | powershell.exe | PowerShell executable (powershell.exe/pwsh.exe). |

Example

User:  这台电脑还剩多少内存？电池呢�Model: [win_memory] �72.8% used, 2× Samsung 8 GB DDR5-4800
       [win_battery] �100%, AC online, scheme 381b4222�(平衡)

All tools return canonical JSON; nullable fields stay null (schema oneOf: [type, null]) for a stable shape:

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

Architecture

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 entry · src/tools.ts 12 tools + renders · src/collect.ts collectors · src/pwsh.ts runner + parsers · src/types.d.ts ambient peer types

Highlights

• Value/render split â€?execute returns plain bytes/ms/percents; render is a pure projection, replay-safe
• Locale-independent parsing â€?netsh wlan fields stay English on localized Windows; powercfg GUID regex language-independent; CIM /Date(ms)/ â†?ISO-8601
• Sentinel handling â€?battery runtime is junk on AC (0x04444444) â†?null; AdapterRAM uint32 wraparound documented
• Cancellation/timeouts â€?exec.signal kills the child; hard per-query timeout; no orphans, no hangs
• Domain vs infra failures â€?missing battery/WiFi/non-Windows â†?supported: false values; spawn/timeout/abort â†?thrown (isError)

Quality

59 unit tests (real-machine fixtures) · real powershell.exe smoke · real-composition smoke through production @deepseek-ai/dsh-tools (scripts/di-smoke.mjs) · strict TS, tsc + tsdown â†?lib/.

Development

pnpm install && pnpm run typecheck && pnpm test && pnpm run build

@deepseek-ai/dsh-tools is host-provided and not in devDependencies (its peer chain references an unpublished package); typecheck uses src/types.d.ts ambient declarations, tests mock the module, the real module runs in the smoke script/Loader.

Model Experience

The 12 fixed schemas join the generated tool catalog �no dynamic prompt injection. Token effect: fixed (constant schemas; one result message per call). KV cache: prefix-stable (schemas never change at runtime).

Roadmap

• Token-efficiency benchmark â€?real per-task usage: plugin call vs ad-hoc commands (incl. retries/prompts); results published here
• More platforms â€?Linux/macOS (/proc, sysctl, system_profiler)
• More categories â€?Bluetooth, displays, traffic stats, temperature (LibreHardwareMonitor), installed software

Known limitations

Sensors need a third-party daemon · Bluetooth/display/traffic stats deferred · process CPU is cumulative seconds, not live rate · only win_time on non-Windows.

License

AGPL-3.0