DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

yyh-001 /

yyh-001/DSH-X

Topic repository only

DeepSeek Harness 启动器:启动项与多实例,版本、插件、整合包、MCP 和技能管理。A DeepSeek Harness launcher: launch entries, multiple instances, versions, plugins, modpacks, MCP and skills.

★ 780 Stars27 Forks11 IssuesN/A Community rating0 Confirmed installs
View on GitHubProject homepage
READMESource: Staging@bca229d3

DSH-X

DeepSeek Harness 的第三方桌面启动器 ——
启动项与多实例,版本、插件、整合包、MCP 和技能管理。

Windows macOS Linux

Release npm License
Downloads Stars Contributors

主页 · 下载 · 更新日志 · 参与贡献 · English · 中文

[!IMPORTANT] DSH-X 启动的是 DeepSeek Harness 官方原版 Web 页面。
它只负责版本安装、启动和插件管理,不修改也不重做 DSH 的网页界面。DSH-X 本身是社区开源项目,并非 DeepSeek 官方产品。

功能

  • 🚀 启动项与多实例 — 按项选择用户目录、profile、版本和端口;支持并行启动,运行中也可添加启动项。
  • 📦 版本管理 — 独立管理已安装版本,支持检测新版本、手动安装、卸载、查看磁盘占用和为启动项指定版本。
  • 🧩 插件与整合包 — 按环境安装、卸载、开关和更新插件(npm 包名、本地路径或 Git 地址),可配置官方自定义插件市场的默认索引源;整合包市场支持瀑布流浏览、搜索和排序,也能导入、导出整合包。
  • 🖥️ 桌面增强 — 新建启动项时勾一下,把原生通知、右键菜单、侧栏浏览器三个首方插件装进这个环境;编辑启动项时还能补装,装完可在插件页单独开关和更新。
  • 🛠️ MCP 与技能 — 配置 MCP 服务器,导入、管理和开关技能。
  • 🪟 多种打开方式 — DSH-X 内部标签页、系统浏览器标签页、浏览器独立窗口或桌面窗口。
  • 🎨 外观 — 浅色 / 深色主题、透明度、开场与启动项动效,以及独立的背景和大肥鱼开关。
  • 🔄 更新与恢复 — 自更新、故障恢复、Profile 备份与回退,可设置保留数量的旧版本清理;启动项当前与上一次使用的版本额外保留。
  • 🔍 启动排查 — 启动项日志分「原始日志 / 耗时构成 / 空间构成」三个页签,原始日志页带插件诊断:按插件归并启动耗时和依赖,单列原生 / GC 明细,空间占用拆到插件本体、依赖、运行时与配置数据;有插件报错时日志图标点红。
  • ⚙️ 桌面系统开关 — 硬件加速、自动下载更新(安装手动确认)、任务通知与提示音、关窗口隐藏到托盘、防休眠。
  • 💻 Windows / macOS / Linux — 三个平台的安装包,支持托盘 / 菜单栏常驻和开机自启,自带 npm / pnpm 包装。

快速开始

从 Releases 下载对应平台的安装包:

平台 系统要求 安装包
Windows Windows 10 及以上,x64 DSH-Setup-<版本>.exe(NSIS)
macOS macOS 13 及以上 DSH-X-<版本>-arm64.dmg(Apple Silicon)/ DSH-X-<版本>-x64.dmg(Intel)
Linux x64;AppImage 依赖 FUSE DSH-X-<版本>-x86_64.AppImage / DSH-X-<版本>-amd64.deb

[!NOTE] 安装包只带外壳和 Electron,不内置核心。首次启动需要联网,从 npm 下载当前通道的 dsh-x-core,窗口里显示实时进度和下载源;之后核心更新同样走 npm。

Windows

下载 DSH-Setup-<版本>.exe 安装,从桌面打开 DSH-X。安装包未做 Authenticode 签名,SmartScreen 可能提示「未知发布者」,见签名与杀软误报。

macOS

打开 dmg,把 DSH-X 拖进「应用程序」。目前使用 ad-hoc 签名、未做公证,首次打开可能需要在系统安全提示中手动允许;如果提示「已损坏」或「无法验证开发者」,右键打开,或执行:

xattr -dr com.apple.quarantine /Applications/DSH-X.app

mac 的外壳自更新暂不提供,核心仍走 npm 更新。

Linux

下载 DSH-X-<版本>-x86_64.AppImage,chmod +x 后直接运行;没有 FUSE 时用 ./DSH-X-<版本>-x86_64.AppImage --appimage-extract-and-run。

