dsh-wsl-env:DeepSeek Harness WSL 环境注入插件

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 服务以应用更改。旧会话将保留原有的提示词,需要打开新会话才能生效。

验证安装

安装后,可以通过以下步骤确认插件已生效:

  1. 发送任意消息。
  2. 打开 Trajectory 界面。
  3. 进入 SYSTEM 标签页。
  4. 搜索关键词 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 / 幻方无官方从属关系。

该插件通过修正环境认知,减少了模型在跨文件系统操作时的错误率。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