DeepSeek Harness 插件

173787247/dsh-wsl-env

Star 数 ★ 2 分类 WSL 与 Windows 互操作 收录于 2026-08-26

向 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。

English → README.md

在套件里的位置

把 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)。

验证

  1. 随便发一条消息。
  2. Trajectory → SYSTEM → System Prompt(不是 Tools 页)。
  3. 搜索 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

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。