173787247/dsh-wsl-env

Inject WSL/Windows path and shell facts into the DeepSeek Harness system prompt.

Project Overview项目介绍

dsh-wsl-env is a native DeepSeek Harness plugin that is part of the dsh-wsl-kit suite. Its core function is to inject WSL and Windows environment facts, including path mappings, directly into your DSH system prompt. It is not a tool that the model calls directly; instead, it modifies the system prompt to help the model correctly understand how paths work in a WSL environment. To install, you can run dsh plugin --profile web add github:173787247/dsh-wsl-env to pull it from GitHub directly, or add it from a local absolute path, then restart the dsh web service and open a new session to activate it.

This plugin is built for developers who run DeepSeek Harness inside Windows Subsystem for Linux. Without this plugin, the large language model will often default to assuming you are working on a native Windows system with C:\ paths and PowerShell, leading to incorrect command and path suggestions. This plugin adds a short section to the system prompt that tells the model your WSL distro name, Linux username, the C:\ to /mnt/c path mapping, and Git CRLF caveats for Windows mounts. It also reminds the model to prefer the Linux home directory over the Windows mount for daily work, and adds the correct Node 24 proxy environment variable if needed.

dsh-wsl-env requires a minimum DSH version of 0.1.2, and has been verified to work with the latest DSH version 0.1.5-rc.1. By default, the plugin only injects its prompt section when it detects you are running in WSL, but you can change this setting to always inject via the plugin configuration. You can also adjust the order of the prompt section in the system prompt and add custom extra notes to the section. The plugin is distributed under the open source MIT license, and it is included in multiple installation sets of the dsh-wsl-kit suite, including daily, llm, github, and full.

dsh-wsl-env是专为DeepSeek Harness开发的原生插件,属于dsh-wsl-kit工具集的组成部分,核心功能是向DSH的系统提示词注入WSL与Windows环境相关的路径和配置事实,不是供大模型调用的工具。它主要解决模型在WSL环境中默认错误使用Windows路径的问题,帮助模型正确理解路径映射规则。可以通过dsh plugin命令从GitHub拉取安装,也支持本地路径加载,安装后重启dsh web服务即可。

这款插件面向在Windows的WSL子系统中使用DeepSeek Harness的开发者,能够提前告诉模型当前环境的WSL发行版名称、Linux用户名、C盘路径的映射规则,同时会提醒模型Git处理/mnt/c下文件时的换行符注意事项。它默认只在WSL环境中注入提示信息,如果需要也可以通过配置修改为总是注入,还支持调整提示段在系统提示词中的排序位置,用户可以添加自定义的额外注意事项。

该插件要求DSH版本不低于0.1.2,目前已经过0.1.5-rc.1版本的兼容性验证,非WSL环境默认不会注入提示内容。它属于dsh-wsl-kit工具集的daily、llm、github、full多个安装套件,用户可以根据自己的需求选择对应的套件安装。项目采用MIT许可证开源,用户可以免费使用、修改代码,遇到问题可以查阅工具集提供的故障排查文档。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:173787247/dsh-wsl-env

把 173787247/dsh-wsl-env 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-wsl-env

Install set: part of dsh-wsl-kit. Prefer KIT_SET=daily | llm | github | full (see kit README). Fault tree: TROUBLESHOOTING.md.

DeepSeek Harness plugin: inject WSL / Windows path and shell facts into the system prompt.

Part of dsh-wsl-kit.

中文说明 → README.zh.md

Where it sits

Injects WSL and Windows path facts into the system prompt. It is not a tool the model calls.

flowchart LR
  facts["WSL and Windows facts"] --> env["dsh-wsl-env"] --> prompt["system prompt"]

Suite diagram and version snapshot: dsh-wsl-kit. This plugin is 0.3.0 (daily; also in llm). Do not copy that matrix into this README.


Compatibility

Field Value
Plugin dsh-wsl-env 0.3.0
Minimum dsh ≥ 0.1.2 (web UI one-shot ?token= on Windows relay :3081)
Latest verified See dsh-wsl-kit Compatibility (currently 0.2.0-rc.2) — single source of truth for the suite
Kit set daily (also in github / full; fetch+net also in llm)
Cloud Flash Use model id deepseek-flash (V4.1 Flash) in ~/.dsh/settings.yaml / llm-deepseek — not configured by this plugin
Agent Teams Upstream experimental; not required here

Suite floor versions: kit check-plugin-versions.sh. Fault tree: TROUBLESHOOTING.md.

Why

The model often assumes a Windows shell (C:\, PowerShell) even when the agent runs in Linux/WSL. This plugin adds a short system-prompt section so it prefers Linux paths, understands /mnt/c, and knows about Node 24 proxy quirks.

What gets injected

Kept short on purpose:

  • Distro name and Linux user
  • Linux path mapping (C:\Users\... → /mnt/c/Users/...)
  • CRLF / git caveats on /mnt/c
  • Prefer Linux home over the Windows mount for day-to-day work
  • NODE_USE_ENV_PROXY=1 when Node 24 must use HTTP(S)_PROXY

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-draft-polish 下一个 Next dsh-gaokao →