dshbase

插件目录 / Desktop / deepseek-harness-desktop

deepseek-harness-desktop

已验证 · 实测可装 chyra-moon

✓ 持续维护 2 位贡献者 基于 102 个官方 DSH 包

查看 GitHub ↗ ← 返回插件目录

21Stars
0Forks
2未关闭 issue
JavaScript语言
2026-09-21最近推送
跨平台平台

功能简介

DeepSeek Harness桌面壳:官方Web UI的1:1复制Windows应用(社区项目)

✅
我们的评价
可用 — 实测通过,社区增长中

DeepSeek Harness桌面壳:官方Web UI的1:1复制Windows应用(社区项目) 实测能干净安装、正常启动。社区在增长,是个稳妥选择。

「已验证」表示我们的自动化 CI 在干净 profile 里实际执行了 dsh plugin add 并启动成功——仅此而已。功能描述与版本兼容性均为作者声明。这不是安全审计,也不代表对第三方代码的背书。

README

DeepSeek Harness Desktop

熟悉的 DeepSeek Harness,更顺手的 Windows 桌面体验。

官方 Web 界面 · 内置本地服务 · 托盘常驻 · 自动恢复

GitHub Release Windows x64 MIT License

下载最新版 →   ·   快速开始   ·   问题反馈   ·   English


项目介绍

DeepSeek Harness Desktop 是 DeepSeek Harness 的 Windows 桌面适配版。项目使用 Electron 加载官方 Web 前端,将本地服务的启动、连接与恢复整合进桌面应用,让你从桌面直接进入 Harness 工作区。

安装包包含运行时与官方 dsh 服务,日常启动无需另行安装 Node.js 或输入命令。桌面适配层提供窗口管理、托盘驻留和连接恢复等能力;Harness 的核心功能与工作流程由内置的官方 dsh 提供。

