在 Windows 上运行 DeepSeek Harness：没有桌面应用也没问题——官方运行方式

There is no official DeepSeek Harness desktop app for Windows, and you do not need one. DeepSeek Harness (dsh) — the open-source agent runtime DeepSeek released under an MIT license on 2026-08-13 — is a Node.js tool that runs a local web server you open in your browser, with a headless CLI for the terminal as the alternative. On Windows the whole setup is two commands: install Node.js 22.19 or newer (Node 24 LTS is the safer pick), then run npx @deepseek-ai/dsh web and open http://127.0.0.1:3080. Every "DeepSeek Harness Desktop" repository on GitHub is an unofficial community wrapper around that same two-command setup — useful to some people, but not required. It is also the harness DeepSeek uses to produce the agentic coding results it reports for DeepSeek V4 Pro and DeepSeek V4 Flash, which is why the two models keep showing up in any conversation about it.

如果你搜索过"deepseek harness windows"，你很可能正盯着一堆封装仓库（wrapper repos）的页面，纠结该安装哪一个。这篇文章解答了搜索背后真正的问题：DeepSeek Harness 到底是什么、如今在 Windows 上运行它的官方方式、终端替代方案，以及运行一个预览阶段工具时如实存在的注意事项。这是一篇教程文章，而不是发布公告——发布和泄露的来龙去脉会在其他文章中分别讲述。

DeepSeek Harness 是什么（以及不是什么）

DeepSeek Harness 不是模型，也不会对模型进行基准测试。它是智能体运行时：这一层将模型与工具、文件、Shell 和互联网连接起来——读取你的代码、规划更改、运行命令，并不断迭代直到任务完成。其架构体现在它的标语中：“一切皆插件。”模型、工具、技能、会话、沙箱、智能体循环本身，甚至 Web UI，都是启动时组合而成的插件，并构建在 Cordis 元框架之上——这也是 Koishi 聊天机器人生态背后的同一内核。默认部署包含 150 多个插件。

这也明确地是一个预览版本。dsh 目前版本为 0.1.0-rc.6，README 将其标注为开发者预览版，并以大写字母警告："将会有破坏兼容性的更改。"这些都没有减缓其被采纳的速度：该项目于 2026-08-13 公开发布后的 12 小时内便获得了约 50,000 个 GitHub Star，截至 2026-08-16 已达到约 126,000 个——这是 DeepSeek 发布的速度最快的开源版本。

简而言之：Windows 官方的路径是两个命令

DeepSeek 官方 README 用一句话给出了 Windows 下的运行方式：安装 Node.js，然后运行npx @deepseek-ai/dsh web。具体步骤如下：

• 安装 Node.js 22.19+ 或 Node 24。当前 dsh 版本要求 Node 22.19 或更高版本；在 Windows 上，选择 Node 24 LTS 更稳妥，原因很简单——较新的 Node 版本包含原生的 zstd 解压缩支持，dsh 用它来读取压缩的会话日志。请使用以下命令检查您的安装：node --version（在 PowerShell 或 cmd 中）。

• Run the harness. Either run it on the spot with npx @deepseek-ai/dsh web, or install it once with npm install -g @deepseek-ai/dsh and then run dsh web from any folder afterwards. The first run prints the URL and starts the Web UI at http://127.0.0.1:3080.

• 在浏览器中打开该地址。Web UI 是一个本地 Web 应用——这就是为什么没有桌面应用；浏览器就是桌面应用。

• 只需添加一次模型密钥。在 Web UI 中，打开设置 → 模型，粘贴 DeepSeek API 密钥并保存。它会立即生效，无需重启服务器。dsh 使用你启动它时所在的文件夹作为默认文件系统位置，UI 的选择工作区步骤可让你将其指向任意项目目录。

这就是完整的官方路径。如果机器上已经安装了 Node 22+，从“什么都没有”到“代理运行”的时间不到一分钟。

为什么每个 “DeepSeek Harness Desktop” 仓库都是包装器

此查询的第一页结果全都是社区桌面封装——即 Electron、Tauri 和 WebView2 外壳，它们捆绑了 Node 运行时，并在带框架的窗口中启动官方 Web UI。它们不是 DeepSeek 的产品，也不会增加 harness 能力；它们增加的只是一个启动器。它们的共同点是：

它们只需双击即可启动，完全无需接触命令行，而这正是它们真正的卖点。

• 它们未签名，因此 Windows SmartScreen 在安装时会发出警告 — “更多信息 → 仍要运行”是流程的一部分。

他们跟踪官方项目的速度不同：有些人固定使用 0.1.0-rc.5，有些人固定使用 0.1.0-rc.6，有些人跟随 master，因此包装器与测试工具的版本会随着时间的推移逐渐拉开差距。

• 它们将 dsh 始终使用的相同本地数据存储在 ~/.dsh 下，因此在封装器与官方 CLI 之间切换不会重置你的会话。

什么时候值得用包装器？当"双击图标、看到托盘图标、永不碰终端"是决定性因素，并且你接受第三方现在充当预览阶段工具的更新和安全层时。什么时候不值得？官方路径是两条命令和一个浏览器标签页——如果你已经有 Node，包装器带给你的只是一个你可能用不上的启动器，并且作为交换，还增加了它自己的维护负担。

终端路线：无头CLI与TUI插件

如果浏览器不是你的工作环境，dsh 也有终端方案，分为两种模式。

