桌面免装版 TurnX-alt/actdsh

actdsh — DeepSeek Harness 桌面版（Windows 免安装）

actdsh 是 DeepSeek Harness（简称 dsh）的第三方桌面分发仓库：把官方 npm 包组装成一个免安装的 Windows 应用，下载 zip、解压、双击，不需要 Node.js、npm 或任何开发环境。它提供两件官方桌面版没有的东西——一个不写注册表、可放在任意目录的绿色包，以及一份构建清单，记录「这一版实际锁定了哪些依赖、各是什么版本」。窗口内就是完整的 dsh 官方 Web 界面，配置、会话、技能、插件数据与官方版完全通用。

- 上游官方仓库：deepseek-ai/deepseek-harness
- 本项目性质：第三方打包分发，非 deepseek-ai 官方产品；dsh 的功能问题请反馈到上游（见文末声明）
- macOS 请用官方版：上游自 2026-09-24 起发布带自动更新的桌面版，本仓库 2026-09-25 起不再产出 macOS 包（原因见与官方桌面版的区别）

两边读同一份 ~/.dsh 数据，配置和会话互相通用，装了哪个都能接着用另一个的数据。

下载与安装

到 Releases 页面 下载最新的 zip：

| 系统 | 文件 | 使用方式 |
| Windows 10/11（x64） | actdsh-win-x64-<版本>.zip | 解压到任意位置，双击 actdsh.exe 即用 |
| macOS（Apple 芯片 / Intel） | 用官方桌面版 | 见下文 macOS 怎么拿 |

Windows：解压即用，位置你说了算

把 zip 解压到你喜欢的任意位置（桌面、D 盘、U 盘都可以），双击其中的 actdsh.exe 即可使用。没有安装器、不写注册表、不碰系统里已有的任何程序——应用需要的所有组件都在这个文件夹里。

首次运行时，Windows SmartScreen 可能提示「Windows 已保护你的电脑」。这是因为程序未购买商业代码签名证书（见常见问题）。确认你下载自本仓库 Releases 页面后，点「更多信息」→「仍要运行」即可。

你的 dsh 数据（配置、会话、技能、插件）存放在用户目录的 .dsh 文件夹，与官方版通用，搬家或删除程序文件夹都不会动它。卸载 = 删除解压出来的文件夹，仅此而已。

macOS 怎么拿

用上游自己发布的桌面版。它的 macOS 包由官方流水线产出，签名与 Apple 公证步骤都在流水线里，并且接了自动更新；这两点 actdsh 在合理成本内做不到，所以 2026-09-25 起本仓库不再构建 macOS 包。

官方把桌面版放在自己的 CDN 上，DeepSeek 官网和 dsh 文档页里都没有下载入口（两个页面里 dsh-desk、.dmg 各命中 0 次），能直接读的是更新通道：

https://download.deepseek.com/dsh-desk/feeds/mac-arm64/nightly-mac.yml
https://download.deepseek.com/dsh-desk/feeds/mac-x64/nightly-mac.yml

2026-10-03 复核，这两份通道仍是 0.2.0-rc.2：Apple 芯片包 374,053,565 字节，Intel 包 390,853,725 字节，两者 CDN 返回的 Content-Length 都与通道声明一致（自 2026-10-02 首次记录以来数值未变）。想知道官方发到哪个版本，读通道比读版本号可靠。

两点要说清楚：

- Intel Mac 从 0.2.0-rc.2 起也有官方包了（该目标发布于 2026-09-29T10:21:51Z）。更早的 0.1.7-rc.2 那一版确实没有 Intel 包，本仓库的 macOS 构建也已在 2026-09-25 停止，所以两个版本之间 Intel Mac 用户有一段真空，现在没有了。
- 本仓库 dsh-v0.1.7-rc.2 及更早的 Release 里，macOS 的 dmg 仍然可以下载和使用，只是不会再随上游更新。

与官方桌面版的区别

上游 apps/desktop 是一条完整的桌面版流水线：pnpm dev:desktop 在本地拉起 Electron，pnpm package:desktop:win:x64 与 package:desktop:mac:arm64 出包，产物上传到腾讯云 COS，公开可读的地址是 download.deepseek.com/dsh-desk/。Windows 出 NSIS 安装器，macOS 出 dmg 与 zip，两个平台都接了 electron-updater，Windows 安装器另开了差量更新。官方桌面版在 GitHub 上看不见：上游 dsh-v0.1.7-rc.1、rc.2、alpha.2 三个 Release 的 assets 都是 0 个，官网与文档页也没有下载链接，分发只走那条 CDN 通道。

