OrcaRouter 卡片,标题为“Windows 上的 DeepSeek Harness”,副标题为“现在已有官方桌面应用——但对大多数人来说,下面这两条命令仍是更快的进入方式”。一个深色命令条写着“npx @deepseek-ai/dsh web”,箭头指向一个浅色条,写着“http://127.0.0.1:3080”。下方有三个数据框:“MIT · 开源”、“v0.2.1-rc.2”,说明为“开发者预览版——破坏性变更会提前公布”,以及“一切皆插件”,说明为“默认部署中内置 150 多个插件”。页脚:Node 22.19 或更高版本,然后是上面的命令,最后是一个浏览器标签页。
Guides & Insights

Windows 上的 DeepSeek Harness:两条命令,还是官方桌面应用

作者

Gideon Frost

发布日期

最新模型 · 20查看全部模型 →
基准测试:Artificial Analysis · 每日更新
返回全部文章

There is an official DeepSeek Harness desktop app for Windows now, and for most people these two commands are still the faster way in. 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. 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. That address serves the same Web UI the official Electron build wraps, so the only thing the installer adds is the window. If you would rather have the window, our guide to the DeepSeek Harness desktop app covers what the installer writes, which of the three builds has no link on the download page, and why the harness and the app must always carry the same version. 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”,现在的结果里既有 DeepSeek 自家的下载页面,也有一长串社区封装仓库,而且很难看出到底该装哪一个。本文要回答的,正是这个搜索背后真正的问题:DeepSeek Harness 究竟是什么、如今在 Windows 上运行它的官方方式、什么情况下改用安装程序更划算、终端里的替代方案,以及运行一款预览阶段工具的种种实际问题。这是一篇操作指南,而非发布公告——发布消息和泄露线索另有专文介绍。

DeepSeek Harness 是什么(以及不是什么)

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

它也毫无疑问是一个预览版。dsh 当前版本为 0.2.1-rc.2,README 将其标记为开发者预览版,并以大写字母警告称:“将会有破坏兼容性的变更。”这些都没有减缓它的采用速度:该项目于 2026-08-13 公开后的最初 12 小时内就获得了约 50,000 个 GitHub 星标,而在 2026 年 10 月 22 日查看时,已拥有 256,853 个星标和 30,970 个 fork——这是 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 应用,浏览器就是客户端。这与 Electron 构建从 dsh-app://app/ 加载的界面相同,只是少了窗口边框。

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