无头模式是非交互式模式：dsh --profile headless "summarize this repository"运行单个任务而无需用户界面，打印结果后退出——这是适合 CI 的模式。在 Windows 上，脚本和计划任务也应使用该模式，因为它不需要显示器或登录会话。

TUI 是一种 Claude Code 风格的交互式终端前端入口，以社区插件包的形式提供，而非包含在核心包中。类似 dsh-tui 的包可以通过 dsh plugin --profile tui add <package> 安装到配置文件中，并使用 dsh --profile tui 运行；至少有一个包附带 Windows .cmd 启动器。在尝试之前值得了解的注意事项：TUI 需要真实的终端来进行输入和输出——如果你的配置使用了管道或重定向，dsh 将拒绝运行并提示你改用 headless 模式。

四个预设：哪种任务该用哪个

dsh 内置了四个代理预设，它们并不是难度阶梯——而是四种不同的工具界面。你可以在 ~/.dsh/settings.yaml 中的 agent-presets.default 下设置默认值。

• Standard 是默认选项：功能齐全的日常智能体 — 文件编辑、shell、文件和网页搜索、技能、子智能体、规划。这是大多数Windows用户应该首先使用的。

• PTC（也称为 Code mode）保留了 Standard 的所有功能，但改变了工具的呈现方式：模型不是进行一长串孤立的工具调用，而是编写一个 TypeScript 程序来组合多步骤操作——循环、过滤、条件分支。适用于复杂、重复或多步骤的工作流。

• Minimal刻意将代理精简为两种工具——持久化 shell 和文件编辑器——旨在评估和基准测试，而非日常使用。DeepSeek 自家的智能体评分就是在此预设上运行的。

• Creation（Cordis）用于构建自定义预设：包括运行时检查、内存中插件实验和预设编写指南。适合对测试框架本身进行调试。

MCP 与轨迹回放：为什么这值得运行

有两个特性使 dsh 优于普通聊天客户端。首先，它内置了模型上下文协议（MCP）客户端——/mcp 命令和设置中的 MCP 标签页可将外部 MCP 服务器接入该框架，因此其他代理使用的相同工具也能接入 dsh。其次，每次运行都会写入仅追加的会话日志，Trajectory 视图可让你按来源检查运行，并对其进行恢复、分叉、搜索和重放。这正是盯着代理的最终答案进行调试与逐步查看它为何发出每次调用之间的区别。

当官方路径是错误答案时

• 你需要一键操作，无需终端。没有官方安装程序。如果双击安装是硬性要求，那你用的是社区封装版——这些封装版未签名，所以需要在便利性与第三方维护负担之间权衡。

• 你的 Windows 机器老旧或受到限制。 dsh 需要 Node 22.19+（或 Node 24）。在受管机器上，这意味着需要安装运行时，并且可能还需要一个你没有的批准。

• 这是预览版，而且会出问题。0.1.0-rc.6 附带警告：破坏性变更即将到来；在 rc 版本之间，插件和配置文件可能会停止工作。任何脚本化用途请固定你的版本。

• 模型费用由您承担。dsh 是免费的；每个任务都会消耗您所配置密钥对应的令牌。代理循环会重新读取文件并重试，而冗长的模型在处理困难任务时，一个下午就可能消耗惊人的预算。这正是模型选择而非工具选择主导成本的地方。

• 固定订阅可能优于按 token 计费的路由方式。如果你使用某一实验室计划且未超出其额度上限，固定订阅通常比任何按 token 计费的方式都更便宜。路由方式只有在混合使用多个模型或需要故障转移时才更具优势——默认情况下并非如此。

将模型路由到测试工具后面

最直接的方式是使用 DeepSeek 自家的 API：在 Settings → Models 中粘贴密钥即可。而 dsh 也接受兼容 OpenAI 的 base URL——你可以在环境变量中设置 DEEPSEEK_BASE_URL，或在 settings.yaml 中配置 LLM 提供方——这样就能在不改动工具本身的情况下替换其背后的模型。你可以在同一个本地 dsh 安装环境中，用 DeepSeek V4 Pro 完成困难的重构，用 DeepSeek V4 Flash 处理低成本的机械性编辑。

这就是 OrcaRouter 所处的层级。一个兼容 OpenAI 的基础 URL、200+ 模型、零加价——供应商目录价直接透传——并在供应商限流或服务降级时自动故障转移。将 dsh 指向它，harness 仍留在你的机器上，而模型目录变成一次路由决策而非一次采购。两个坦诚的提醒：我们不托管 dsh——它在你的 Windows 机器上本地运行；如果你需要 DeepSeek 自有 API 之外的模型，我们只是模型访问层。另外，对于套餐额度内的单个重型模型，无论路由器如何，固定订阅通常是更便宜的选择。

简短版本

DeepSeek Harness 在 Windows 上只需两条命令即可完成设置，而非通过应用商店安装：先安装 Node 22.19+（或 Node 24），然后运行 npx @deepseek-ai/dsh web，最后在浏览器中访问 http://127.0.0.1:3080。GitHub 上的“桌面版”仓库只是围绕同一本地服务器的非官方封装。在终端中，headless 模式可为 CI 运行一次性任务，TUI 插件则提供类似 Claude Code 的界面。四种预设——Standard、PTC、Minimal、Creation——决定工具范围，MCP 加上轨迹回放使其真正实用。它免费、开源且处于预览阶段：请固定版本、留意模型账单，并将模型与 harness 分开路由。