dsh_desktop

DeepSeek Harness (dsh) Windows desktop client - bundled Node.js + dsh CLI, one-click launch

Automatically checked · GitHub checked 2026-11-17

Overview

DSH Pack

把 DSH 里最好用的一批插件,做成一个开箱即用的桌面客户端。

不是一个「只换皮」的 DSH 壳:我们替你挑插件、调兼容、做整合、压进一个安装包。 装好即用——不用装 Node.js,不用逐个找插件,也不用为版本冲突折腾。

Release Downloads Stars Issues License Platform Release CI

English · 最新版 v1.1.0(2026-11-13)

[!NOTE] v1.1.0 = 内核换代 0.2.2-rc.2 → 0.2.2-rc.3 + 便携版补全内置 Node:Rust 壳与界面零功能改动, 在册插件仍是 33 条。顺带修掉 v1.0.10 的一个缺口——两个便携包当时逐字节相同(内置 node.exe 没进包), 现在 Full 自带 Node、Lite 真的更小。 随包交付完整 dsh 运行时 + 33 个精选伴随插件,架构是 Tauri 2 + 内置 Node:包更小、启动更快, 坏插件 / 坏配置也永不白屏打不开。完整改动见 Release 说明。

目录:为什么是它 · 界面 · 快速开始 · 内置插件 · 常见问题 · 社区 · 赞助 · 开发与构建 · 发布与架构


✨ 为什么是「插件整合包」

DSH 的插件生态很好,但「好」和「装好就能用」之间隔着选型、兼容、版本、配置四道墙。 DSH Pack 把这件事做完:精选,整合,随包交付。

精选,而不是堆积

  • 33 个伴随插件,逐个选过 — 不以数量取胜:每个内置件都经过宿主兼容验证、许可核对和真机启动检查, 清单、上游与判定记录在 内置插件清单。
  • 一个安装包,一套完整体验 — Bot 团队与群聊(DeepSeek-Bot)、文件工作台(Better Sidebar)、 免费多引擎搜索(Free Search)、插件商店、提示词优化、会话地图、桌面通知、MCP / 技能工具箱、 余额与费用、会话归档、峰谷价格卫士……装完即齐。
  • 上游可追溯 — 每个随包插件都标注来源仓库、版本与许可证;第三方许可见 THIRD_PARTY_NOTICES.md,兼容性判定与实测证据见清单 §五。

开箱即用

  • 零环境依赖 — 内置独立 Node 运行时与 npm CLI,目标机器不需要安装 Node.js / pnpm。
  • 完整 dsh,离线可用 — 打包官方 @deepseek-ai/dsh 与官方插件全集,断网也能启动。
  • 双击即用 — 自动复用上次端口,内核就绪后载入原生窗口;提供安装版与便携版两种形态。
  • 客户端级更新 — 右上角 ⋯ 一键检查并安装更新,双源 GitHub / Gitee 自动切换, sha256 fail-closed 校验;内核随客户端整体分发,没有第二条独立更新链。

桌面体验

  • Tauri 2 原生壳 — 深色玻璃无边框窗口、自绘标题栏、Win11 圆角,关闭默认驻留托盘。
  • 文件工作台 — Better Sidebar 把资源管理器、编辑器、Diff 与「在本地打开」接进右栏, 折叠 / 展开与快捷键都按桌面习惯重做。
  • Bot 团队 — DeepSeek-Bot 把主 Bot、长期 Bot 和群聊装进同一个客户端: @ 转交、群共享记忆、能力库与用量页,适合把 DSH 当成长期协作工作台。
  • 通知与余额 — dsh-notify 接管回合完成 / 审批 / 出错通知,点击回到对应会话; 对话底部实时显示「本轮费用 · 余额」。

工程韧性

  • 守护瀑布 — 内核 boot 链逐级自愈:坏插件自动修复、坏配置自动重建、内核崩溃环原地重启, 任何不兼容形态都不退出。
  • 崩溃自愈 — 渲染层假死心跳检测自动重载;内核由 supervisor 探活 + 指数退避拉起。
  • 数据不动 — 升级覆盖安装保留 profile 与会话;插件启停只改补丁层配置,不碰用户数据。

📸 界面一览

DSH Pack 界面

开箱即用(原生 dsh web)vs DSH Pack:

