向 system prompt 注入 WSL 发行版、Linux 路径映射、/mnt/c 的 CRLF 与 git 注意点,以及 NODE_USE_ENV_PROXY。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:173787247/dsh-wsl-env
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
套件安装: 见 dsh-wsl-kit。推荐
KIT_SET=daily|llm|github|full。故障树:TROUBLESHOOTING.zh.md。
DeepSeek Harness 插件:把 WSL / Windows 路径与 shell 事实注入 system prompt。
属于 dsh-wsl-kit。
在套件里的位置
把 WSL 和 Windows 路径事实写进 system prompt。模型不会去调用它。
flowchart LR
facts["WSL 与 Windows 事实"] --> env["dsh-wsl-env"] --> prompt["system prompt"]
整套关系图和版本快照:dsh-wsl-kit 中文说明。本插件是 0.3.0(daily,也在 llm)。不要把那份总表抄进本 README。
兼容性
| 项 | 值 |
|---|---|
| 插件 | dsh-wsl-env 0.3.0 |
| 最低 dsh | ≥ 0.1.2(Windows 中继 :3081 一次性 ?token=) |
| 最新验证 | 以 dsh-wsl-kit 兼容性 为准(当前 0.2.0-rc.2)— 套件唯一真源 |
| 套件档位 | daily(亦含于 github / full;fetch+net 亦在 llm) |
| 云端 Flash | settings / llm-deepseek 使用 deepseek-flash(V4.1 Flash);本插件不配置模型 id |
| Agent Teams | 上游实验包;本插件不依赖 |
套件版本地板:check-plugin-versions.sh。故障树:TROUBLESHOOTING.zh.md。
为什么需要
Agent 跑在 WSL(Linux)里时,模型仍常按 Windows 习惯写 C:\、PowerShell。本插件往 system prompt 注入一小段事实,让它优先用 Linux 路径,并了解 /mnt/c 与 Node 24 代理注意点。
注入内容
刻意写短:
- 发行版名称与 Linux 用户
- 路径映射(
C:\Users\...→/mnt/c/Users/...) /mnt/c上的 CRLF / git 注意点- 日常工作优先 Linux 家目录,而不是 Windows 盘挂载点
- 需要代理时提醒
NODE_USE_ENV_PROXY=1(Node 24 必须设置后才会读HTTP(S)_PROXY)
安装
dsh plugin --profile web add github:173787247/dsh-wsl-env
# 或:
dsh plugin --profile web add /absolute/path/to/dsh-wsl-env
重启 dsh web,并开新会话(已有会话会保留旧 prompt)。
验证
- 随便发一条消息。
- Trajectory → SYSTEM → System Prompt(不是 Tools 页)。
- 搜索
Windows Subsystem for Linux。
应能看到发行版名与路径映射。界面会把各段拼在一起,内部 id runtime:wsl-windows 不一定以标题形式出现。
非 WSL 主机默认不注入(when: wsl)。
配置
后续 profile 层一旦写 config,会整对象替换——要保留的键必须全部重写:
- id: dsh-wsl-env
name: dsh-wsl-env
config:
when: wsl # 或: always
order: 15
extraNotes: "Prefer /home over /mnt/c for new files."
| 键 | 默认 | 含义 |
|---|---|---|
when |
wsl |
仅 WSL 注入,或 always |
order |
15 |
prompt 段落顺序 |
extraNotes |
"" |
追加到该段的运维说明 |
测试
npm test
许可
MIT
链接
同类插件
6Mikao9/dsh-wsl-workspace★ 77
从 Web GUI 添加 WSL 工作区,无需在 WSL 之中再次安装 dsh 以及相关工具,bash 命令与文件读写运行在本机 WSL 发行版内,Windows 文件仍可访问。
173787247/dsh-wsl-open★ 3
把 DeepSeek Harness 聊天里的 WSL Linux 路径在 Windows 默认程序或资源管理器中打开。
173787247/dsh-wsl-net★ 2
提供 net_doctor 工具,报告代理环境、NODE_USE_ENV_PROXY,以及 DeepSeek API 与 npm registry 的连通性,并为 bash 和 npm 子进程设置 NODE_USE_ENV_PROXY。
Edge-Echo/dsh-win-toolkit★ 2
面向 DSH agent 的 Windows 原生工具:剪贴板读写、系统通知、hosts 文件查看与网络诊断,均返回结构化数据(带 UI 卡片),底层为防注入的 PowerShell。
liyu34/dsh-wsl-tray★ 2
为运行在 WSL 的 DSH 提供 Windows 桌面快捷方式和系统托盘启动器:完全隐藏启动,托盘菜单支持打开/重启/退出,插件配置页可管理快捷方式。
173787247/dsh-device-bridge★ 1
DeepSeek Harness 通用 Companion 桥:手机 / IoT / 旧世界薄 Agent(含 Termux 样例)。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。