YuanHarness 桌面端

基于官方 DeepSeek Harness 桌面端架构（Electron 壳 + loopback DSH Web Host，壳核分离）的 YuanHarness 定制版桌面端。开箱即用：安装包内置四个插件与品牌默认外观，下载 → 安装 → 启动即可使用，无需手动 dsh plugin add。

下载

最新版本 v0.1.4（本板块由发布工作流自动更新，无需手工维护）：

平台	安装包	大小	下载
macOS（Apple Silicon）	yuanharness-0.1.4-mac-arm64.dmg	≈181 MB	下载 .dmg
Windows（x64）	yuanharness-0.1.4-win-x64.exe	≈161 MB	下载 .exe

更多历史版本见 Releases。

内置插件

插件	说明
dsh-vision-plugin	模型目录「图片输入」开关 + 可选视觉中转（vision_analyze / vision_status / vision_test / vision_configure）
dsh-imagegen-plugin	生图/改图中转（image_generate / imagegen_status / imagegen_test / imagegen_configure + 生图 skill）
dsh-customui-plugin	Web GUI 个性化：侧边栏 Logo、空对话欢迎区（Logo + 文案）、对话背景图
dsh-better-sidebar（omdsh-dev/DSH-better-sidebar）	VSCode 风格右侧边栏（资源管理器 / 编辑器 / 终端 / git / 浏览器）

首次启动时，App 会自动把上述插件安装到 $DSH_HOME/profiles/web（默认 ~/.dsh/profiles/web， DSH_HOME 环境变量可覆盖）。插件的运行期依赖已随安装包预装（打包期生成，含 node-pty 全平台预编译二进制），首次启动无需联网、无需 pnpm、不依赖符号链接权限。 仅当检测到依赖被手工删除/损坏时，才会用随包 pnpm 联网修复（默认走 npmmirror 源， 可在 profile 的 .npmrc 修改）；修复失败不阻塞启动。

Windows 提示：DSH 运行时启动时会创建 ~/.dsh/profiles/node_modules 回退符号链接， 若系统无法创建符号链接，请在 设置 → 隐私和安全性 → 对于开发人员 中启用「开发者模式」 （或以管理员身份运行），App 启动前会自动检测并提示。

开发

npm install          # electron / electron-builder
npm run fetch:all    # 拉取 resources/host（~300MB）、resources/pnpm，并预装内置插件运行期依赖
npm run dev          # 开发态启动（electron .）

开发态默认使用系统 PATH 的 node 作为 Host 运行时（可用 DSH_DESKTOP_NODE_EXECUTABLE 覆盖）。

打包

npm run build:mac    # → dist/yuanharness-<版本>-mac-<架构>.dmg
npm run build:win    # → dist/yuanharness-<版本>-win-<架构>.exe（NSIS 安装包）
npm run build:all    # 两者都打

• macOS 目标：DMG（Apple Silicon；electron-builder --mac --x64 可出 Intel 版， 注意 resources/host 需在同一架构机器上重新 npm run fetch:host）。
• Windows 目标：NSIS 安装包（x64）。
• 未做代码签名：macOS 首次打开需右键 → 打开（Gatekeeper 提示），或 xattr -dr com.apple.quarantine "YuanHarness.app"。

自检

npm run selftest:mac
# 用全新 DSH_HOME 启动打包产物，走完 provision → Host 启动 → 截屏，
# 输出 dist/selftest/home（完整 DSH home）与 dist/selftest/screenshot.png

发布（GitHub Releases）

推送 v* tag 即触发 .github/workflows/release.yml：mac（dmg）与 win（exe）并行构建， 自动创建/更新 GitHub Release 并挂载安装包——用户即可在 Releases 页面一键下载。

git tag v0.1.1 && git push origin v0.1.1

与官方桌面端的关系

• 主进程生命周期/Host 监督逻辑源自官方 @deepseek-ai/dsh-desktop（MIT），保留其 安全策略（loopback 随机端口、会话加固、外链拦截、单实例锁、托盘常驻）。
• DSH 运行时来自 npm 发布的 @deepseek-ai/dsh（版本固定于 scripts/fetch-host.mjs）。
• 内置插件来自各自仓库 / 本地维护版本，升级方式：替换 vendor/plugins/<插件> 后重新打包。

License

MIT（各内置插件沿用其自身许可证，见 vendor/plugins/*/LICENSE）。