DeepSeek Harness 轻量启动器。选一个版本,启动 DSH web。
Important
DSH-X 启动的是 DeepSeek Harness 官方原版 Web 页面。
它只负责版本安装、启动和插件管理,不修改也不重做 DSH 的网页界面。DSH-X 本身是社区开源项目,并非 DeepSeek 官方产品。
- 选版本即用:启动 / 停止 / 重启 / 更新 / 卸载
- 多操作系统:Windows 与 macOS 都有原生安装包(macOS 分 Apple Silicon 与 Intel 两份),自更新、开机自启、选目录都用各系统自己的方式
- 插件页:列出已装插件一键开关,可检查并更新插件(单个 / 全部),profile 也在这里切换
- 整合包:一次装好一批插件和它们的配置(含社区市场、导入导出),细节见下面「整合包」一节
- 兼容模式:启动失败按报错自动禁用出问题的插件(可一键恢复);启动后自检页面引用的客户端插件包,管理页给出结论(区分实例问题和旧标签页)
- 深色外观:跟随系统或手动指定,另有悬浮窗透明度与看板娘开关
- 启动加速:在 bundle 合成处挂等价快实现(约省 1–2 秒),dsh 升级后自动跳过
- 插件跟官方走:数据在用户目录
.dsh,换版本不用重装插件 - 更新留旧版:只保留最新的和最近装的一个(回退够用),更旧的装完自动清理(设置里能关)
- 常驻后台:关掉网页不退出(Windows 托盘 / macOS 菜单栏图标),界面走系统浏览器
- 自带 Node / npm / pnpm:安装包里有便携运行时与镜像源 npmmirror,插件安装不依赖系统环境
- 网络代理:跟随系统代理(默认)/ 手动填地址 / 不走代理,代理连不上自动退回直连;版本列表、GitHub、市场和插件安装都按它走
- 可以同时跑几个版本:一个版本一个实例、各挑各的端口(数据在
.dsh里本来就共享),控制页上逐个打开 / 停止;想让地址每次都一样,可以按「版本 × profile」把端口钉死(下次启动生效) - 首次安装可预装市场:可自动安装
dshmarket
一次装好一批插件和它们的配置,不用一个个装、一条条改。整合包在插件页里一张卡一个——一张卡就是一份 profile(装完整合包,产物正是它),手动拼出来的 profile 也在列表里,装过包的那张标着来源;点进去能看到这份 profile 里的插件,每个还能单独开关。格式用生态里的 DSH-PackForge .dspack(manifest v5,兼容旧版本),和其他第三方启动器的包互通。
- 从哪装:本地
.dspack文件、直链,或 GitHub 的owner/repo(自动取最新 Release 里的包);也可以直接在页面上从内置的社区市场里挑。 - 装到哪:默认装进一个独立的 profile,和现有环境互不打扰;也可以改成
web之类现有 profile 并进去,装完在页面上切过去并重启。 - 装之前先说清:层栈、依赖、要写的文件、会覆盖什么、包里有哪些内容不会装(凭据、
.npmrc、整机设置这些一律不落盘)。确认了才动手。 - 出错能退回来:安装前备份被覆盖的文件,装失败自动回滚,卸载时还原;包自建的 profile 可以连目录一起删掉。
- 自己也能发一个:把当前 profile 导出成
.dspack(钉版依赖 + 补丁层 + 配置文件,不含node_modules与凭据),别人装上就是同样的插件环境。
仓库里自带一份 packs/dsh-x-recommended(DSH-X 挑的一套开箱插件,目前装的是生态里那个配置管理插件 dsh-config-manager):node scripts/make-pack.mjs 生成到 release/packs/,然后在页面上用「本地文件」直接装。
启动器没有代码签名,行为又和启发式里的「下载器」有几分像(会拉起 cmd / powershell、能写开机自启、自带 Node 运行时、自更新时下载安装包),所以偶尔会被 Windows Defender 或其他杀软拦下。
被拦了:把安装目录(默认 %LOCALAPPDATA%\Programs\DSH)加进排除项;误报可以提交给微软(选「软件开发者」,上传 DSH-Setup.exe),一般 1–2 天撤销,国内杀软(360、火绒等)同理。下载后 SmartScreen 提示「未知发布者」是正常的,点「仍要运行」。
Windows:下载 DSH-Setup.exe 安装,从桌面打开 DSH-X。
macOS:打开 DSH-X-mac-arm64.dmg(Apple Silicon)或 DSH-X-mac-x64.dmg(Intel),把 DSH-X 拖进「应用程序」。应用没做公证,第一次打开要右键选「打开」;自更新也要求放在这种可写目录里。设置和日志在 ~/Library/Application Support/DSH。
管理页和 dsh 的界面都在系统浏览器里打开,管理页默认 http://127.0.0.1:3780/(端口可在设置页改)。想让手机或其他电脑访问 dsh:设置页 → 高级设置 → Web 绑定选「局域网」,下次启动 dsh 生效。
核对下载到的包(可选):Release 页面每个文件旁边有 sha256,本地对一下即可 —— Windows certutil -hashfile DSH-Setup.exe SHA256,macOS shasum -a 256 DSH-X-mac-arm64.dmg。
本机需要 Node.js 22.18+。npm install 之后 npm start;只起网页用 npm run server。
npm run distWindows(需要 Rust 与 Inno Setup 6)产出 release/DSH/ 便携目录和 release/DSH-Setup.exe;macOS(需要 Rust 与 Xcode 命令行工具)产出 release/DSH-X.app 和 release/DSH-X-mac-<arch>.dmg(Intel 版:DSH_MAC_ARCH=x64 npm run dist)。
打包还会顺带生成 SBOM 与发布清单(自查用,不上传 Release)。发版时先过两道闸门,再把安装包和 dmg 一起传上去:
node scripts/release-manifest.mjs check-tag v0.1.14 # tag 必须与 package.json 的版本一致
node scripts/release-manifest.mjs verify # 逐个产物核对哈希(有私钥时一并验签)
gh release create v0.1.14 release/DSH-Setup.exe release/mac/DSH-X-mac-*.dmg --latest私钥在 release/release-key.pem(已被忽略、不进仓库,务必备份)。scripts/release-manifest.mjs 的头部注释里有 keygen、单独核对某个目录等其余用法。





