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 / 幻方無官方從屬關係。
該插件通過修正環境認知,減少了模型在跨文件系統操作時的錯誤率。