dsh-native-command

English | 中文

宿主原生 OS 集成共享的零依赖免 shell execFile 运行器：一次 runNativeCommand(command, args, signal) 调用直接 spawn 可执行文件（绝不拼 shell 字符串），以 utf8 捕获 stdout/stderr，把调用方的 abort 传播为子进程终止，并在 Windows 上隐藏瞬时控制台窗口。失败时，调用会以错误拒绝；该错误附带退出 code 与两路已捕获输出，调用方无需重跑即可分类（工具缺失、已取消、真实失败）。

它的两个消费方都是宿主侧原生集成：directory-picker-native 后端的 OS 选择器命令，以及网关将路径交由默认应用打开的操作（dsh-host-apiproxy 的 host.openPath）。NativeCommandRunner 类型是这些调用方的可注入命令边界。

它是库，不是服务或插件：没有 ctx、不注册任何东西、不持有状态、不发事件。

接口面

import { runNativeCommand, type NativeCommandRunner } from '@harness-desktop/dsh-native-command'

模型体验

无；这是宿主侧子进程管道，这里没有任何东西进入模型请求。

KV Cache 影响

无；该包既不组装也不发送提供方请求。

已知限制与暂缓事项

• 不做输出限量——两路流在内存中无界缓冲；当前每个调用方只运行输出为一个路径或一行错误的小型原生工具。把它指向输出量可观的命令之前，先接入 dsh-output-retention 限量。