Debian / Ubuntu 也可以装 deb(装到 /opt/DSH-X、带菜单项、apt remove dsh-x 卸干净),但 deb 版没有外壳自更新,换版本要去发布页重新下载:

sudo apt install ./DSH-X-<版本>-amd64.deb

配置在 ~/.config/DSH,核心缓存在 ~/.cache/dsh-x;两种包的核心更新都走 npm。

校验下载

Release 页面每个文件旁边有 sha256,本地对一下即可:

certutil -hashfile DSH-Setup-<版本>.exe SHA256        # Windows
shasum -a 256 DSH-X-<版本>-arm64.dmg                  # macOS
sha256sum DSH-X-<版本>-x86_64.AppImage                # Linux

使用

  • 在主页添加或编辑启动项,选择环境与版本后启动;编辑启动项时可打开 版本管理,手动安装或卸载版本。
  • 设置 → 常规 → 打开 dsh 的方式,可选 DSH-X 内部标签页、浏览器或独立窗口。内部标签页需要使用安装后的桌面端。
  • 管理页默认端口为 3780,被占用时会顺延。
  • 手机或其他电脑访问 dsh:设置 → 高级设置 → Web 绑定选「局域网」,下次启动生效。

添加启动项

新建启动项先选 隔离方式,它决定新环境跟现有环境隔多远:

隔离方式 建在哪 共享什么
插件隔离(默认) 全局 dsh 目录里新建一个 Profile 会话、记忆、技能;插件与配置独立
会话隔离 数据目录 homes/<名字> 下的新用户目录 什么都不共享:会话、技能、插件全部独立
自定义 手动指定用户目录 + Profile + 端口 由你挑的那份环境决定

前两档再选 Profile 从哪来:

  • 新建 Profile:名字留空就自动取(撞名会顺延),也可以自己填。
  • 从已有 Profile 复制:先选来源(左栏用户目录、中栏 Profile),新名字预填 来源-copy,可以改。

复制的是 Profile,不是整套环境:package.json、cordis.patch.yml、插件开关与 MCP 等配置会带过去, 依赖按版本范围重新安装(不是原样复制 node_modules),用户目录下的 skills、Prompt 管理、各插件自己的数据目录和会话历史都不跟过来。 file: / link: / portal: 这类本地依赖会按新位置改写;指向来源目录外面的路径保持原样,所以那份工作区得还在。

排查启动问题

启动项的日志弹窗有三个页签,只有采到数据时才出现:原始日志常驻,耗时构成把启动耗时按插件归并(共用依赖均摊给引用它的插件),空间构成把磁盘占用拆成插件本体、插件依赖、运行时、运行时依赖和配置与数据。原始日志页顶部还会显示插件诊断:哪个插件不兼容、哪一步失败,以及可以执行的修复方案。有插件报错时,启动项上的日志图标会点红。

插件与 Profile

  • 插件页右上角的 + 可以直接添加插件:npm 包名、本地绝对路径或 Git 地址;添加和卸载会同步 bundle 层栈与依赖。
  • 首页插件弹窗的「更多操作」里有 Profile 备份与回退:每次启动前自动存一份配置层快照,也可以手动「立即备份」;回退会按还原后的清单重装依赖,并需要重启这个 Profile 的实例才生效。

界面预览

多启动项 · 深色主题

DSH-X v0.1.16 多启动项主页

管理页面 · 深色主题(展开查看)

环境列表

DSH-X v0.1.16 深色环境列表

插件管理

DSH-X v0.1.16 深色插件管理

整合包市场

DSH-X v0.1.16 深色整合包市场

常规设置

DSH-X v0.1.16 深色常规设置

管理页面 · 浅色主题(展开查看)

启动器主页

DSH-X 启动项主页

环境列表

DSH-X 环境列表

插件管理

DSH-X 按环境管理插件

整合包市场

DSH-X 整合包市场

常规设置

DSH-X 设置页

多标签页 · 深色主题

DSH-X v0.1.16 多标签页界面

整合包

整合包把一组插件和配置装进选定的环境(profile)。插件页按环境展示,装过包的环境会标明来源,插件仍可单独开关。使用 DSH-PackForge .dspack 格式(manifest v5,兼容旧版本)。

  • 导入 — 社区市场、本地文件、直链或 GitHub owner/repo。默认安装到当前选中的环境,确认前可切换目标。
  • 安装 — 先查看插件和文件变更,再确认安装;覆盖前备份,失败自动回滚。
  • 导出 — 把当前环境的依赖、补丁层与配置打成 .dspack,不含 node_modules 与凭据。

