1.6 KiB
1.6 KiB
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 '@deepseek-ai/dsh-native-command'
模型体验
无；这是宿主侧子进程管道，这里没有任何东西进入模型请求。
KV Cache 影响
无；该包既不组装也不发送提供方请求。
已知限制与暂缓事项
- 不做输出限量——两路流在内存中无界缓冲；当前每个调用方只运行输出为一个路径或一行错误的小型原生工具。把它指向输出量可观的命令之前，先接入
dsh-retention限量。