能力原生 dsh webDSH Pack
启动手动安装 Node.js、敲命令双击即用,内置独立运行时
界面浏览器标签页桌面原生窗口 · 深色玻璃无边框
插件自己逐个找、装、调兼容33 个精选插件随包交付,统一查看 / 启停 / 更新
会话管理仅归档归档 / 恢复 / 删除 + 会话地图
余额无实时「本轮费用 · 余额」+ OpenCode Go
桌面能力无托盘常驻 / 原生通知 / 文件工作台 / Bot 群聊
更新手动客户端双源更新链(GitHub/Gitee + sha256 校验 fail-closed)

🚀 快速开始

系统要求:Windows 10 / 11、macOS 12+(Apple Silicon)、Linux x64。 安装版与便携版 Full 都自带 Node 运行时,目标机器无需预装 Node.js。

到 Releases 下载(下表 <版本> 为发布号,当前是 1.0.10):

平台产物说明
💻 Windows x64DSH-Desktop-Setup-<版本>-win-x64.exe主推。NSIS 安装包,currentUser 模式免管理员,内嵌 WebView2 引导器,离线机器也能装 · 约 306 MB
🎒 Windows x64 便携DSH-Desktop-Portable-<版本>-win-x64.zip解压即用,数据存 exe 旁 data\,自带 Node · 约 571 MB
🪶 Windows x64 便携 LiteDSH-Desktop-Portable-<版本>-win-x64-lite.zip同上但不含内置 Node,需本机已有 Node ≥ 22;比 Full 小约 33 MB
🍎 macOS 12+DSH-Desktop-<版本>-macos-arm64.dmgad-hoc 签名、未公证,首次打开需右键 → 打开(见 FAQ) · 约 542 MB
🐧 Linux x64DSH-Desktop-<版本>-linux-x64.AppImage / dsh-desktop_<版本>_amd64.deb· 约 416 / 462 MB
🧪 Windows arm64DSH-Desktop-Setup-<版本>-win-arm64.exe实验线,能用但不保证

每个产物都带同名 .sha256 边车文件;担心下载被篡改就先校验再运行。

安装版还是便携版

  • 安装版(Setup)— 推荐。装进 %LOCALAPPDATA%,有开始菜单与卸载项,覆盖安装会装回原目录。
  • 便携版(Portable)— 解压即用、不写注册表,适合放 U 盘或临时机器。
  • Lite 版只省掉内置 Node,其余完全相同;本机已有 Node ≥ 22 才选它,否则会报「未找到可用的 Node.js」。

第一次启动

  1. 启动后壳会跑一遍 boot 链:修复 → 同步内置插件 → 打补丁 → 内核预检 → 拉起内核。
  2. 内核就绪后载入客户端;从安装包 assets/plugins 镜像 33 个精选插件进 profile。
  3. 之后在「设置 → 插件 → 内置插件」里逐条查看版本、启停、检查更新。

数据在哪

数据位置
客户端设置、窗口状态、日志Windows 安装版 %APPDATA%\dsh-desktop\ · 便携版 exe 旁 data\ · macOS ~/Library/Application Support/dsh-desktop/
会话、附件、插件 profile、API 凭据<DSH_HOME>,默认 ~/.dsh,可用环境变量 DSH_HOME 改(三种形态同一套)

设置环境变量 DSH_HOME 可强制指定 dsh 配置目录——便携版想让「数据随 exe 走」,把它指到 data\ 下即可。 升级与覆盖安装不会动这些数据。 完整的数据实践(收集什么、什么时候联网)见隐私政策。

🧩 内置插件生态

内置伴随插件在册共 33 个(v1.0.0 起插件源整树进安装包,装机后首次开机由 boot 的同步链镜像进 profile,开箱可用)。下表按 scripts/lib/companion-plugins.js 的在册顺序逐名列出,包名与版本取自各插件 package.json 实值;「来源 / 许可」列只到「包内自己怎么说」这一层,逐条原仓库可达性与许可原文实测见 内置插件清单 §三,逐条对 0.2.2-rc.2 宿主的兼容判定见 §五:

