DeepSeek Harness 启动器 ——
启动项与多实例,版本、插件、实例、远端连接、MCP 和技能管理。
主页 · 下载 · 更新日志 · 参与贡献 · English · 中文
[!IMPORTANT]
DSH-X 启动的是 DeepSeek Harness 官方原版 Web 页面。
它只负责版本安装、启动和插件管理,不修改也不重做 DSH 的网页界面。DSH-X 本身是社区开源项目,并非 DeepSeek 官方产品。
功能
- 🚀 启动项与多实例 — 按项选用户目录、配置、版本和端口,支持并行启动与运行中新增。
- 📦 版本管理 — 检测、安装、卸载和清理 dsh 版本,为启动项钉版本、查看磁盘占用。
- 🧩 插件与实例 — 实例锁定 DSH 版本与插件,可导入导出、跟随上游更新;插件按配置开关并支持在线市场一键安装。
- 🌐 WSL 与 SSH 远端 — 启动项可跑在 WSL / SSH 主机上,远端自动安装 dsh-x-core,页面经隧道在本机打开。
- 🔍 启动排查 — 日志分原始 / 耗时 / 空间三页,按插件归并耗时和依赖;插件报错时日志图标点红。
- 🔄 更新与恢复 — 自更新、故障恢复、配置备份与回退。
- 🛠️ MCP、技能与桌面增强 — 内置 MCP / 技能在线市场,默认启用
dsh-x-computer-use电脑操作,支持原生通知、侧栏浏览器等首方插件。
快速开始
从 Releases 下载对应平台的安装包:
| 平台 | 安装包 | 说明与首次运行 |
| --- | --- | --- |
| Windows (10+ x64) | DSH-X-<版本>-win-x64.exe | 安装后从桌面打开 DSH-X;暂无 Authenticode 签名,若 SmartScreen 提示未知发布者可核对 SHA256 或向微软反馈误报。 |
| macOS (13+) | DSH-X-<版本>-mac-arm64.dmgDSH-X-<版本>-mac-x64.dmg | 拖入「应用程序」;因使用 ad-hoc 签名未公证,若拦截请右键打开或执行:xattr -dr com.apple.quarantine /Applications/DSH-X.app。暂不提供外壳自更新,核心仍走 npm 更新。 |
| Linux (x64) | DSH-X-<版本>-linux-x64.AppImageDSH-X-<版本>-linux-x64.deb | AppImage 赋予执行权限后直接运行(无 FUSE 加 --appimage-extract-and-run);deb 可用 sudo apt install ./DSH-X-<版本>-linux-x64.deb 安装(无外壳自更新)。数据目录:~/.config/DSH。 |
[!NOTE]
安装包仅含 Electron 外壳,不内置核心。首次启动会联网从 npm 拉取当前通道的 dsh-x-core 并显示实时进度;后续核心与外壳各自独立更新,网页或后端优化无需重新下载 100MB+ 安装包。
本地校验下载文件 SHA256
certutil -hashfile DSH-X-<版本>-win-x64.exe SHA256 # Windows
shasum -a 256 DSH-X-<版本>-mac-arm64.dmg # macOS
sha256sum DSH-X-<版本>-linux-x64.AppImage # Linux
界面预览
管理页面 · 深色主题(点击展开)



管理页面 · 浅色主题(点击展开)




使用速览
隔离方式
新建启动项时可按隔离粒度一键创建配置或独立用户目录(禁止将 dsh 用户目录或版本目录设在启动器安装目录内):
| 隔离方式 | 创建位置 | 数据与扩展范围 |
| --- | --- | --- |
| 插件隔离(默认) | 全局 dsh 目录下的新配置 | 共享会话、记忆与技能;插件与配置独立 |
| 会话隔离 | 数据目录 homes/<名字> 下独立目录 | 会话、记忆、技能、插件全部隔离 |
| 自定义 | 手动指定用户目录、配置、端口 | 支持导入本地目录、WSL/SSH 连接或一键设为 DSH_HOME |
常见操作
- 实例与配方:在「实例」页安装/管理插件与依赖,兼容 DSH-PackForge
.dspackv5 格式;仓库内置 推荐实例 与 桌面工作台 配方,运行node scripts/make-pack.mjs可本地打包。 - 打开方式与局域网:支持内部标签页、独立窗口与系统浏览器;管理页默认端口
3780(冲突自动顺延),在「设置 → 高级 → Web 绑定」切换为局域网即可跨设备访问。 - 备份与回退:每次启动前自动留存配置层快照,可在实例页右上角或配置操作菜单一键恢复并重装依赖。
动态壁纸
配套 Wallpaper Engine 壁纸《DSH-X · 大肥鱼桌面终端》:含品牌开场、看板娘互动、本机时间与音频频谱,并随时间自动切换深浅主题。源码位于 wallpaper/,执行 node scripts/export-wallpaper.mjs 可导出工程。
查看壁纸预览
开发与打包
需要 Node.js 22.18+。后端服务与管理界面零第三方运行时依赖;运行 Electron 外壳或打包安装包前需先 npm install。
| 命令 | 说明 |
| --- | --- |
| npm start | 启动管理页服务(开发调试) |
| npm test | 运行全量离线测试套件(node --test) |
| npm run electron | 从源码拉起 Electron 桌面外壳 |
| npm run dist | 构建当前平台的 electron-builder 安装包 |
提交约定与目录结构见 CONTRIBUTING.md;发布清单私钥 release/release-key.pem 不入库,签名校验使用 node scripts/release-manifest.mjs verify。
社区与相关项目
- 交流群:QQ 群 993579665 · 插件 2 群 加入群聊
- 版本与安全:更新日志 · 漏洞反馈(SECURITY.md)
- 相关生态:deepseek-harness(上游引擎)· DSH-PackForge(整合包格式与工具)· deepseek-harness-desktop(Tauri 桌面版)
[!NOTE]
上游 dsh 内核与插件生态迭代较快,升级前建议确认插件兼容性;dsh 具备本地代码执行能力,请仅在可信环境中使用。
MIT License © 2026 yyh