DeepSeek Harness 在 Windows 与 WSL 怎么跑：路径、终端与插件差异

Windows 上跑 DeepSeek Harness 有三条路：原生 Windows、WSL、远程服务器。 三条路的路径、终端与插件兼容性不同；选错，问题会集中在「找不到文件」和「插件不生效」。

三种跑法

先看差异，再选一条主路径。

原生 Windows 最直接。 安装、启动、插件市场都在同一环境；遇到 Linux 专属依赖时，再考虑 WSL。

WSL 补的是 Linux 兼容性。 它适合需要 bash、特定编译工具或 Linux 路径的插件；代价是跨文件系统与路径转换。

远程 Linux 适合统一环境。 本地只做浏览器访问；团队协作与长期运行时更稳。

原生 Windows：路径与终端

Windows 的问题多在终端与路径，不在应用本身。

1. 确认安装方式：桌面端安装包或 npm 全局安装。
2. 用 dsh --version 在 PowerShell 与 CMD 各试一次。
3. 命令只在其中一个终端可用，说明 PATH 配置不同。
4. 路径尽量用英文、短目录，避免空格与中文。
5. 命令里带路径时加引号，避免被拆成多个参数。

PowerShell 与 CMD 不是一回事。 两者读取的环境变量与执行策略不同；一个能用、一个不能用，先查当前终端的 PATH。

路径空格是常见坑。 插件目录、项目目录带空格时，命令参数容易被截断；用引号或换短路径。

WSL：优势与陷阱

WSL 提供 Linux 环境，但跨文件系统会带来新问题。

1. 把项目与 DSH_HOME 放在 WSL 自己的文件系统，不要放在 /mnt/c。
2. 需要与 Windows 交换文件时，用复制而不是直接跨盘运行。
3. 注意换行符差异，脚本在两边可能表现不同。
4. 权限语义不同，Windows 上的 ACL 在 WSL 里不一定成立。
5. 端口访问要确认 WSL 与 Windows 的转发关系。

跨文件系统慢是结构性的。 在 /mnt/c 下跑大量文件操作，性能明显下降；把数据放在 WSL 内部，速度恢复正常。

路径转换容易出错。 Windows 路径 C:\... 与 WSL 路径 /mnt/c/... 不是同一写法；复制命令时先转换。

插件与数据放哪

插件与数据跟着 DSH_HOME 走，不跟着终端走。

1. 原生 Windows：DSH_HOME 放在用户目录下，路径避免空格。
2. WSL：DSH_HOME 放在 WSL 文件系统内，不要跨盘。
3. 两种方式不要共用同一份 DSH_HOME，避免锁与权限冲突。
4. 迁移时整目录复制，保持结构一致。
5. 插件装进对应 profile，换环境要重新安装。

共用数据目录是最容易出的错。 原生与 WSL 同时写同一目录，可能出现文件锁、权限与换行符问题；看起来像插件坏了，实际是环境混用。

插件兼容性要看平台。 依赖图形界面、系统托盘或 Windows API 的插件，在 WSL 里可能不可用；装前看说明。

常见失败

四类失败覆盖大多数 Windows/WSL 问题。

1. 命令找不到： PATH 或执行策略问题；在另一个终端对照。
2. 路径找不到： 空格、中文或路径转换错误；用绝对路径与引号。
3. 插件不生效： 装错 profile 或平台不兼容；看列表与说明。
4. 文件权限错误： 跨文件系统或 ACL 问题；把数据放回本系统。

排查顺序是「终端 → 路径 → profile → 权限」。 前三步不用改系统设置，能解决大部分问题。

日志要看对位置。 WSL 与 Windows 的日志目录不同；看错位置会以为没有记录。

选型建议

按「要不要 Linux 工具链、是否长期运行」选。

1. 日常桌面使用： 原生 Windows，路径直观、插件兼容好。
2. 需要 Linux 工具： WSL，但把数据放在 WSL 内部。
3. 团队统一环境： 远程 Linux，本地只做浏览器访问。
4. 临时排查： 哪个环境能跑就用哪个，不要为了统一重装。
5. 不要三套并行： 数据与环境混用，排查成本最高。

选一条主路径，其余只做补充。 环境越多，路径与权限问题越复杂。

记录环境信息。 终端类型、DSH_HOME、安装方式与版本，出问题时先对照这四项。

下一步

先选环境，再统一路径，最后装插件。 想看 WSL 安装细节，看《DeepSeek Harness 在 WSL 里怎么装》；想看 Windows 常见报错，看《Windows 平台报错》；想看安装方式对比，看《DeepSeek Harness 怎么安装》。

来源：DeepSeek Harness 官方文档、dsh CLI README、deepseek-harness 仓库