dsh-tool-sysinfo

Readme

# dsh-tool-sysinfo

DeepSeek Harness 的系统信息工具插件：给 agent 一个只读的本机环境快照工具 `system_info`——操作系统与架构、主机名、开机时长、CPU 型号与核数、内存占用、Node 版本、非回环 IPv4 地址。零外部依赖、零网络请求、零写操作，agent 排查"我这台机器什么配置 / 内存还够不够"这类问题时直接可用。

A read-only `system_info` tool for DeepSeek Harness agents: OS/arch, hostname, uptime, CPU model and core count, memory usage, Node version, and non-internal IPv4 addresses. Zero dependencies, no network, no writes.

## 安装

```sh
dsh plugin --profile web add github:shiyi-0x7f/dsh-tool-sysinfo
```

重启 `dsh --profile web`（或 dsh-shell）后，在聊天里让 agent「调用 system_info 工具」即可看到效果。

> Windows + pnpm 10.x 用本地路径安装有已知 junction bug，建议 pnpm ≥ 11 或直接用上面的 github 规格。

## 输出示例

```
OS: win32 10.0.26200 (x64)
Host: my-machine
Uptime: 2d 5h 13m
CPU: 13th Gen Intel(R) Core(TM) i7-13700K × 24 logical cores
Memory: 21.3 GiB used / 63.8 GiB total (42.5 GiB free)
Node: v22.20.0
Network (IPv4): 以太网 192.168.1.23
```

## 实现

单文件（`index.js`）零构建插件：`inject: ['tools']` 后经 `ctx.effect(() => ctx.tools.register(defineTool({...})))` 注册；数据全部来自 `node:os` 与 `process`。`cordis.patch.yml` 声明组合层（`dsh.bundle`），安装即入 profile 层栈。

## License

MIT