本项目由社区维护,非 DeepSeek 官方客户端。DeepSeek Harness、@deepseek-ai/* 软件包及官方前端的版权归各自权利人所有。

桌面版带来了什么

能力 使用体验
官方界面 加载官方 Web 前端,延续 Harness 的工作区与会话操作方式。
服务自动管理 启动时自动连接或拉起本地 dsh 服务,无需单独维护终端窗口。
已有服务复用 默认探测本机 3080 端口;识别到 dsh 服务后直接连接,可与浏览器使用同一实例。
连接异常恢复 定期检查服务状态,检测到异常后尝试恢复服务并重新加载页面。
桌面常驻 支持托盘显示与隐藏、窗口位置和尺寸记忆,以及单实例运行。
清晰的启动状态 鲸鱼光点动画搭配状态提示,展示服务启动与恢复过程。

下载与安装

获取最新版本 →

面向 Windows x64。进入发布页面,查看版本说明,并在 Assets 中选择适合你的文件:

发行形式 文件名特征 适合场景
安装版 · 推荐 DeepSeek.Harness-<版本>-x64.exe 日常使用,可选择安装目录,并创建桌面与开始菜单快捷方式。
解压版 DeepSeek.Harness-<版本>-win32-x64.zip 希望直接管理应用文件;完整解压后运行其中的程序。
单文件便携版 DeepSeek.Harness-<版本>-portable-x64.exe 无需安装;启动时需要解包,可能比安装版等待更久。

文件名以发布页面实际附件为准。下载入口不绑定具体版本,后续更新可继续通过同一链接获取;预发布版本也请在发布列表中查看。

快速开始

  1. 下载并启动:安装应用,或将 ZIP 完整解压后运行 DeepSeek Harness.exe。
  2. 等待服务就绪:应用自动启动内置服务;若默认端口已有可识别的 dsh 服务,则直接复用。
  3. 进入工作区:在 Harness 界面中完成所需配置,选择工作区并开始使用。模型连接与凭据以官方界面的配置要求为准。

关闭窗口后,应用默认保留在系统托盘。点击托盘图标可恢复窗口;要完全关闭应用,请在托盘菜单中选择 退出。

常用快捷键

快捷键 操作
Ctrl + R / F5 重新加载当前页面
Ctrl + Shift + O 在系统浏览器中打开当前服务
Ctrl + Shift + I 打开或关闭开发者工具

使用说明

与浏览器版一起使用

应用默认检查 127.0.0.1:3080,识别到已运行的 dsh 服务后会直接连接。同一服务实例下,桌面端和浏览器端访问的是同一套会话数据。

若该端口被其他程序占用,应用会尝试使用空闲端口启动内置服务。可通过托盘菜单中的 关于 查看当前服务地址和运行模式。

关闭托盘驻留与选择工作区

完全退出应用后,在应用数据目录的 settings.json 中将 closeToTray 改为 false,下次启动后关闭窗口即可退出。修改时保留文件中的其他配置项。

工作区默认使用应用内浏览式目录选择器,以改善远程桌面及受控会话环境下的兼容性。当前版本启动时会将历史 directoryPicker: "native" 配置迁移为 "browse"。

版本更新

普通用户可随时通过 Releases 页面 获取更新,具体变化以各版本的发布说明为准。

项目也提供可配置的自动更新机制:打包版通过环境变量 DSH_UPDATE_URL 或应用数据目录中的 update-url.txt 读取更新源。未配置更新源时会跳过自动更新;配置有效更新源后,会在启动时检查、下载更新,并在下载完成后启动安装与重启流程。

更新源需要提供 electron-updater Generic Provider 所需的更新清单与安装文件,不是直接填入 GitHub Releases 页面地址。

升级到 0.1.5 时的会话数据变化

官方 dsh 0.1.5 起将会话日志格式升级到 V3:应用打开旧会话时会自动迁移,生成新版日志文件并保留原文件(同目录下 session.v3.jsonl.zstd 与 session.jsonl.zstd 并存)。

需要注意:升级后的新内容只写入 V3 文件,更早版本的应用无法读取它。因此从 0.1.5 回退到旧版本时,旧历史仍可读取,但升级之后产生的对话不会显示。

建议:跨大版本升级前先备份应用数据目录下的 sessions 文件夹(例如 %USERPROFILE%\.dsh\sessions)。

启动异常与问题反馈

服务恢复需要一定时间,实际耗时取决于本机环境与服务启动情况。若持续无法进入界面,可先通过托盘 关于 查看服务信息,再通过 Issues 反馈。

建议附上应用版本、Windows 版本、使用的发行形式和复现步骤;如有错误信息,可一并提供相关片段。

开发与构建

从源码运行、验证与打包

准备 Windows x64 与 Node.js / npm 环境,在项目目录执行:

npm install
npm run icon
npm start

常用维护命令:

命令 用途
npm run smoke 运行应用启动冒烟检查
npm run dist 构建安装版、解压版与便携版,并校验打包完整性
npm run verify 单独校验已生成的应用包
npm run update:dsh 升级官方 dsh 并重新构建发行包
npm run preview -- --open 在浏览器中预览启动状态页

构建产物位于 release/。当前源码中的桌面版本与内置 dsh 版本均为 0.1.5-rc.1;后续以 package.json 和发布说明为准。

致谢与许可

感谢 DeepSeek 及 DeepSeek Harness 贡献者提供的开源基础。

本项目以 MIT License 开源。上游软件包与其他依赖遵循各自的许可证。

安装

🧩 让 Agent 自动装(推荐)

装一次目录插件,之后本站所有插件都能让 DeepSeek Harness 自动找、自动装:

dsh plugin add dshbase-catalog

然后对 agent 说「帮我装 deepseek-harness-desktop」,它会在目录里找到并自动安装。文档:dshbase-catalog · 已验证场景包。

该插件是 GitHub 源码(未发 npm)——直接从仓库装:

Web profile:

dsh plugin --profile web add github:chyra-moon/deepseek-harness-desktop

Headless(CLI)profile:

dsh plugin --profile headless add github:chyra-moon/deepseek-harness-desktop

实测报告

验证通过:从 GitHub 源码完成 L1 安装 + L2 加载 + L3 运行(dsh 0.1.0-rc.6)。

使用场景

把一个新模型、provider 或路由策略接入循环,让 dsh 能为任务选对脑子。

适合谁

同时用多个模型或 provider、想让成本/质量/延迟自动平衡的人。

二次开发建议

provider 适配器和路由启发式是缝——加后端、调回退链,或加按任务的模型选择。

✓ 低风险 静态扫描 · 25 个文件 · 2026-09-29

分享徽章

Desktop 里更多

浏览全部 7797 个插件 →