jonah791/dsh-tool-wsl

README 摘要

dsh-tool-wsl WSL 命令行工具插件——在 WSL（默认 Ubuntu）发行版里执行 bash 命令，Windows 上取代 dsh-tool-bash （Windows 无原生 bash，官方 bash 工具按平台禁用）。 用途 - 为 agent 提供 wsl 工具： wsl.exe -d -- bash -c - 前台执行：stdout/stderr 收集、输出截断+溢出落盘、超时/取消、 [exit code: N] 标记 - 后台执行： run in background: true → job id（ job output / job kill ） - 工作目录：Windows 路径（如 E:\alice ），wsl.exe 自动映射到 WSL 对应目录 设计要点 - 执行器 ：镜像 @deepseek-ai/dsh-bash-local 的 LocalBashExecutor 机制（deadline / 输出收集 / 进程组终止 / 超时分类），执行边界替换为 WSL argv。 - 不依赖宿主 shell seam ：直接走 ctx.subprocess ，绕开 Windows 无 bash 的问题。 - 沙箱边界（重要） ：WSL 进程运行在 Linux VM 内，Windows 文件沙箱提供方（ dsh-pwsh-sandbox 等）无法限制其文件访问。因此本工具 不接入 Windows 文件沙箱 ，也不声明 sandbox permissions 升级参数；工具描述中明示此边界。若部署需要严格沙箱，请勿在受限会话中暴露此工具。 配置 项 默认 说明 distro Ubuntu WSL 发行版名（ wsl.exe -l -q 查看） wslExe wsl.exe wsl 可执行文件 loginShell false true 用 bash -lc （登录 shell）， false 用 bash -c timeoutMs 120000 前台默认超时 maxTimeoutMs 600000 单次超时上限 maxOutputBytes 64000 每流内存输出上限（溢出落盘） maxSpillBytes 64MB 溢出落盘上限 graceMs 3000 SIGTERM→SIGKILL 宽限 enableRunInBackground true 后台执行开关 挂载形态 agent 预设行（如 alice 预设）： 同时在预设里禁用 tool-bash （Windows 上默认已禁用）： 安装 自研插件家园 self-plugins/ 。在目标 profile 的 package.json 添加 link 依赖： 然后在预设组合（ agent.cordis.yml ）加 tool-wsl 行即可。 验证 - wsl.exe -l -q…

分类