/>
dsh-desktop 社区版
EN GitHub 立即下载

DeepSeek Harness
桌面版,可靠的 本地桌面应用。

社区维护的 DeepSeek Harness 桌面版:开箱即用。自带运行时、独立数据目录、桌面入口和恢复路径;只增强桌面体验,不改写 Agent 与模型逻辑;对内核仅有两处受版本约束的窄补丁(会话回收站、登录弹窗兜底),见更新日志。

… · macOS / Windows / Linux · 无需 Node.js

插件市场 社区插件,按需安装 不进安装包,先装市场再由你选择。
账户余额 托盘里直接查看 有可用 API Key 时,在托盘与桌面设置中显示。
CORE VERSION … 内置内核,更新失败可回到稳定版本。
真实应用截图 桌面工具,始终可达
浅色 / 深色
dsh-desktop 扩展控制面板(浅色主题) dsh-desktop 扩展控制面板(深色主题)
LOCALLoopback 本地运行
ISOLATED默认独立数据目录
GUARDED沙箱隔离,权限默认最小
VERIFIABLE公开 CI 与真实应用测试

02 / 产品定位

官方 Harness,原样跑进桌面窗口

桌面壳负责安装、启动、恢复和入口;Agent、会话、工具、模型仍由官方 Harness 负责。

01

开箱即用

内置 Node.js 与依赖,安装后直接启动。

02

本地且隔离

默认只在本机通信;只有你主动开启局域网代理时才会监听局域网;数据默认放在独立的 ~/.dsh-desktop。

03

出错可恢复

安全模式隔离坏插件;错误页可一键升级或禁用可疑插件。

桌面壳负责

  • 窗口、托盘、快捷键与通知
  • 运行时封装、进程守护与更新
  • 安全模式、诊断与权限边界

Harness 继续负责

  • Agent、会话、工具与模型
  • 官方 WebUI 与插件行为
  • 账户配置与官方设置

扩展功能

扫码,把 Harness 带到手机或平板

从「桌面工具」启动局域网 Web 代理,手机与电脑同网后扫码即可进入 Harness。

不需要单独的 Android / iOS 应用。

打开「设置 → 飞书连接」或「桌面工具 → 连接 → 飞书连接」:扫码保存应用后再显式开启 cc-connect,可编辑降噪设置、关闭连接或移除本地配置。

FEISHU / CC-CONNECT

在飞书里,把任务交给这台电脑

内置 cc-connect 将机器人消息交给本机 Harness,在选定工作区执行任务。电脑和 Desktop 需要保持运行;飞书使用长连接,不需要公网 IP,也不必开启局域网共享。

01

扫码创建,保存应用

打开「设置 → 飞书连接」或「桌面工具 → 连接 → 飞书连接」,原「扩展 → 管理飞书连接」及桌面设置入口仍可用。扫码授权后,等 Desktop 显示凭据已收到,再保存具名应用;已有应用也能手动添加。

02

选工作区,显式开启

可保存多份配置,但一次只连接一个应用。先在 Harness 模型设置中配置模型凭据,再开启连接;“服务已启动”“飞书在线”和“任务完成”是不同状态。

03

少刷消息,随时关闭

默认精简消息、3 秒流式预览;可选择完整/精简/静默、经典/富卡片和进度展示。在同一窗口关闭连接、设置启动时自动连接或移除本地配置。

关闭管理窗口或最小化不影响连接;关闭主窗口会退出并停止服务,安全模式也会暂停连接。macOS Secret 使用 0600 受限明文文件,旧加密凭据需重填一次;Windows 策略不变。移除本地配置不会删除远端飞书应用,组织仍管理权限、可用范围和发布。

03 / 社区插件

社区插件市场,全部由你选择

dsh-desktop 只提供清晰入口和故障恢复支持;社区插件不属于安装包,也不会在首次启动时自动出现。

PLUGIN MARKET

全部按需安装

安装包不内置社区插件;先手动安装 dsh-market,再由你选择其他插件和主题。