Terminal-window card titled 'Run DeepSeek Harness on Windows' with eyebrow 'Windows · PowerShell', showing a dark terminal window with the lines 'PS> node --version' (comment: needs v22.19+, Node 24 LTS safer), 'PS> npm install -g @deepseek-ai/dsh', 'PS> dsh web' (comment: arrow to http://127.0.0.1:3080), and 'PS> dsh --profile headless "summarize this repo"' (comment: one-shot, prints & exits), with a footer sourcing the commands to the deepseek-ai/deepseek-harness README and user guide, August 2026. OrcaRouter logo composited bottom-right.

如果你想留在浏览器中,这就是完整的官方路径。如果一台机器已经安装了 Node 22+,那么从“一无所有”到“agent 运行起来”的时间不到一分钟。

"DeepSeek Harness Desktop" 仓库:官方应用带来了哪些变化

此查询的第一页结果仍然大多是社区桌面封装壳——Electron、Tauri 和 WebView2 外壳,它们捆绑 Node 运行时,并在带边框的窗口中启动官方 Web UI。它们都不是 DeepSeek 的产品,也没有增加执行框架能力;它们增加的只是一个启动器。变化在于,截至 2026 年 10 月,DeepSeek 推出了自己的安装程序,因此封装壳不再是避开终端的唯一方式。这些封装壳的共同点是:

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

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

• 它们跟踪官方项目的速度各不相同:有些仍锁定在 0.1.0-rc.6,有些跟随 master,还有许多最后一次是针对 0.1.x 更新的,因此包装器与测试框架的版本会随着时间推移而逐渐偏离。

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

Two-column card titled 'Official dsh vs the GitHub 'desktop' wrappers' with eyebrow 'What page 1 of this search actually shows'. Left column 'Official dsh' with checkmarks: two commands + browser UI, Web UI at 127.0.0.1:3080, headless CLI + TUI plugins, you control the version, no install wizard. Right column 'Community wrappers' with crosses: double-click installer, bundles Node + official UI, unsigned — SmartScreen warns, version drift: rc.5 / rc.6 / master, third-party update layer. Footer: every page-1 'DeepSeek Harness Desktop' repo wraps the official web UI — none is a DeepSeek product. OrcaRouter logo composited bottom-right.

封装工具什么时候才值得用?如今几乎从不值得,而这正是变化所在。当“双击图标、看到托盘、永远不用碰终端”还是决定性因素时,封装工具是唯一的路——如今 DeepSeek 自带安装程序,封装工具唯一真正的优势已经消失,剩下的只是一个第三方,横在预览阶段工具的更新与安全层前面。那官方路径什么时候仍然合适?两条命令加一个浏览器标签页——如果你已经有 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 视图可让你按来源检查运行,并对其进行恢复、分叉、搜索和重放。这正是盯着代理的最终答案进行调试与逐步查看它为何发出每次调用之间的区别。

当官方路径是错误答案时

• 你需要一键操作,不用终端。截至 2026 年 10 月,已有官方安装程序,所以这不再是你需要去找封装器的理由。但它仍然是跳过终端的一个充分理由,而且这是一个合理的选择:你拿浏览器标签页换来的,是一个会隐藏而不是关闭、并且会在没有稳定版本的渠道上自我更新的 Electron 窗口。

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

• 这是一个预览版,而且会出问题。 0.2.1-rc.2 发布时会附带警告,说明即将出现破坏性变更;在不同 rc 构建之间,插件和配置文件可能会停止工作,而在桌面构建中,harness 和 Electron shell 必须始终使用完全相同的版本。任何脚本化使用场景都应固定你的版本。

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

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

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

原生路径是 DeepSeek 自己的 API:在“设置 → 模型”中粘贴密钥即可使用。但 dsh 也接受 OpenAI 兼容的 base URL——在环境变量中设置 DEEPSEEK_BASE_URL,或在 settings.yaml 中配置 LLM 提供商——这意味着无需改动 harness 本身,就能替换其背后的模型。你可以在同一个本地 dsh 安装上,用 DeepSeek V4 Pro 执行复杂重构,用 DeepSeek V4.1 Flash 完成低成本的机械性修改。

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

Screenshot of the OrcaRouter model page for DeepSeek V4 Pro: the Flagship badge, roughly $0.44 input / $0.88 output per 1M tokens, a 1M-token context window, 384K max output, and 1.6T total / 49B active parameters, with OpenAI-compatible code samples.

简短版

在 Windows 上,DeepSeek Harness 对大多数人来说仍是两步命令的安装方式:先安装 Node 22.19+(或 Node 24),再运行 npx @deepseek-ai/dsh web,然后在浏览器中打开 http://127.0.0.1:3080。截至 2026 年 10 月已有官方 Electron 版本,只有当你需要一个关闭后仍能存活的窗口时才值得选用;GitHub 上的社区“桌面”仓库只是包装了同一个本地服务器,相比 DeepSeek 自家的下载版本已不再有优势。对于终端用户,无头模式可运行适用于 CI 的一次性任务,TUI 插件则提供类似 Claude Code 的界面。四种预设——Standard、PTC、Minimal、Creation——决定工具面,而 MCP 加轨迹回放让它真正实用。它免费、开源,且处于 0.2.1-rc.2 的预览阶段:请锁定版本、留意模型账单,并将模型与 harness 分开路由。