🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

桌面客户端 SnowCrescenter-tech/dsh-desktop

DeepSeek Harnessv0.2.0
SnowCrescenter-tech81 天前有提交已提供中文文档扫描:含敏感能力

双击即用,把 Harness 装进 Windows 原生窗口

34.8/100
综合分
6
GitHub 星标
—
npm 周下载
—/5
用户评分

数据截至 2026/9/17 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

自动兼容检查未通过:仓库 package.json 标记 private,未发布到 npm,需从源码安装。以下命令仍可尝试,但可能失败。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add SnowCrescenter-tech/dsh-desktop
该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:已验证
是什么
dsh 原生插件 · dev
装得上吗
本站已在 dsh 0.2.1-rc.2 下真实安装成功
非静态推断
L4 · 真实安装等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
更新放缓:最近一次提交在 81 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查需源码安装

仓库 package.json 标记 private,未发布到 npm,需从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-desktop @ 0.2.0
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

源码安装时若 pnpm 拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/11/1 02:41:00

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件
查看扫描证据(共 18 处,展示前 18 条)
  • 执行外部命令固定命令
    src/main/autolaunch.ts:86
    nodeExecFile('reg', args, { windowsHide: true }, (error) => {
  • 写入本地文件
    src/main/first-run.ts:79
    mkdirSync(files.dir, { recursive: true });
  • 写入本地文件
    src/main/first-run.ts:80
    writeFileSync(join(files.dir, 'package.json'), stringifyPackageJson(files.packageJson), 'utf8');
  • 写入本地文件
    src/main/first-run.ts:81
    writeFileSync(join(files.dir, 'cordis.patch.yml'), files.cordisPatch, 'utf8');
  • 读取本地文件
    src/main/key-store.ts:35
    content = readFileSync(keyEnvPath(dshHome), 'utf8');
  • 读取本地文件
    src/main/store.ts:107
    raw = readFileSync(filePath, 'utf8');
  • 写入本地文件
    src/main/store.ts:128
    mkdirSync(dir, { recursive: true });
  • 写入本地文件
    src/main/store.ts:131
    writeFileSync(tmpPath, `${JSON.stringify(settings, null, 2)}\n`, 'utf8');
  • 写入本地文件
    src/main/store.ts:132
    renameSync(tmpPath, filePath);
  • 读取本地文件
    src/main/store.ts:135
    if (existsSync(tmpPath)) {
  • 删除本地文件
    src/main/store.ts:136
    unlinkSync(tmpPath);
  • 读取本地文件
    src/main/update.ts:210
    return existsSync(join(resources, APP_UPDATE_YML));
  • 写入本地文件
    src/shared/dotenv.ts:58
    mkdirSync(dir, { recursive: true });
  • 写入本地文件
    src/shared/dotenv.ts:61
    writeFileSync(filePath, `${lines.join('\n')}\n`, 'utf8');
  • 读取本地文件
    src/shared/dotenv.ts:69
    if (!existsSync(filePath)) {
  • 读取本地文件
    src/shared/dotenv.ts:72
    const content = readFileSync(filePath, 'utf8');
  • 读取本地文件
    src/shared/tokens.test.ts:28
    const tokensCss = readFileSync(
  • 读取本地文件
    src/shared/tokens.test.ts:32
    const baseCss = readFileSync(
扫描于 2026/11/3(0 天前) · 范围 入口闭包 + 全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

功能亮点

  • 无边框窗口
  • 系统托盘
  • 原生通知

DeepSeek Harness 桌面版 — 原生 Windows 桌面壳(无边框窗口、系统托盘、原生通知、单实例、开机自启)

README

由 DeepSeek 最新模型翻译生成
dsh-desktop 🇨🇳 中文 · 🇬🇧 English 一键原生桌面客户端,双击就能用上 DeepSeek Harness。不用装 Node,不用敲命令,安装完成,打开就是一个窗口。 无边框窗口 · 系统托盘 · 原生通知 · 单实例运行。DeepSeek Harness 的全部能力,零搭建成本。 📖 完整文档站(中英即时切换)→ https://github.com/SnowCrescenter-tech/dsh-desktop/tree/main/website 项目简介 DeepSeek Harness 是 DeepSeek 官方的 agent 框架。官方目前还是开发者预览版,自己动手装的话,得先装 Node 22.19+ 或 Node 24、装好 pnpm,再对着命令行敲一串命令。对大多数非技术用户来说,这道门槛实在太高了。 dsh-desktop 把 DeepSeek Harness 的 Web UI 包进一个原生 Windows 桌面程序。界面本身完全不动,只是外面多了一层顺手的壳:程序常驻系统托盘,窗口用自绘标题栏,消息走 Windows 原生通知,同一时间只跑一个实例。下载、安装、双击,完事。
展开完整文档(README 剩余 1 节)
dsh-desktop

🇨🇳 中文 · 🇬🇧 English

一键原生桌面客户端,双击就能用上 DeepSeek Harness。不用装 Node,不用敲命令,安装完成,打开就是一个窗口。

无边框窗口 · 系统托盘 · 原生通知 · 单实例运行。DeepSeek Harness 的全部能力,零搭建成本。

📖 完整文档站(中英即时切换)→ https://github.com/SnowCrescenter-tech/dsh-desktop/tree/main/website

项目简介

DeepSeek Harness 是 DeepSeek 官方的 agent 框架。官方目前还是开发者预览版,自己动手装的话,得先装 Node 22.19+ 或 Node 24、装好 pnpm,再对着命令行敲一串命令。对大多数非技术用户来说,这道门槛实在太高了。

dsh-desktop 把 DeepSeek Harness 的 Web UI 包进一个原生 Windows 桌面程序。界面本身完全不动,只是外面多了一层顺手的壳:程序常驻系统托盘,窗口用自绘标题栏,消息走 Windows 原生通知,同一时间只跑一个实例。下载、安装、双击,完事。

功能一览

| 功能 | 一句话说明 |
| 无边框窗口 | 自绘 36px 标题栏 + 实时状态点 |
| 系统托盘 | 常驻后台,单击唤回,右键菜单齐全 |
| 原生通知 | 标准 Windows 通知样式,原生缺失时降级为托盘气泡 |
| 单实例运行 | 同时只跑一个,重复双击唤出已有窗口 |
| 开机自启 | 可选,登录后在后台静默启动 |
| 首次引导 | 首启粘贴 API Key,即贴即用,Key 只存本机 |
| 端口 0 自动分配 | 每次启动自动挑空闲端口,永不冲突 |
| 自动更新 | 后台静默下载,重启即完成更新 |

功能特性

- ▭ 无边框窗口:没有系统默认边框,36px 标题栏由程序自绘,并带一个实时状态点。青色 = 本地服务运行中,灰色 = 启动中,红色 = 出错了。Windows 11 下窗口圆角由 DWM 原生渲染。
- ▣ 系统托盘:程序常驻托盘。单击图标唤回主窗口;右键菜单包含:打开主界面、开机自启(复选)、关于、退出。
- ◈ 原生通知:提醒走 Windows 原生通知样式,和普通应用一模一样;系统不支持时自动降级为托盘气泡。
- ◎ 单实例运行:同一时间只允许一个实例,重复双击只会把已有窗口唤到前台。
- ↻ 开机自启:可选,登录后在后台自动启动,由 Windows 注册表 Run 键实现。
- ▤ 首次启动引导:第一次运行弹出一个向导对话框,引导你输入 DeepSeek API Key。Key 只保存在这台电脑上,位置是 /.env。
- ⇄ 端口 0 自动分配:每次启动都让系统挑一个空闲端口(--port 0),天然不会和 3080 或其他程序撞车。
- ↑ 自动更新:安装版(NSIS)启动后会在后台静默检查新版本并自动下载;下载就绪后弹原生通知,托盘菜单出现"重启并更新",点击即重启应用完成安装。便携版没有安装器,"检查更新"会打开 GitHub Releases 页面,由你自行下载新版 zip 替换旧目录。

快速开始

1. 到 Releases 页面下载最新安装包。
2. 安装完成,双击桌面上的 DeepSeek Harness 图标。
3. 首次启动时,在引导对话框里粘贴你的 DeepSeek API Key,主窗口会自动打开。

程序会自动启动服务、打开主界面,这些都不需要你手动操作。

首次运行流程

首次启动是一条编排好的流水线。如果没有配置 API Key,先弹模态对话框引导输入;然后写盘 desktop profile,以 --profile desktop --port 0 拉起捆绑的 CLI,监督器等待就绪行(dsh web: http://127.0.0.1:)。一旦解析到,就把 Web UI 载入内容区,状态点变青。

1. 获取单实例锁。若已有实例在运行,本进程直接退出,由已有实例唤出主窗口。
2. 若尚未配置 API Key,先弹出引导对话框,输入并保存到 /.env。
3. 写盘 desktop profile,再以 dsh --profile desktop --port 0 拉起捆绑的 CLI。
4. 等待就绪行(dsh web: http://127.0.0.1:)。解析到后,Web UI 载入内容区,状态点变青;若超时,则显示带重试按钮的错误视图。

首次启动:设置 API Key

第一次运行会先弹出引导窗口,让你填写 DeepSeek API Key:

1. 打开 https://platform.deepseek.com,注册并登录。
2. 在 API Keys 页面点击"创建",会得到一个形如 sk-... 的 Key。
3. 把 Key 粘贴进引导窗口,点击保存,主界面就会自动打开。

你的 Key 只会写在自己电脑上,不会上传到任何地方。

架构一览

dsh-desktop 是一个 Electron 外壳。主进程负责窗口、托盘、通知、开机自启,以及启动并守护捆绑的 DeepSeek Harness CLI 的运行时监督器;preload 桥把一份精简且冻结的 window.dshDesktop API 暴露给渲染层;窗口自身的 web 内容绘制标题栏,其下方一个沙箱化的 WebContentsView 承载 DeepSeek Harness 的 Web UI;这套 Web UI 跑在 desktop profile 上,按序装载 @deepseek-ai/dsh-base、@deepseek-ai/dsh-web-app 和 @dsh-desktop/client。

常见问题

杀毒软件报毒、SmartScreen 提示怎么办?

桌面应用打包后没有数字签名,第一次运行时 Windows SmartScreen 可能会提示"Windows 已保护你的电脑",部分杀毒软件也可能误报。这是打包软件的常见情况,不代表程序有问题。

- SmartScreen 提示:点击"更多信息" → "仍要运行"
- Windows Defender:病毒和威胁防护 → 排除项 → 添加排除项
- 360 安全卫士:木马查杀 → 信任区 → 添加信任目录
- 火绒安全:防护中心 → 病毒防护 → 信任区 → 添加文件/目录
- 腾讯电脑管家:病毒查杀 → 信任区

能安装在中文路径吗?

可以。桌面版不依赖命令行脚本,装在带中文的路径(比如"软件\DeepSeek Harness")下也能正常运行。

端口被占用怎么办?

服务监听端口由系统自动分配(端口 0),启动时系统会挑一个空闲端口,天然不会和 3080 或其他程序冲突,也不需要手动配置。

关掉窗口后程序为什么还在?

关闭窗口默认是最小化到托盘,程序仍在后台运行。从托盘菜单里选"退出"才会完全结束。

怎么更新到新版本?

安装版启动后会在后台自动检查更新。新版本就绪时会有通知提醒,从托盘菜单选"重启并更新"(或直接重启应用),退出时即完成安装;任何时候都可以用托盘菜单的"检查更新"手动检查。便携版没有自安装器:"检查更新"会打开 GitHub Releases 页面,下载最新的 zip 解压替换旧目录即可。

README 怎么做到中英即时切换?

本 README 是单文件双语排版:顶部 🇨🇳 中文 与 🇬🇧 English 两个标签直接跳转到对应章节,整个过程不翻页、不换文件。想要真正的交互式体验(语言即时切换、深色模式、站内搜索)时,请访问在线文档站:https://github.com/SnowCrescenter-tech/dsh-desktop/tree/main/website

需要付费吗?

软件本身是免费开源项目,但调用 DeepSeek 的 API 由官方按量计费。当前参考价(每百万 tokens):deepseek-v4-flash 输入 $0.14、输出 $0.28;deepseek-v4-pro 输入 $0.435、输出 $0.87;命中缓存时输入价格要低得多。具体价格以 https://api-docs.deepseek.com/quick_start/pricing 为准,2026-08-16 起官方改为峰谷计价。

技术说明

- 基于 Electron 43 构建,内置 Node 运行时 v24.19.0。
- 通过 @deepseek-ai/dsh@0.1.0-rc.6 启动 Web UI。
- 数据与 API Key 保存在 %USERPROFILE%\.dsh(可用 DSH_HOME 环境变量覆盖)。
- desktop profile 按序装载:@deepseek-ai/dsh-base → @deepseek-ai/dsh-web-app → @dsh-desktop/client。
- 标题栏、托盘与引导遵循一套简约沉静的设计语言,配色取自 DeepSeek 品牌蓝(强调色 #4D6BFE、深墨 #10131A、纸白 #F4F6F9)。

免责声明

本项目是社区作品,非 DeepSeek 官方出品。DeepSeek Harness 目前处于 developer preview 阶段,后续可能有破坏性变更。本项目基于 MIT 协议开源,使用中遇到的问题请优先查阅官方文档。

相关链接

- DeepSeek Harness 官方仓库:https://github.com/deepseek-ai/deepseek-harness
- API 控制台:https://platform.deepseek.com
- 项目 Topics:dsh-plugin、dsh、deepseek-harness、windows、electron、desktop

📖 完整文档站点(即时中英文切换)→ https://github.com/SnowCrescenter-tech/dsh-desktop/tree/main/website

这是什么?

DeepSeek Harness 是 DeepSeek 官方的智能体框架。官方构建仍处于开发者预览阶段:手动搭建意味着要安装 Node 22.19+ 或 Node 24、pnpm,以及一系列命令行步骤。对大多数人来说,这个门槛太高了。

dsh-desktop 将 DeepSeek Harness Web UI 封装进一个原生 Windows 桌面应用。界面本身没有改动,只是套上了一层更友好的外壳:应用驻留在系统托盘,窗口拥有自己绘制的标题栏,通知采用标准 Windows 样式,并且同一时间只能运行一个实例。下载、安装、双击,搞定。

一览

| 功能 | 作用 |
| 无边框窗口 | 绘制的 36px 标题栏,带实时状态圆点 |
| 系统托盘 | 驻留在托盘中;单击即可唤回 |
| 原生通知 | 标准 Windows 通知样式,托盘气泡作为后备 |
| 单实例 | 同一时间只运行一份;再次启动会将其唤到前台 |
| 开机启动 | 可选,登录后在后台启动 |
| 首次运行引导 | 粘贴一次 API 密钥;它只保存在你的机器上 |
| 端口 0 自动分配 | Windows 在每次启动时挑选一个空闲端口 |
| 自动更新 | 后台下载;重启以应用 |

功能

- ▭ 无边框窗口:没有系统边框。36px 标题栏由应用绘制,并带有实时状态圆点:本地服务运行时为青色,启动中为灰色,出错时为红色。在 Windows 11 上,圆角由 DWM 原生提供。
- ▣ 系统托盘:应用驻留在托盘中。单击可唤回窗口;右键打开菜单:打开主窗口、开机启动(复选框)、关于、退出。
- ◈ 原生通知:提醒采用标准 Windows 通知样式,就像任何普通应用一样,在缺少原生支持的地方以托盘气泡作为后备。
- ◎ 单实例:同一时间只运行一份。再次双击只会将现有窗口带到前台。
- ↻ 开机启动:可选,登录后在后台启动,由 Windows 注册表 Run 键支持。
- ▤ 首次运行引导:首次启动会显示一个引导对话框,要求输入你的 DeepSeek API 密钥。密钥只保存在本机,位于 /.env。
- ⇄ 端口 0 自动分配:服务在每次启动时向 Windows 请求一个空闲端口(--port 0),因此它永远不会与端口 3080 或任何其他程序冲突。
- ↑ 自动更新:已安装(NSIS)版本会在启动后不久静默检查新版本,并在后台下载。准备就绪后,会出现一条原生通知,托盘菜单会显示“重启并更新”;选择它即可重启并应用。便携版 zip 没有安装程序,因此其“检查更新”会打开 GitHub Releases 页面。

快速开始

1. 从 Releases 页面获取最新安装程序。
2. 安装,然后双击桌面上的 DeepSeek Harness 图标。
3. 首次启动时,将你的 DeepSeek API 密钥粘贴到设置对话框中。主窗口会自动打开。

应用会启动服务并为你打开主窗口。无需手动操作。

首次运行:底层发生了什么

首次启动是一个编排好的流程。如果尚未配置 API 密钥,会弹出一个模态对话框要求输入。配置文件会写入磁盘,捆绑的 CLI 会以 --profile desktop --port 0 启动,然后 supervisor 会等待就绪行(dsh web: http://127.0.0.1:)。一旦解析完成,Web UI 就会加载到内容视图中,状态点变为青色。

1. 获取单实例锁。第二次启动只会将现有窗口带到前台。
2. 如果尚未配置 API 密钥,引导对话框会要求输入一个,并将其保存到 /.env。
3. 将 desktop 配置文件写入磁盘,然后启动捆绑的 CLI:dsh --profile desktop --port 0。
4. 等待就绪行(dsh web: http://127.0.0.1:)。一旦解析完成,Web UI 就会加载到内容视图中,状态点变为青色。如果超时,则会显示带有重试按钮的错误视图。

首次启动:设置你的 API 密钥

首次运行会显示一个设置对话框,你可以在其中输入你的 DeepSeek API 密钥:

1. 前往 https://platform.deepseek.com 并登录。
2. 在 API Keys 页面点击“Create”以获取一个形如 sk-... 的密钥。
3. 将密钥粘贴到对话框中,点击保存,然后主窗口就会打开。

你的密钥只存储在你自己的机器上。它绝不会被上传到任何地方。

工作原理

dsh-desktop 是一个 Electron 外壳。主进程负责窗口、托盘、通知、自动启动以及运行时 supervisor,后者会启动并监视捆绑的 DeepSeek Harness CLI。一个 preload 桥向渲染器暴露了一个小型、冻结的 window.dshDesktop API。窗口自身的 web contents 绘制标题栏,其下方一个沙盒化的 WebContentsView 承载 DeepSeek Harness Web UI,后者运行在 desktop 配置文件上:@deepseek-ai/dsh-base、@deepseek-ai/dsh-web-app 和 @dsh-desktop/client。

FAQ

杀毒软件警告或 SmartScreen 提示?

打包的桌面应用没有代码签名。首次运行可能会触发 Windows SmartScreen 的“Windows 已保护你的电脑”消息,某些杀毒工具也可能误报。这对于打包软件来说是正常的,并不是出现问题的迹象。

- SmartScreen:点击“更多信息”,然后点击“仍要运行”
- Windows Defender:病毒和威胁防护 → 排除项 → 添加排除项
- 360 安全卫士:木马查杀 → 信任区 → 添加信任目录
- 火绒安全:防护中心 → 病毒防护 → 信任区 → 添加文件/目录
- 腾讯电脑管家:病毒查杀 → 信任区

我可以将它安装到包含中文字符的路径中吗?

可以。桌面应用不依赖命令行脚本,因此它在包含中文字符的路径下也能正常工作(例如 软件\DeepSeek Harness)。

端口已被占用?
服务监听系统分配的端口(端口 0),因此 Windows 会在启动时选择一个空闲端口。它绝不会与端口 3080 或任何其他程序冲突,也无需手动配置。

为什么我关闭窗口后应用仍在运行?

默认情况下,关闭窗口会最小化到托盘,应用会继续在后台运行。从托盘菜单中选择“退出”即可完全退出。

如何更新到新版本?

已安装的版本会在启动后自动在后台检查更新。当新版本准备好时,会出现通知。从托盘菜单中选择“重启并更新”(或直接重启应用),更新会在退出时应用。你也可以随时使用托盘菜单中的“检查更新”项。便携版 zip 没有自安装程序:“检查更新”会打开 GitHub Releases 页面,你在那里下载最新的 zip 并替换旧文件夹。

如何在中英文之间即时切换?

本 README 是一个单文件双语文档。顶部的 🇨🇳 中文 和 🇬🇧 English 标签可直接跳转到你想要的章节,无需重新加载页面,也没有单独的文件。如需完整的交互体验(即时语言切换、深色模式、搜索),请使用文档站点:https://github.com/SnowCrescenter-tech/dsh-desktop/tree/main/website

我需要付费吗?

该软件免费且开源,但 DeepSeek API 是按用量付费的。当前参考价格(每百万 token):deepseek-v4-flash 输入 $0.14 / 输出 $0.28;deepseek-v4-pro 输入 $0.435 / 输出 $0.87;缓存命中的输入要便宜得多。权威列表请见 https://api-docs.deepseek.com/quick_start/pricing。自 2026-08-16 起,计费将切换为高峰/非高峰定价。

技术说明

- 使用 Electron 43 和捆绑的 Node 运行时(v24.19.0)构建。
- 通过 @deepseek-ai/dsh@0.1.0-rc.6 运行 Web UI。
- 数据和你的 API 密钥位于 %USERPROFILE%\.dsh 下(可通过 DSH_HOME 环境变量覆盖)。
- desktop 配置文件按顺序挂载:@deepseek-ai/dsh-base → @deepseek-ai/dsh-web-app → @dsh-desktop/client。
- 标题栏、托盘和引导界面遵循基于 DeepSeek 品牌调色板(强调色 #4D6BFE、深墨色 #10131A、纸色 #F4F6F9)构建的极简、平静的设计语言。

免责声明

社区项目,并非 DeepSeek 官方产品。DeepSeek Harness 处于开发者预览阶段,可能会在不另行通知的情况下发生变化。本项目采用 MIT 许可证。遇到问题时,请先查阅官方文档。

链接

- 官方仓库:https://github.com/deepseek-ai/deepseek-harness
- API 控制台:https://platform.deepseek.com
- 主题:dsh-plugin, dsh, deepseek-harness, windows, electron, desktop
预览分享卡片长什么样 ↓SnowCrescenter-tech/dsh-desktop
分享 · DeepSeek Harness Hub
SnowCrescenter-tech/dsh-desktop

双击即用,把 Harness 装进 Windows 原生窗口

回到顶部