前言¶
DeepSeek Harness (DSH) 采用插件化架构，任何新功能都通过插件引入。当工作流需要同时利用 Windows 的图形界面、文件系统和网络环境，以及 WSL 的 Linux 原生能力（如容器、编译环境）时，直接在单一环境中部署会带来兼容性挑战。dsh-wsl-kit 是一个用于解决这一问题的 meta-repo，它将 DSH 智能体驻留在 WSL 中，同时提供 Windows 浏览器的聊天界面，并处理跨操作系统的路径、剪贴板、文件打开和网络请求。
它是什么¶
这是一个 meta-repo，包含文档、安装脚本和 cordis.patch.yml。它本身不包含插件运行时。
install.sh 脚本负责将 Daily、GitHub、LLM 和 Full 插件套件加载到 DSH 的 web 配置中。聊天界面运行在 Windows 浏览器上，而智能体核心和工具链则运行在 WSL 内部。此外，该仓库还包含一套 Linux 本地能力插件（如推理、媒体处理、只读 DevOps 工具）的链接脚本，以及 IM、Obsidian 和 Jev 等可选插件。
核心功能¶
该套件主要提供以下能力：
- 跨 OS 操作支持：通过 Daily 套件，智能体可以执行跨操作系统的操作，包括路径映射、剪贴板读写、默认浏览器调用、文件打开、网络请求和启动进程。
- 分离式架构：Windows 端仅提供 UI 和交互层，代理核心与工具执行环境（WSL）完全隔离，确保 Linux 原生工具（如
tmux、git、docker）能直接调用。 - 可选插件生态：
- IM 插件：支持飞书、企业微信、钉钉、QQ、Slack、Discord、Telegram 等即时通讯工具的接入。
- Obsidian 插件：实现 WSL 代理与 Windows NTFS 仓库的双向交互。
- Jev 插件：提供系统级问答能力。
- Linux 本地能力：通过链接 Linux 插件，智能体可访问本地 LLM 推理服务（Ollama、llama.cpp、vLLM）、媒体文件、搜索、机密管理以及只读的 DevOps 工具集。
安装与启用¶
在使用前，请确保 DeepSeek Harness (dsh) 版本不低于 0.1.2。
- 安装主套件：
进入 WSL 环境，克隆仓库并运行安装脚本，或使用 DSH 插件管理命令。
bash install.sh
或者，如果只需要特定插件，可以使用：
dsh plugin add <plugin-repo-url>
- 链接 Linux 本地能力插件：
主套件安装脚本不包含 Linux 本地能力插件。需要手动运行链接脚本将这些插件加载到 DSH 中：
bash scripts/link-linux-plugins.sh
- 安装可选插件：
若需 IM、Obsidian 或 Jev 等功能，需单独安装对应的插件仓库。
架构与访问¶
该套件运行在 DSH 的 web 模式下，界面与代理运行在两个不同的端口。
- Windows UI：运行在端口 3081。访问时需要附加一次性
?token=参数（直接访问 3081 会返回 401）。端口 3080 为 WSL 专用，仅供代理内部使用。 - 插件映射差异：有三个插件在 npm 上的发布名称与其仓库名称不同，安装时需注意：
- 仓库
dsh-wsl-tray-> npm 包名dsh-wsl-tray-launcher - 仓库
dsh-wsl-expose-> npm 包名dsh-wsl-portproxy - 仓库
dsh-wsl-workspace-> npm 包名dsh-wsl-workspace-check
- 仓库
注意事项¶
- 包描述与安装限制：仓库中的
package.json描述了目标插件集（31 个插件）的配置，但由于 pnpm 的限制（不允许在github:依赖中嵌套github:依赖），该 bundle 目前无法直接通过pnpm add安装。必须使用install.sh或dsh plugin add逐个安装。 - 运行时：该插件不包含运行时，需要确保系统已正确安装 DSH。
- 权限与安全：Linux 本地能力插件（如 DevOps 工具）通常以 WSL 用户的权限运行，使用时需注意权限配置。
