dsh-tool-wsl
WSL 命令行工具插件——在 WSL（默认 Ubuntu）发行版里执行 bash 命令，Windows 上取代 dsh-tool-bash（Windows 无原生 bash，官方 bash 工具按平台禁用）。
用途
- 为 agent 提供
wsl工具：wsl.exe -d <distro> -- bash -c <command> - 前台执行：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。 - 不依赖宿主
shellseam：直接走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 预设）：
- id: tool-wsl
name: dsh-tool-wsl
config:
distro: Ubuntu同时在预设里禁用 tool-bash（Windows 上默认已禁用）：
- id: tool-bash
name: '@deepseek-ai/dsh-tool-bash'
disabled: true安装
自研插件家园 self-plugins/。在目标 profile 的 package.json 添加 link 依赖：
"dsh-tool-wsl": "link:E:/alice/self-plugins/dsh-tool-wsl"然后在预设组合（agent.cordis.yml）加 tool-wsl 行即可。
验证
wsl.exe -l -q确认发行版名- 单命令退出码透传：
wsl.exe -d Ubuntu -- bash -c "exit 42"→[exit code: 42] - 工作目录映射：从
E:\alice调用 → WSL 内pwd=/mnt/e/alice
生态
本插件属于我的数字生命爱丽丝（alice-digital-life）DSH 插件生态——21 个自研插件按生命/认知/感知/行动/通信/治理/呈现七层组织。