actdsh 不改 dsh 本体，它从 npm 上的官方 @deepseek-ai/dsh 取同版本包，自己组装 Electron 壳，发布到 GitHub Releases，目前只发 Windows。

| | 官方桌面版 | actdsh |
| Windows 形态 | NSIS 安装器，装进用户目录、不提权，安装界面含中英双语 | 免安装 zip，解压到任意位置（含 U 盘）即用，不写注册表 |
| macOS 形态 | Apple 芯片与 Intel 都有 dmg 与 zip，各自一条更新通道 | 不提供 |
| 自动更新 | 有，走 nightly 通道；Windows 支持差量更新 | 无，到 Releases 下载新版覆盖 |
| 下载渠道 | download.deepseek.com CDN | GitHub Releases |
| 版本 | 滚动预发布线；2026-10-02 三个通道都是 0.2.0-rc.2 | 与上游同版本号，每日轮询上游 tag 后跟进 |
| 构建版本清单 | 未提供 | 每次发布附 upstream-versions-windows-x64.json，列出这一版实际锁定的全部 dsh 家族包版本（最近一次发布 dsh-v0.2.0-rc.2：同版本线 278 个 + 独立版本线 9 个） |
| 官方产物的第三方核对 | 通道自己声明 sha512 与字节数，无人核对 | 每次发布前把官方通道的声明与真实下载字节对齐；不一致则不发布 |

清单不是模型推算：CI 会拿真实 npm install 生成的安装树与之对账，同版本线与独立线的包集合必须一致；唯一已知的版本差异（某包在 registry 上的实际最新与模型选定的不同）被写成一条固定断言而不是被忽略——它变了就会红。官方通道的 sha512 复核同样落在发布路径上：上游 dsh-v 的 GitHub Release 里 assets 是 0 个，分发只走那条 CDN，所以在 actdsh 之前没有任何第三方核对过「通道声明的 sha512 == CDN 上的真实字节」。

自动更新和 macOS 免手动放行只有官方版做得到，所以 macOS 用户应当直接用官方版。actdsh 剩下的是上面那两行官方没有的东西。

常见问题

使用 actdsh 需要安装 Node.js 或其他环境吗？

不需要。应用内嵌了运行 dsh 所需的全部组件（Node 运行时、Chromium 窗口、插件管理用的 pnpm），装好即用。

插件怎么安装？

与官方方式完全一致：dsh 的插件管理基于 pnpm，actdsh 已把 pnpm 内置进安装包并自动接好，插件的安装、更新、卸载都不需要额外准备环境。

配置、会话、技能数据存在哪里？

与官方版完全相同，存放在系统用户目录下的 .dsh 目录（Windows：C:\Users\<用户名>\.dsh；macOS：~/.dsh）。如果你之前用过官方命令行版，actdsh 会直接沿用这些数据。

端口被其他程序占用会怎样？

dsh 默认使用 3080 端口。actdsh 启动时会自动检测：3080 被占用就依次尝试 3081–3099，都被占则由系统分配空闲端口。即使本机已有另一个 dsh 实例在运行，也不影响 actdsh 正常启动。

第一次启动为什么比较慢？

首次进入界面前，dsh 要初始化配置目录（约 1 分钟），窗口会显示启动页并在就绪后自动进入界面。第二次起通常十几秒内即可打开。

如何更新到新版本？

actdsh 的版本号与上游完全一致（例如上游发布 dsh-v0.1.0-rc.8，本仓库即发布同名版本）。上游发布后本仓库通常在 1–2 天内跟进：定时任务实测可能延迟数小时，上游 npm 家族又是分批发布的，闭包没发齐时流水线会空转等下一轮而不是硬启动。到 Releases 页面下载新版覆盖即可，数据不受影响。应用内暂无自动更新。

怎么判断我下载的包没有被改过？

三层可核对的东西，都不需要信任维护者本人：

1. 每次发布附 upstream-versions-windows-x64.json，列出这一版实际锁定的每个 dsh 家族包及其精确版本；
2. 构建与验证全部在 GitHub Actions 的公开日志里，workflow 文件开源可审，任何人可复跑同一套脚本；
3. 发布前会下载官方 CDN 上的真实安装包并计算 sha512，与官方更新通道声明的值对齐，不一致就不发布。

要说明的是：这不等于「可复现构建」的证明。字节级可复现需要固定工具链与构建环境的逐位一致，本仓库只保证依赖版本被钉死、产物被真实启动验证过、官方产物被第三方核对过。

为什么安装包没有做代码签名？

正规的 Windows 代码签名需要付费证书，本项目是零成本的自动化分发，没有购买。首次运行时 SmartScreen 提示「Windows 已保护你的电脑」，确认下载来源后点「更多信息」→「仍要运行」放行一次即可。构建过程全部在 GitHub Actions 公开日志中可查，workflow 文件开源可审。后续可能引入正式签名。