插件(包名)版本说明来源 / 许可
@deepseek-ai/dsh-balance0.2.0账户余额 + 本轮会话费用估算(挂在对话统计栏 dock)自研 · MIT
@deepseek-ai/dsh-file-changes0.1.0会话文件更改投影(折叠 tool/result 的 meta.diffs)自研 · MIT
dsh-better-sidebar0.24.2VSCode 式右栏:editor / git / subagent / sidechat / diff 五个内置标签,并向其他插件开放标签注册服务omdsh-dev/DSH-better-sidebar · MIT
dsh-session-manager0.1.0会话行删除按钮 + 设置内「归档对话管理」面板(恢复 / 删除)自研 · MIT(包名撞社区已发布包)
@deepseek-ai/dsh-conversation-tweaks0.1.1隐藏长篇对话输出 + 会话右侧导航滑轨自研 · MIT
@dsh-external/dsh-super-injector0.3.1运行时注入任意本地插件包(不重启)+ 热重载 + 设置页插件管理 UI@dsh-external 社区 · BSD-3-Clause(仅 manifest 自标,无许可原文可引)
@deepseek-ai/dsh-prompt-custom0.5.0在设置页自定义官方注入的系统提示词(整体替换 / 追加),提示词卡即切即用:点芯片切换、正文写回当前卡自研 · MIT
@deepseek-ai/dsh-workspace-anchor0.1.1把当前工作目录写进稳定系统提示的锚点块,防 agent 工作目录漂移(0.2.1 起内核不再注册 {{cwd}} 变量,锚点由插件自己填实路径)自研 · MIT
@deepseek-ai/dsh-wsl-settings0.1.0设置页「WSL 后端」栏:local↔wsl 切换、发行版与安装目录、状态探活自研 · MIT
ds-bot0.2.0Bot 团队:主 Bot + 长期 Bot + 群聊,Bot 间 @ 转交与共享记忆,开箱即用的协作工作台(loader id bot)Fei2411/DeepSeek-Bot · Apache-2.0
billion-context0.1.213上下文压缩(上游统一版):模型驱动压缩 + 4 个模型工具与 /acp-prune 命令,另带 preset 级 compaction gateranxianglei/billion-context · MIT
dsh-pocket2.12.0手机扫码实时同屏操控桌面 web(WebSocket 透传 + 公网隧道 + 二维码配对)shaobeichen/dsh-pocket · GPL-2.0
@deepseek-ai/dsh-openclaw-bridge0.8.1微信 / 飞书官方频道桥接入 DSH agent 会话(分片回写、去重限流)hzhz314159/openclaw-dsh-bridge · MIT
dsh-input-history0.1.1输入框 ↑/↓ 终端式已发送消息回溯(按会话隔离)自研 · MIT
dsh-easyrewrite3.0.1消息撤回 / 重编辑 + 版本翻页器 + 自带设置中心Renzic-Stone/DSH-EasyRewrite · MIT
dsh-change-review0.1.2AI 变更审核:让模型复查自己刚做的改动(正确性 / 安全性 / 目标一致性)自研 · MIT
dsh-offpeak1.0.1峰谷价格卫士:高峰时段拦截发送提醒,可定时到低价时段自动执行christophersmith2737-commits/OffPeak · MIT
dsh-settings-nav-custom0.1.1设置页左侧导航项显示 / 隐藏与排序(localStorage 持久化)EAC 移植 DSH-EAC/EAC-Desktop · MIT
dsh-settings-groups0.1.1把设置「常规」页低频选项收进底部可折叠「高级选项」组自研 · MIT
dsh-synapse0.3.1非线性对话画布:同工作区的会话 / 追问 / 分支可视化拖拽liangmianya/dsh-synapse · MIT(本地分叉线,不取上游 0.4.2)
@dsh-external/dsh-subagent-lens0.1.1Task/subagent 展开式活动视图 + 会话头部命令/文件聚合条(零额外后端请求)自研 · MIT(借 @dsh-external 作用域,名下无仓库)
dsh-basics-panel0.4.2设置页可视化并管理 MCP 服务器 / 技能 / 规则 / 归档会话yxsj245/dsh-Basics-Panel · MIT
dsh-input-fold0.1.1超长用户提示词默认折叠为前几行 + 「展开」遮罩自研 · MIT
dsh-prompt-optimizer3.0.0输入框旁一键分析并优化草稿(SSE 流式上屏;默认实时复用当前会话模型;无上下文走结构模板、有上下文提炼目的顺势润色;保真自检、斜杠命令前缀保护;结果可替换/撤回/复制;设置页可配模型、调用参数与上下文)Y1X1n/dsh-prompt-optimizer · MIT
dsh-builtin-manager0.2.1「设置 → 插件」里的内置插件页:搜索 / 状态筛选 + 单列表逐条查看随包内置件并启停(行内反馈;启停下次启动生效)自研 · MIT
@deepseek-ai/dsh-goal-completion0.1.0内核右栏「目标收尾」标签页:当前会话目标的状态机 + 官方 GoalBar 没有的 complete(标记完成,两次点击确认)自研 · MIT
dsh-free-search0.9.39免费多引擎搜索:注册 ctx.web 搜索 provider,内置 web_search 自动选用(loader id 是 web-search-free,不是包名)DDDMUC/dsh-free-search · MIT
dsh-plugin-shop0.9.3插件商店:浏览 / 安装 / 启停 / 更新 dsh 插件(loader id 是 shop,客户端 bundle id 才是包名)LivXue/dsh-plugin-shop · Apache-2.0
@local/dsh-network-proxy1.0.4设置「通用」里的 HTTP 代理行:读系统代理并热切换 fetch dispatcher(包名保留上游 @local/*,改名会让更新回来的行对不上)baizhizzl/dsh-network-proxy · MIT
dsh-toolbox-ui1.10.1MCP / 技能工具箱:右下悬浮面板,MCP 市场与技能管理(loader id 是 mcp-manager-ui;宿主半边静态导入 smol-toml)Imzl-zl/dsh-toolbox-ui · MIT
@bittersmilezzz/dsh-notify0.4.5桌面通知:渲染进程 Web Notification 六类事件 + 点击回会话,v1.0.7 起取代壳层「回合完成」通知bitterSmilezzz/dsh-notify · MIT
dsh-context0.83.0上下文透视:右栏上下文看板 + /context 命令,拆解当前上下文由什么构成、如何随轮次演变bowenliang123/dsh-context · Apache-2.0
ds-harness-remote0.6.4端到端加密远程访问:桌面 / Web / 安卓远控本机 DSH,含 dsh-TUI Host 支持(内层依赖树随包分发,WebRTC 走纯 JS werift)liguobao/ds-harness-remote · MIT

清单变更史(新增 / 退役的逐条理由、上游可达性与许可原文)在 内置插件清单,这里只留一行摘要: v1.0.0 由 39 精简到 28;2026-11-08 移除 quest-ui / auto-compact / zcode-migrate 三件;2026-11-09 新增 dsh-context 与 ds-harness-remote 并升 8 件到 npm latest; 上下文压缩件同日整体换成上游统一版 billion-context。退出清单的插件源已从 assets/plugins/ 删除,老装机机器的注册行与 profile 镜像由 RETIRED_COMPANIONS 在下次开机回收。

❓ 常见问题

装完打不开、或者卡在加载页? 壳有恢复页兜底:点「以安全模式重启」会停用全部内置插件(dsh-builtin-manager 与压缩件除外)再启动, 进去后逐个开回来即可定位是哪一个。日志在 %APPDATA%\dsh-desktop\logs\desktop.log(macOS 在对应数据目录下)。

macOS 提示「已损坏,无法打开」? 不是包坏了,是未公证的 Gatekeeper 拦截。任选其一:右键 app → 打开 → 再点「打开」; 或终端 sudo xattr -cr "/Applications/DSH Pack.app";或系统设置 → 隐私与安全性 → 「仍要打开」。 每次覆盖安装后需重做一次。

需要先装 Node.js 吗? 安装版与便携版 Full 不需要(内置独立 Node 运行时与 npm CLI)。只有便携版 Lite 需要本机 Node ≥ 22。

覆盖安装会丢数据吗? 不会。安装器会定位旧目录、装回原位置,并保留 profile、会话与插件配置。

为什么没提示更新? 更新器轮询的是 releases/latest,只有正式版才进 latest。预发布版(prerelease)是刻意不推送的, 想尝鲜可在「设置 → 更新渠道」切到开发版。

Gitee 上的版本是不是更新不及时? v1.0.0 起不再向 Gitee 同步代码与发布资产,Gitee 上的历史版本仅作存档,请以 GitHub Releases 为准。

💬 社区交流

遇到问题、想反馈建议或与其他用户交流?欢迎加入 QQ 交流群(群号 926561802):

QQ 交流群

☕ 赞助支持

赞助支持:Infistar,多模型 API 服务,不构成技术推荐。

🛠 开发与构建

前置:Rust 工具链 + dsh-desktop/ 已 npm ci(内核 payload 源,postinstall 会自动装内核并打补丁)。

# 测试(当前基线:Rust 607 / sidecar 21 / Node 2253)
cd dsh-desktop && npm test
cd ../dsh-tauri && cargo test --workspace && node --test sidecar/cli.test.js

# 开发运行
cd dsh-tauri/src-tauri/src/app && cargo run

# 打包 win-x64 NSIS 安装包 + 安装态冒烟
bash dsh-tauri/scripts/stage-payload.sh
cd dsh-tauri && npx --yes @tauri-apps/cli build \
  --config src-tauri/src/app/tauri.conf.json --target x86_64-pc-windows-msvc
bash dsh-tauri/scripts/smoke-installed.sh

完整流程、调试开关与补丁体系见开发手册; 贡献前请读 CONTRIBUTING.md,代码、文档与 commit message 一律中文。

📦 发布与维护

这一节是维护者向的内容,普通用户可以跳过。

发布

唯一发布入口是推 v* tag → tauri-release.yml: 三平台构建(Windows NSIS / 便携版、Linux AppImage / deb、macOS dmg)→ 版本 / 测试 / 路径门禁 → 汇总并校验 7 个资产 → 发布 Release。版本号三处同步(dsh-desktop/package.json、 Cargo.toml 的 workspace.package.version、tauri.conf.json),漏改直接 fail-fast。 发布正文取自 .github/release-notes/v<版本>.md,发版前先写这个文件。

预发布版不进 GitHub releases/latest,而壳侧更新器轮询的正是 latest —— 因此预发布不会被自动推给 稳定版用户,这是刻意设计。完整流程、转正与回滚见 发布 Runbook。

架构

v0.5.0 起为 Tauri 2(Rust)架构——Electron 壳已退休,其全部职责(窗口 / IPC / 更新 / 打包)由 Rust 侧逐 crate 复刻,契约先行(dsh-tauri/contracts/ 六份硬契约为接口唯一事实源):

┌──────────────────────────────────────────────────────────┐
│  Tauri 2 壳(Rust · 7 个单向依赖 crate + 装配根)          │
│  · supervisor:boot 守护瀑布 → spawn 内核 → 就绪换页       │
│    → 探活 → 崩溃环原地重启(任何不兼容形态都不白屏)        │
│  · shell-core        路径 / 设置(损坏自愈)/ 单实例        │
│  · kernel-process    spawn 规格 / 就绪行 / Job Object 杀树  │
│  · bridge            Electron IPC 38 通道 → Tauri command  │
│                     全量映射 + 垫片 JS(window.dshDesktop) │
│  · fence / preview-server / session-watcher /              │
│    sidecar-orchestrator(boot 时序 + Node sidecar 复用    │
│    dsh-desktop/scripts 内核侧逻辑,零重写)                 │
└──────────────────────┬───────────────────────────────────┘
                       │  dsh web --host 127.0.0.1 --port <复用端口>
                       ▼
            内置 node + @deepseek-ai/dsh
            路径解析:用户目录 overlay > 内置包
                       │  就绪行检测
                       ▼
            原生窗口加载 Web UI(仅本机回环访问)

分层铁律:crates 不依赖 tauri 运行时、可独立单测;装配根只接线不实现;内核侧 Node 逻辑全部活在 dsh-desktop/scripts/。开发手册见 dsh-tauri/docs/development.md。

Agent 预设

v1.0.0 纯净线不携带任何 Agent 预设——与官方桌面客户端的交付形态对齐:模式列表只出内核自带的出厂集(standard / ptc / minimal / cordis),安装包不注入自定义 persona,客户端也不写入任何预设文件。

想用自己的预设:放进 <DSH_HOME>/.agent-presets/<id>/ 即可被内核发现(agent.cordis.yml + preset.yml);老用户目录里的历史副本不会被清除。历史上随包过的社区/自研预设来自第三方作者,已整树删除,来源与致谢记录见 git 历史(git log --diff-filter=D -- dsh-desktop/assets/agent-presets)。

📄 License

MIT。基于 @deepseek-ai/dsh(MIT)。


⭐ 如果 DSH Pack 帮到了你,点个 Star 就是最实在的支持; 遇到问题请到 Issues 反馈。