前言¶
在 Windows 上使用 DeepSeek Harness（DSH）时，如果你同时需要使用 WSL 环境下的 DSH，会遇到界面切换繁琐、会话与配置容易混淆的问题。已有的做法通常需要在两个终端窗口之间反复跳转，或者在两个系统中分别打开 DSH Desktop，导致工作流割裂。DeepSeek Harness（DSH）采用「一切皆插件」的理念，通过社区插件可以扩展桌面端的统一入口能力。本插件旨在在 Windows DSH Desktop 中提供统一的桌面入口，支持同时运行本机 DSH 与 WSL DSH，并通过标题栏切换保持两侧会话与配置的独立性。
插件概述¶
这是一个面向 Windows 桌面端的 DSH 插件，用于在 DSH Desktop 的左上角标题栏切换本机 DSH 与 WSL DSH 界面。插件维护者为 habaneraa，分类为客户端。它支持 Windows 与 WSL 两个 DSH 实例同时运行，两侧的工作区、会话、配置保持独立，互不影响。插件不会影响 Windows 与 WSL 两侧的任何 DSH 数据，不会尝试同步配置或会话，代码量小于 1000 行，无副作用。
核心功能¶
- 统一桌面入口：在 DSH Desktop 左上角标题栏提供切换按钮，可在「本机 DSH」与「WSL DSH」之间切换。
- 独立会话与配置：两侧的工作区、会话、配置保持独立，互不干扰，切回本机不会停止 WSL 服务。
- 自动启动 WSL：首次选择 WSL 时，插件会自动在 WSL 内启动
dsh web。 - 轻量无副作用：插件以当前 DSH 进程权限运行，代码量小于 1000 行，不修改或同步两侧数据。
安装与启用¶
本插件只安装在 Windows 侧，WSL 不需要安装本切换器。可通过 DSH 内置的插件管理器直接安装：
dsh plugin --profile desktop add github:habaneraa/dsh-desktop-host-switcher
也可以在 Windows PowerShell 中通过打包安装到 desktop profile（需先下载对应版本包，README 中版本为 0.2.1）：
$cli = "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
& $cli plugin --profile desktop add 'dsh-desktop-host-switcher-0.2.1.tgz'
安装后，在 DSH Desktop 左上角标题栏即可看到切换按钮，点击即可在「本机 DSH」与「WSL DSH」之间切换。
典型用法¶
- 确保 Windows DSH Desktop 已安装并正常运行。
- 在 WSL 2 中已安装 Linux Node.js 和 DSH，且默认 Bash / Zsh 的交互式登录环境可以找到它们。
- 通过 DSH 内置插件管理器安装
github:habaneraa/dsh-desktop-host-switcher到 desktop profile。 - 打开 DSH Desktop，在左上角标题栏点击切换按钮。
- 首次切换到 WSL 时，插件会自动在 WSL 内启动
dsh web，稍等片刻即可访问 WSL 侧的 DSH 界面。 - 切回本机或 WSL 时，两侧的会话与配置保持独立，不会互相影响。
适用场景与注意事项¶
- 适合需要在 Windows 桌面端同时使用本机 DSH 与 WSL DSH 的开发者或智能体开发者。
- 插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证。
- WSL 2 需要能通过 localhost 转发访问 WSL 服务。
- WSL 页面内的「独立 Explorer 目录按钮」由新插件
dsh-wsl-directory-opener提供。
结尾¶
本插件通过统一的桌面入口，让 Windows 本机 DSH 与 WSL DSH 可以同时运行且保持独立，提升了跨环境协作的效率。更多细节与源码请参考插件目录页与 GitHub 仓库：
- 插件目录页：https://www.skillhub.cn/plugins/habaneraa/dsh-desktop-host-switcher
- GitHub：https://github.com/habaneraa/dsh-desktop-host-switcher