工作原理（面向开发者）

每日 03:23 UTC 定时轮询 → 对比「上游最新 dsh-v 标签」与「本仓库已发布标签」（几秒即退，不消耗构建资源） → 预检上游 npm 家族是否已把这一版发齐；没发齐就本轮空转，等下一轮而不是硬启动构建 → 发现新版本才启动构建，只有一台 Windows runner → 从 npm 安装官方 @deepseek-ai/dsh 对应版本：同版本线的 @deepseek-ai/* 全部钉到 tag 精确版本，按自己节奏发版的独立线包则跟随上游对本次发布的指定（区间与发布 tag 迭代到定点），组装 Electron 壳 → 用户视角自动化验证：真实启动安装包 → 等待 dsh 就绪 → 访问 Web 界面 → 校验 pnpm 垫片可用 → 复核官方桌面版产物：下载 CDN 上的真实包算 sha512，与通道声明对齐；不一致就不发布 → 全部通过才创建 Release

每次发布前，安装包都会在干净的 runner 上被真实启动并通过上述验证。验证不过，版本不会发布。判定逻辑由仓库内的离线测试守着（2026-10-03 为 156 条，node --test，零依赖），其中包含与真实 npm install 安装树的对账和若干负控制——比如故意抹掉一个成员包版本，钉死必须响亮失败并点名，而不是悄悄降级把包发出去。

另有两条每日探针，与发布路径解耦、失败不阻塞发布：一条打 npm registry，预检版本线钉死会不会因为上游发版而失败；一条读官方桌面版的更新通道，核对它声明的产物是否真能取回、字节数是否与声明一致。探针的异常与「通道内容变了」会推送给维护者——后者探针自己是绿的，红绿信号里没有这个信息，只有跨轮快照比对能发现。

时间预期要说实话：GitHub 的定时任务实测可能延迟数小时，上游的 npm 家族又是分批发布（成员包可比根包晚 20 到 80 分钟，2026-09-23 事故里 26 小时内连发三版）。所以上游发布新版本后，actdsh 通常在 1–2 天内跟进，而不是几小时内。另外要说清边界：闭包没发齐、或选版判定不过时，流水线会停在那一个版本上等下一轮，而不是带着可疑的依赖图发出去——延迟是可观察的，勉强发布不是。

图标与 dsh Web 界面同源（取自上游 favicon）。整个流程只使用 GitHub Actions 与 GitHub Releases，不依赖任何外部服务。

English Summary

actdsh 是 DeepSeek Harness（dsh）的第三方 Windows 发行版：一个免安装 zip，内置运行时、官方 Web UI 和供插件使用的 pnpm，不需要 Node.js 或 npm，读写的 ~/.dsh 目录与官方命令行完全一致。上游从 2026-09-24 起发布了自己的桌面应用——面向 Windows 的按用户 NSIS 安装包，加上面向 Apple Silicon 和 Intel Mac 的 dmg/zip 构建，全部由 download.deepseek.com 提供，走 electron-updater（上游流水线包含代码签名与公证步骤；这里不核验各个 release 的公证票据）。因此 macOS 版本来自上游：actdsh 已于 2026-09-25 停止构建 macOS 包。

actdsh 仍然提供两样上游没有发布的东西。每个 release 都带 upstream-versions-windows-x64.json，把 dsh 家族的每个包锁定到确切版本（最新发布的 release dsh-v0.2.0-rc.2 记录了 278 个同线包 + 9 个独立线包），并且这套模型会在 CI 中与真实的 npm install 依赖树比对，而不是直接采信。在 actdsh 之前，没有人独立检查过官方渠道：上游 dsh-v* GitHub Releases 不暴露任何资产，所以没有第三方验证过更新渠道声明的 sha512 是否与 CDN 实际提供的字节一致。actdsh 现在会下载官方产物、计算哈希，一旦不匹配就拒绝发布。

每日工作流会轮询上游，在 npm 家族仍在发布期间空转不构建，在单个 Windows runner 上构建，在干净的 runner 上启动包做端到端验证，然后才发布。请预期上游发布后 1–2 天，而不是几小时：GitHub 的定时运行可能延迟数小时，而且上游是分批发布整个家族的。第三方打包，并非 deepseek-ai 官方产品。

许可与声明

- 本仓库的打包脚本与壳代码：MIT。
- dsh 本体：© deepseek-ai，MIT。
- actdsh 与 deepseek-ai 无隶属关系，仅为社区分发；dsh 的功能问题请反馈至上游仓库。

最近更新：2026-10-03