← Back
yyh-001

yyh-001/DSH-X

DeepSeek Harness 轻量启动器。选一个版本，启动 DSH web。A lightweight launcher for DeepSeek Harness. Pick a version, start DSH web.

View on GitHub ↗https://yyh-001.github.io/DSH-X/ ↗
deepseekdeepseek-harnessdshdsh-pluginlaunchermacoswindows
Stars
621
Forks
18
Watchers
621
Open issues
7
Contributors
7
Language
JavaScript
License
MIT License
Default branch
master
Created Sep 3, 2026Updated Sep 30, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

DSH-X

主页 · 下载 · Star · English

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

交流 / 反馈：QQ 群 993579665（点击加入）

整合包

一次装好一批插件和它们的配置，不用一个个装、一条条改。整合包在插件页里一张卡一个——一张卡就是一份 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/，然后在页面上用「本地文件」直接装。

界面预览

DSH-X 控制页

DSH-X 插件页

DSH-X 插件页里的整合包卡片

DSH-X 整合包详情：这个包里的插件

DSH-X 设置页

杀软误报

启动器没有代码签名，行为又和启发式里的「下载器」有几分像（会拉起 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 dist

Windows（需要 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、单独核对某个目录等其余用法。