浏览与一键安装在 Harness「设置 → 插件市场」按分类浏览、安装和更新。
装坏了也不怕插件装坏时,错误页可直接升级到最新版或先禁用;安全模式随时兜底。

如何安装:按需在「设置 → 桌面设置 → 插件市场」手动安装 dsh-market,再到 Harness「设置 → 插件市场」手动选择其他插件;首次任务不依赖插件市场。

04 / 下载

选择你的平台

支持 macOS、Windows 和 Linux;具体以当前版本可用安装包为准。GitCode 镜像可用时与 GitHub 并列展示。

RELEASES …

版本数据加载失败时,可直接前往 GitHub Releases 或 GitCode 镜像 下载。

打开独立下载页:查看平台说明、GitHub Release、GitCode 镜像与校验方法。

$ npx @deepseek-ai/dsh web

命令行方式同样可用;桌面壳的 Agent 行为与命令行一致,但使用独立数据目录 ~/.dsh-desktop,互不干扰。

当前版本重点

Harness 0.2.2-alpha.2:内核跃迁与权限边界复审

内置 Harness 升到上游 0.2.2-alpha.2(内核升级使壳修订归零):manifest pin 与 32 个内核包 peer 同步、发行年龄豁免按新内核重新固定、闭包锁文件重生成后重新部署;两处维护补丁都在新内核上重新落地并登记复核。同时修复了语音输入在桌面端无法录音的问题,并逐项复审了渲染层的权限边界。

  • 内核兼容:账号授权弹窗与 onboarding 守卫补丁按新版源码重新生成;会话回收站补丁完成上游复审(两个被改 bundle 的上游 diff 共约 5100 行,所有生命周期锚点仍唯一命中,会话创建拆到新的 SessionCommandController,委托改挂在字节相同的 resolveAgent 上),新内核已登记进已复核清单。
  • 语音输入:录音走 getUserMedia({ audio }),此前被默认拒绝的权限边界按 media 整体拒掉,已发布的麦克风按钮只会报权限错误;现在只放行音频——摄像头永远拒绝——并补上 macOS 的麦克风用途声明,首次录音仍由系统逐应用授权。
  • 权限复审:把内置闭包里所有需要权限的 Web API 逐个核对,只有剪贴板写入与麦克风被已发布界面使用;clipboard-read 的两个调用点分别是 xterm 的能力探测与带内部剪贴板回退的显式粘贴,通知、全屏、指针锁、屏幕捕获等继续拒绝。查看完整更新日志 →

05 / 桌面能力

你得到的是可靠入口,不是功能堆叠

01

开箱即用

把最容易卡住的运行环境和数据边界处理好,下载后直接进入 Harness。

无需安装 Node.js

内置 Node.js 与锁定依赖,下载安装包即可启动。

独立数据目录,环境隔离

默认使用 ~/.dsh-desktop,不影响命令行;需要共享时再设置 DSH_HOME。

02

日常桌面体验

窗口、托盘、快捷键和通知服务于同一个目标:随时找到并继续你的 Harness。

持续守护与可靠更新

崩溃按预算重启,保留托盘入口;更新失败会回到可用内核。

不用找窗口,快捷键直接唤回

默认 Ctrl/Cmd + Shift + Space,冲突时仍可用托盘和右键。

03

恢复与边界

故障时给出可执行的下一步,同时把权限、数据和上游职责说清楚。

渲染层能力默认收敛

沙箱、上下文隔离和权限拒绝默认开启,桌面通知不读取屏幕。

问题发生时,可检查并恢复

日志和诊断报告在本地生成,自动遮罩常见密钥,不会自动上传。

06 / 支持与边界

先恢复,再反馈;每一步都有入口

macOS 提示“无法打开,因为无法验证开发者”?

当前 macOS 安装包尚未签名公证,首次启动请 右键 → 打开。如果仍没有放行选项,且你确认安装包来源可信,可在终端执行:
xattr -dr com.apple.quarantine "/Applications/dsh-desktop.app"open "/Applications/dsh-desktop.app"这会移除下载隔离标记,但不会添加 Apple 签名或公证。

