DSH APP

DeepSeek Harness（dsh）的品牌桌面客户端，由社区开发者维护。
Windows / macOS / Linux，面向公开发布。

简体中文 · English

外壳自带一份版本化的 dsh 运行时（更新/回滚自管理），在沙箱窗口渲染官方 dsh Web UI； 品牌功能以 dsh 插件套件实现，不 fork 上游。分层、内核运行时布局、更新与回滚机制、打包等 架构设计见 docs/ARCHITECTURE.md。

封装客户端功能

DSH APP 是 self-contained、no-fork 的封装客户端：内核自托管（userData/kernel/，原子激活 + 回滚）， 功能全部以 dsh 插件套件（plugins/）叠加在上游 kernel 上，上游发布只是一个普通内核更新。 当前插件能力：

套件接线（每次 server 启动自动完成，src/main/brand-suite.ts）：

1. 模块解析：套件插件链接进共享回落目录 $DSH_HOME/profiles/node_modules/@dsh-app/（Windows 为 junction）—— 该目录从任何 profile 都能解析到，且不会被任何 profile 的 pnpm 清理； 开发源是仓库 plugins/*，生产源是激活内核里的 app/node_modules/@dsh-app/*。
2. 套件自有 profile：内核以 --profile dsh-app 启动，你在终端里的 dsh / dsh web 仍用 web。 首次运行会在后台建好新 profile 并把你手写的 patch 层（禁用行、MCP 行）带过去； 第三方包不搬——它们在应用内的插件市场里重装到新 profile，因为市场才懂 pnpm 的发布冷静期策略、 构建脚本放行和失效规格这些事（搬整棵树的两种做法都实测过并被否决：复制会被 Windows 的 .pnpm 符号链接权限卡住，按 lockfile 重装会撞 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION）。 建好并落 marker 后下次启动才切换；失败则继续用 web 启动并在下次重试。生效的 profile 通过 DSH_APP_PROFILE 传给内核，所以插件市场与预设总是装到应用真正读取的那个 profile。
3. 加载器覆盖：plugins/dsh-app.patch.yml 拷入 userData，经命令行 --patch 注入 （应用在官方 bundle 层之后，last write wins，无需改上游 profile 模板）。

每一环都优雅降级：内核缺少套件插件（例如回滚目标）时原样启动、无阻塞。

下载与安装（用户）

从 Releases 下载对应平台的安装包； 中国大陆网络也可改用 ModelScope 镜像，见下方「中国大陆网络适配」。

当前版本未做代码签名。 本项目是社区维护的免费项目，没有购买签名证书，因此两个平台各自 会弹一次系统安全提示。这是预期行为，按下面步骤操作即可完成安装——不影响功能与后续更新。

• Windows：双击安装包后若出现「Windows 已保护你的电脑」（SmartScreen）→ 点「更多信息」→ 「仍要运行」，然后按向导走完。
• macOS：双击 dmg 若提示「无法验证开发者」或「已损坏，无法打开」→ 打开 系统设置 → 隐私与安全性，在「安全性」一栏点「仍要打开」，再确认一次。 macOS Sequoia（15）起已移除「右键 → 打开」的绕过方式，必须走系统设置这一步。

装好之后，除了双击启动，还可以把一个文件夹交给它：

• Windows：dsh-app.exe "D:\某个项目"，或把文件夹直接拖到 exe / 桌面快捷方式上。
• macOS：open -a "DSH APP" /path/to/project。

它会把这个文件夹登记成工作区并直接开一个会话（会话的 cwd 就是它）。若应用已经在运行， 再次这么启动只会聚焦现有窗口并把新文件夹开成工作区——不会起第二个窗口。路径不存在时会弹一张 说明卡，而不是静默无反应。

快速开始（开发）

需要 Node.js 22+ 与 pnpm。开发内核 = 本地的 deepseek-harness checkout。

前置（一次性）：

# 1. 本仓库旁有 deepseek-harness checkout（../deepseek-harness），
#    并且已装好依赖、构建过 web 前端：
cd ../deepseek-harness
pnpm install
pnpm run build:web

# 2. 安装外壳依赖
cd ../dsh-app
npm install

启动（注意：Windows PowerShell 不支持 VAR=1 cmd 语法）：

# PowerShell
$env:DSH_APP_DEV="1"; npm start

:: cmd
set DSH_APP_DEV=1 && npm start

开发模式下外壳用本地 checkout 顶替内核：走同一个 desktop host 子进程 （entry 取 apps/desktop-host/lib/index.js，allowLinkedProfile 让链接式 profile 得以启动），不下载、不产生内核产物。dev 与生产都不绑端口，窗口都加载 dsh-app://app。

指定其他 checkout

$env:DSH_APP_DEV="1"; $env:DSH_APP_DEV_RUNTIME="D:/codes/DSH-APP/deepseek-harness"; npm start

开发环境的已知差异

内核更新系统

应用自带版本化内核（userData/kernel/），不依赖系统是否安装过 dsh。更新链路： 解析 npm registry 的 dist-tag 版本 → 从 GitHub Releases 下载运行时产物 → 与附带的 sha512 比对校验 → 原子激活（旧版保留为 previous）→ 连续启动失败 2 次自动回退上一版。 内核运行时布局与更新流程详见 ARCHITECTURE.md §4–5。

内置运行时漂移检测：升级安装时，如果新安装包内置的运行时与磁盘上已 adopt 的版本戳 （<dsh 版本>+<套件版本>，记录在 current.json 的 bundledStamp）不一致（例如套件新增了插件）， 启动时会自动重新解压并激活内置运行时——不会静默沿用旧内容导致插件缺失；在线更新过更新的内核 也不会被降级覆盖（版本戳相等即跳过，打包产物不逐字节可复现，所以比较的是版本戳而非 sha512）。

应用（外壳）更新

Windows 使用自定义链路；macOS / Linux 使用 electron-updater。

1. 检测：github.com/<owner>/<repo>/releases/latest/download/latest.yml（镜像回退）
2. 下载：按架构选择安装包，官方直链优先、ghfast.top / gh-proxy.com 依次回退
3. 校验：sha512 与 latest.yml 比对，镜像永远替换不了内容
4. 安装：可视化安装向导——点击「立即安装」后关闭应用、打开与首次安装相同的 NSIS 向导（安装进度全程可见），完成后自动启动应用，安装包自动删除（取消安装也会删除）

中国大陆网络适配（不挂梯子也能更新）

两条更新链路都有回退链，默认开箱即用：

安全模型：sha512 元数据优先从官方 GitHub 获取，镜像只在大文件下载阶段参与， 且每个下载候选（官方 + 每个镜像）都用同一份可信 sha512 校验——镜像被劫持也换不掉内容。

连通性自检（在目标网络环境跑一遍）：

node scripts/probe-mirror.mjs

桌面化适配

外壳通过运行时注入为 Web UI 补桌面体验，harness 源码零改动：窗口拖拽、原生窗口按钮 让位、顶栏配色实时同步、中英双语 UI。品牌功能（侧边栏、模型页等）通过上面的 插件套件以 --patch 覆盖与 slot 注入实现，同等零上游改动。注入实现细节见 ARCHITECTURE.md §2。

另一个桌面侧的接缝是启动文件夹：把文件夹作为启动参数交给外壳后，它经页面上一个全局函数 （window.__dshAppOpenWorkspace，由套件插件安装、外壳用 executeJavaScript 调用）把它开成工作区； 内核没有该插件时（回滚目标、安全模式）静默跳过，启动照常。实现见 src/main/workspace-launch.ts。

构建分发

npm run dist:win     # NSIS 安装器（x64 + arm64）
npm run dist:mac     # dmg + zip（x64 + arm64，公证走环境变量）
npm run dist:linux   # AppImage + deb（x64 + arm64）

应用图标：resources/icon.png 当前为占位品牌图标，发布前请替换为正式图标； npm run icon:gen 生成占位图标，npm run icon:build 由它裁剪多尺寸 PNG + ICO（需 Pillow）。

内核运行时产物由 scripts/build-runtime.mjs 构建（每个 platform/arch 一份）， CI 工作流发布到 GitHub Releases：

node scripts/build-runtime.mjs win32 x64 0.1.0-rc.8