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 怎么拿 |
把 zip 解压到你喜欢的任意位置（桌面、D 盘、U 盘都可以），双击其中的 actdsh.exe 即可使用。没有安装器、不写注册表、不碰系统里已有的任何程序——应用需要的所有组件都在这个文件夹里。
首次运行时，Windows SmartScreen 可能提示「Windows 已保护你的电脑」。这是因为程序未购买商业代码签名证书（见常见问题）。确认你下载自本仓库 Releases 页面后，点「更多信息」→「仍要运行」即可。
你的 dsh 数据（配置、会话、技能、插件）存放在用户目录的 .dsh 文件夹，与官方版通用，搬家或删除程序文件夹都不会动它。卸载 = 删除解压出来的文件夹，仅此而已。
用上游自己发布的桌面版。它的 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 剩下的是上面那两行官方没有的东西。
不需要。应用内嵌了运行 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 页面下载新版覆盖即可，数据不受影响。应用内暂无自动更新。
三层可核对的东西，都不需要信任维护者本人：
- 每次发布附
upstream-versions-windows-x64.json，列出这一版实际锁定的每个 dsh 家族包及其精确版本； - 构建与验证全部在 GitHub Actions 的公开日志里，workflow 文件开源可审，任何人可复跑同一套脚本；
- 发布前会下载官方 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，不依赖任何外部服务。
actdsh is a third-party distribution of DeepSeek Harness (dsh) for Windows: an installer-free zip that bundles the runtime, the official web UI and pnpm for plugins, requiring no Node.js or npm, and reading/writing the same ~/.dsh directory as the official CLI. Upstream has shipped its own desktop app since 2026-09-24 — a per-user NSIS installer for Windows plus dmg/zip builds for Apple Silicon and Intel Mac, all served from download.deepseek.com with electron-updater (the upstream pipeline contains code-signing and notarization steps; individual releases' notarization tickets are not verified here). macOS therefore comes from upstream: actdsh stopped building macOS packages on 2026-09-25.
What actdsh still adds are two things upstream does not publish. Every release carries upstream-versions-windows-x64.json, pinning each dsh family package to an exact version (the latest shipped release, dsh-v0.2.0-rc.2, records 278 same-line + 9 independent-line packages), and that model is reconciled in CI against a real npm install tree rather than trusted. Before actdsh, nobody independently checked the official channel: upstream dsh-v* GitHub Releases expose zero assets, so no third party had verified that the sha512 declared by the update channel matches the bytes actually served by the CDN. actdsh now downloads the official artifact, hashes it and refuses to publish on a mismatch.
A daily workflow polls upstream, spins without building while the npm family is still being published, builds on a single Windows runner, launches the package on a clean runner to verify it end to end, and only then publishes. Expect 1–2 days after an upstream release rather than hours: GitHub scheduled runs can lag several hours, and upstream publishes the family in batches. Third-party packaging, not an official deepseek-ai product.
最近更新：2026-10-03