概览
dsh-pwsh-quoting-guard
DSH 插件:pwsh_script 与 run_argv 两个工具,从结构上消除 Windows PowerShell 的命令字符串引号转义错误。 · Two DSH tools that remove the PowerShell command-string quoting layer: a multi-line body passed as one argv element with structured $DSH_ARGS data, plus a shell-free argv runner.
README / ZH
插件文档
目录摘要
DSH 插件:pwsh_script 与 run_argv 两个工具,从结构上消除 Windows PowerShell 的命令字符串引号转义错误。 · Two DSH tools that remove the PowerShell command-string quoting layer: a multi-line body passed as one argv element with structured $DSH_ARGS data, plus a shell-free argv runner.
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **无 `run_in_background`**:长任务请用官方 `pwsh`。 - 单次调用预算 300s(由部署的 timeout policy 执行);输出每流 64 KB,超出写 spill 文件(上限 64 MB)并给出路径。 - `pwsh_script` **有意不提供 `cwd`**:需要换目录时用 `Set-Location`(文件与 cmdlet 操作完全正确),但**经 PowerShell 向原生程序传参仍会失真** —— 那种情况请改用 `run_argv`。 - 参数值中**含换行**时,prelude 之后的行号会偏移对应行数(罕见;正确性不受影响)。 - `read-only` 模式下 PowerShell 处于 ConstrainedLanguage,非核心 .NET 静态调用会被拒(部署既有约束,与本插件无关)。 - 依赖会话上下文解析默认工作目录:显式 `cwd` → 会话工作区 → `sandboxPolicy.workspaceRoot`;三者都拿不到时给出教学式报错。