安装包由公开 CI 构建,可用来源证明验证真伪:
gh attestation verify /path/to/dsh-desktop-{ver}-arm64-mac.dmg -R citrusli2026/dsh-desktop

Windows SmartScreen 拦截怎么办?

当前 Windows 安装包尚未做代码签名。点击 “更多信息” → “仍要运行” 即可。安装包由 GitHub Actions 从公开源码构建,可全程审计;也可用以下命令验证来源:
gh attestation verify /path/to/dsh-desktop-setup-{ver}.exe -R citrusli2026/dsh-desktop

这和 DeepSeek 官方是什么关系?

社区维护的桌面封装:不改写 Agent 与模型逻辑,数据与配置保持独立;随包内核带两处受版本约束的窄补丁(会话回收站、登录弹窗兜底),其余与上游逐字节一致。项目与 DeepSeek AI 无隶属、授权或合作关系;DeepSeek Harness 是 DeepSeek 的商标,本项目仅在 MIT 许可下再打包 @deepseek-ai/dsh。

我在用 npx @deepseek-ai/dsh web,配置会带过来吗?

不会——桌面版是独立环境,数据放在 ~/.dsh-desktop,与 CLI 的 ~/.dsh 互不影响。想沿用 CLI 配置,启动前设 DSH_HOME=~/.dsh 即可。

桌面版会申请摄像头、定位或文件系统权限吗?

不会。当前功能不需要这些 Electron Web 权限,桌面版默认拒绝摄像头、定位、网页通知、屏幕采集和文件系统这类请求;桌面通知是可关闭的本地功能,不读取屏幕,也不上传数据。

如何校验下载文件的完整性?

每个安装包都附带同名的 .sha256 校验文件。下载后可用以下命令验证:
shasum -a 256 -c dsh-desktop-{ver}-arm64-mac.dmg.sha256
Windows 用户可用:
CertUtil -hashfile dsh-desktop-setup-{ver}.exe SHA256
Linux 用户可用:
sha256sum -c dsh-desktop-{ver}-amd64.deb.sha256(arm64 机器把 amd64 换成 arm64)
校验值应与 .sha256 文件内容一致。需要批量校验时,仓库里提供了 bin/dsh-validate-release.mjs <目录> <tag>(需 clone 仓库运行)。

客户端带插件吗?怎么装更多插件?

dsh-desktop 安装包不内置社区插件,所有插件都需要用户手动安装。需要时在 设置 → 桌面设置 → 插件市场 手动安装 dsh-market;装好后打开 Harness「设置 → 插件市场」即可浏览和安装。首次任务不需要插件市场;安全模式会隔离所有第三方插件。

启动失败或插件装坏了怎么办?

应用仍可打开时,先到「设置 → 桌面设置 → 运行体检」查看本地运行环境、数据目录、本地端口与插件状态;联网检查需单独勾选,结果不上传也不自动修复。无法启动时,错误页提供「再次启动」「以安全模式启动」「打开日志目录」「导出诊断报告」;检测到可疑插件时还会逐个列出,可直接「升级」到最新版或「禁用」后重启——禁用只从启动列表移除,不删除文件,可随时在「设置 → 插件」恢复。

误删的会话或文件还能找回吗?

可以。桌面版自带垃圾桶:删除的会话、预设都会先进入垃圾桶,在 「设置 → 垃圾桶」 中随时还原。Agent 执行的删除类命令也会被拦截:目标先移入垃圾桶,可疑的删除会被直接拦截并说明原因。垃圾桶保留 30 天,过期自动清理。

07 / 版本信息

版本号怎么读

…
…

内核版本 —— 内置的 @deepseek-ai/dsh 版本,跟随官方更新,新版本会尽快跟进。

…

桌面版修订号 —— 同一内核下,桌面版自身(窗口、更新、修复)的更新次数。