DeepSeek Harness(DSH)采用插件化架构。在 Windows 环境下使用 WSL 子系统时,模型容易混淆 Windows 和 Linux 的路径格式,或者在执行命令时默认使用 Windows Shell 语法。dsh-wsl-env 插件通过向系统提示词注入环境信息,解决上述问题。
插件简介¶
dsh-wsl-env 是一个用于 DeepSeek Harness 的插件,由 173787247 维护。它的核心作用是将 WSL 和 Windows 的路径映射、Shell 事实以及特定配置注入到模型的系统提示词中,使模型在 WSL 环境下能正确识别路径并执行操作。
核心功能¶
该插件主要提供以下事实信息:
- 环境识别:提供发行版名称和 Linux 用户信息。
- 路径映射:提供
C:\Users\...到/mnt/c/Users/...的路径转换规则。 - 文件系统 Caveats:在
/mnt/c挂载点下处理 CRLF 换行符和 Git 相关的注意事项。 - 工作目录优先级:提示模型在日常工作中优先使用 Linux Home 目录,而非 Windows 挂载点。
- Node 24 代理配置:当使用 Node 24 并依赖环境变量
HTTP(S)_PROXY时,设置NODE_USE_ENV_PROXY=1。
安装与启用¶
通过命令行安装插件:
dsh plugin --profile web add github:173787247/dsh-wsl-env
安装完成后,必须重启 dsh web 服务以应用更改。旧会话将保留原有的提示词,需要打开新会话才能生效。
验证安装¶
安装后,可以通过以下步骤确认插件已生效:
- 发送任意消息。
- 打开 Trajectory 界面。
- 进入 SYSTEM 标签页。
- 搜索关键词
Windows Subsystem for Linux。
如果看到包含发行版名称和路径映射的文本,说明注入成功。
配置说明¶
插件支持通过 YAML 配置调整注入策略。配置文件中的 config 字段会替换整个对象,因此修改时必须重申所有保留的键。
- id: dsh-wsl-env
name: dsh-wsl-env
config:
when: wsl # wsl 或 always
order: 15 # 提示词部分的顺序
extraNotes: "Prefer /home over /mnt/c for new files."
主要配置项如下:
| Key | 默认值 | 含义 |
|---|---|---|
when |
wsl |
仅在 WSL 环境注入,或设置为 always 全局注入 |
order |
15 |
控制提示词中该部分出现的顺序 |
extraNotes |
"" |
运维人员添加的额外备注 |
适用场景与注意事项¶
- 所属生态:这是
dsh-wsl-kit套件的一部分。建议使用KIT_SET=daily、llm、github或full配置集。 - 环境检测:非 WSL 主机默认会跳过注入(
when: wsl)。 - 依赖版本:要求 DeepSeek Harness 版本 >= 0.1.2。
- 目录说明:插件目录
https://www.skillhub.cn/plugins/173787247/dsh-wsl-env为社区插件目录,与 DeepSeek / 幻方无官方从属关系。
该插件通过修正环境认知,减少了模型在跨文件系统操作时的错误率。