dsh-shell-exec

DSH 动态 Cordis 插件:通过 harness 的 shell 服务在 Windows 本地终端 执行 shell 命令,并为模型注册一个名为 shell 的动态工具。

功能

• 注册模型可见的动态工具 shell,模型可以直接调用它在当前 Windows 机器上执行任意命令(文件、进程、git、npm 等)。
• 支持三个参数:command(必填)、workdir、timeoutMs。
• 输出渲染与 harness 自带 shell 工具一致:stdout 正文 + [stderr] 段 + 退出标记([exit code: N] / [killed by signal: ...] / [timed out after Nms])。
• 基于 harness 的 shell 服务(ctx.get('shell') → resolve → run),Windows 下经 PowerShell 执行,无需引入任何外部依赖。

目录结构

dsh-shell-exec/
├── src/
│   └── host.js        # Host 半区源码(cordis_define 的 code.host 直接粘贴此文件内容)
├── scripts/
│   └── check.js       # 语法自检(npm run check)
├── package.json
├── plugin.json        # 插件元数据(文档用途)
├── README.md
├── LICENSE            # MIT
└── .gitignore

快速开始(在 DSH Web GUI 中加载)

1. 在 DSH Web 的对话中让模型执行 cordis_define:
   • plugin.kind = new,idPrefix 填 she;
   • code.host 粘贴 src/host.js 的完整内容;
   • 也可以直接把本文件路径交给模型,让它读取并粘贴。
2. 用返回的 pluginId / packageId 执行 cordis_run(mode = run)激活插件。
3. 激活后,模型即可调用 shell 工具执行本地命令。

使用示例

模型调用 shell 工具时,参数形如:

{
  "command": "dir",
  "workdir": "C:\\Users\\godeyes\\Documents\\dsh"
}

返回结构:

{
  "ok": true,
  "exitCode": 0,
  "signal": null,
  "timedOut": false,
  "timeoutMs": 30000,
  "stdout": "...",
  "stderr": "",
  "text": "..."
}

工具参数

参数	类型	必填	说明
command	string	是	要执行的 shell 命令行,例如 dir、git status
workdir	string	否	命令的工作目录,缺省使用 harness 配置的工作区
timeoutMs	number	否	超时毫秒数;执行器会做上限截断,缺省使用实现配置的默认值

工作原理

• harness.defineTool({...}) 定义动态工具(参数使用 Cordis 参数 DSL,输出 schema 为 { type: 'json' })。
• harness.registerTool(ctx, tool) 注册到当前 Fiber,插件停止/更新时自动注销。
• 执行路径:shell.resolve(request) → shell.run(spec),其中 request.signal 透传工具执行的取消信号。
• ShellRunResult 包含 exitCode / signal / timedOut / timeoutMs / stdout / stderr,插件将其渲染为模型可见文本。

已知限制:沙箱执行上下文与 Schannel TLS

插件注册的 shell 工具与 harness 自带的 pwsh 工具共用同一个沙箱执行上下文(受限进程环境,如 CODEX_SANDBOX_NETWORK_DISABLED=1 等托管变量所示)。该上下文对进程有额外限制,实测影响如下:

工具	沙箱内行为
curl.exe(默认 schannel 后端)、PowerShell Invoke-WebRequest / Invoke-RestMethod、npm 等走 SSPI/Schannel 的 HTTPS 客户端	❌ 报 schannel: AcquireCredentialsHandle failed: SEC_E_NO_CREDENTIALS (0x8009030E),对所有域名一致
走 OpenSSL 后端的工具(如 git 配置了 http.sslBackend openssl)	✅ 正常,可完成 TLS 握手与推送
证书存储枚举(Cert:\CurrentUser\My 等)	✅ 正常

要点:

• 这是沙箱固有行为,不是插件 bug。 同一台机器上,在普通终端(非沙箱)里同样的 schannel 请求全部正常;问题只出现在 harness 会话的沙箱进程上下文中,原因是 Schannel 凭据获取被受限上下文卡死(发生在任何网络请求之前)。
• 与本机注册表 SecurityProviders 被截断无关——那是另一个独立问题,影响的是 LSA 模式包(Kerberos / NTLM / CredSSP / PKU2U,即域认证、SMB、RDP 等),不影响用户态 Schannel。
• 规避方式:在命令里使用 OpenSSL 后端的工具即可,例如 git -c http.sslBackend=openssl push,或对 curl 使用 --ssl-no-revoke 之外的替代方案(如 wget / OpenSSL 后端)。

开发

npm run check   # 语法自检(把 src/host.js 作为函数体编译,不执行)

仓库

远程仓库:https://github.com/osmondlee/dsh-shell.git

License

MIT