仓库中有两套配方:

  • 推荐整合包 — 配置管理、记忆、同步和大肥鱼装饰插件,均从 npm 安装(同步由可选插件 dsh-x-sync 提供)。
  • 桌面工作台 — 把 dsh-tauri 桌面版的侧栏工作台、工作树、定时任务、归档和通知在纯 dsh 生态里凑齐,并带上 ZCode 的 agent-browser 与 electron 技能。

运行 node scripts/make-pack.mjs 可生成 .dspack,再作为本地文件导入。

桌面增强

「添加启动项」里勾上「安装桌面增强」,保存时把三个首方插件装进这个启动项对应的 profile(从 npm 装,不随安装包发;装完在插件页单独开关和更新)。编辑启动项时还能看到装了几个、补装缺的;取消勾选不会卸载。

  • 原生通知 — 一轮结束、等你确认时发系统通知,并把桌面能力借给其它插件
  • 右键菜单 — 会话、工作区、选中文字、链接和输入框的右键菜单,纯网页插件、不依赖桌面外壳
  • 侧栏浏览器 — 操作 dsh 官方右栏 Browser:快照、点击、输入、截图

动态壁纸

配套的 Wallpaper Engine 壁纸《DSH-X · 大肥鱼桌面终端》:DSH-X 品牌开场、大肥鱼、本机时间与音乐频谱,按时间自动切换深浅配色。源码在 wallpaper/,node scripts/export-wallpaper.mjs 导出 Wallpaper Engine 工程。

DSH-X 动态壁纸

签名与杀软误报

发布清单的签名用于校验文件完整性,与 Windows 发布者签名不同。目前 DSH-Setup-<版本>.exe 和给 0.1.18 旧更新器用的兼容桥 DSH-Setup.exe 都尚未做 Authenticode 签名,可能出现 SmartScreen「未知发布者」提示。杀软误报可向微软或对应杀软厂商提交安装包申诉。

说明

[!WARNING] 上游仍在快速迭代 — dsh 内核与插件生态更新频繁,可能存在破坏性变更;升级前请确认插件兼容性。

[!NOTE] 安全提示 — dsh 具备本地代码执行能力,DSH-X 只负责安装与启动。请仅在可信环境中使用。

开发

本机需要 Node.js 22.18+。启动器本身没有第三方依赖:npm start 启动管理页,只起服务用 npm run server,测试用 npm test。外壳是 Electron,npm run electron 或打安装包前先 npm install。

开发、提交与发版约定见 CONTRIBUTING.md。

打包

npm install
npm run dist

Windows 产出 release/eb/DSH-Setup-<版本>.exe(NSIS)和给 0.1.18 旧更新器用的兼容桥 release/eb/DSH-Setup.exe;macOS 产出 release/eb/DSH-X-<版本>-<arch>.dmg;Linux 产出 release/eb/DSH-X-<版本>-x86_64.AppImage。安装包由 electron-builder 生成,不再需要 Rust / Inno Setup。

安装包只带外壳和 Electron,核心不在包里:首次启动由 shell/core-fetch.mjs 从 npm 取到用户目录的 core/current,之后核心跟随 npm 更新。

发版前检查版本与产物(发布清单与 SBOM 只在本机自查,不上传 Release):

node scripts/release-manifest.mjs check-tag v0.1.22
node scripts/release-manifest.mjs verify

GitHub Actions 的 build 工作流构建 Windows / macOS / Linux 三个平台的安装包,并在 tag 上发布 npm 核心包与 CLI。macOS 目前只出 dmg(临时签名,外壳自更新暂不提供);Linux 用 AppImage + latest-linux.yml。

发布清单的私钥在 release/release-key.pem(已被忽略、不进仓库,务必备份)。

参与

  • 安全问题见 SECURITY.md,别开公开 issue。
  • 每个版本改了什么,见 docs/releases。
  • 交流 / 反馈:QQ 群 993579665(点击加入)
  • 插件 2 群(DeepSeek Harness):点击链接加入群聊

相关项目

  • deepseek-harness — 上游 dsh agent 平台
  • DSH-PackForge — 整合包 .dspack 格式与配方工具
  • deepseek-harness-desktop — 同生态的 Tauri 桌面版,本仓库的整合包配方参考了它的插件集合

许可

MIT © 2026 yyh

—/ 5

No ratings yet

Manifest verification required

Commit bca229d3d37e

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout