dshdesktop

面向 Windows 的非官方 DeepSeek Harness 桌面客户端。不修改官方源码，直接运行并呈现官方 Web UI。

为什么做这个项目

DeepSeek Harness 原生提供 Web 界面，但日常使用仍需要在终端中启动和管理服务。DSH Dock 把这套官方 Web UI 停靠到可直接双击运行的桌面程序中，同时保留原生 DSH 的配置、会话、插件和工作区习惯。

品牌与项目关系

DSH Dock 是独立的非官方社区桌面封装，不是 DeepSeek 或 DeepSeek Harness 的官方客户端。为减少用户对官方身份或背书关系的误解，并明确品牌素材边界，应用不再复用上游鲸鱼标识作为主图标，改用自有的终端 Dock 标记；辅助鲸鱼也是重新绘制的独立线条形象。详细说明见 品牌说明。

功能特性

• 官方页面，零前端分叉：直接加载官方 dsh web，界面与能力与对应版本的 DSH 保持一致。
• 无缝衔接原生 DSH：默认共用 ~/.dsh，设置、凭据、会话、Profiles 与已装插件互通。
• 无需全局安装：安装包自带匹配版本的 DSH、官方 Node.js 运行时与 pnpm 工具链。
• 安静的运行环境：在不破坏 Windows ACL 沙箱的前提下隐藏 PowerShell、Command Prompt 与 conhost 窗口；Agent 的输出、退出码与文件操作不受影响。
• 更轻的运行时升级：运行时缓存按包增量更新，相同版本不重复解压。
• 跟随官方版本：构建命令自动同步 npm 上最新的 DSH 组件，Dependabot 每周检查更新。
• 桌面体验优化：原生窗口、简洁标题栏、会话头部空白区域可拖动窗口、单实例运行、外部链接安全打开。
• 内置 desktop-ui 增强：设置抽屉样式、右键菜单（在资源管理器中打开工作区、复制粘贴）、会话日志导出等。
• 对话页内工作台：文件 / Git 功能面板与对话并存显示（页签行 [|] 按钮开关、拖拽调宽、按会话记忆布局）；回复完成或 AI 调起询问时右下角系统通知，点击直达对应聊天窗口。
• 本地优先：Web 服务仅监听随机本机回环端口。
• Git Bash 按需内置：内置「极简模式 (Git Bash)」agent preset，检测到缺少 bash 时先向用户说明用途，经同意后自动下载 Git for Windows 便携版到应用数据目录，开箱即用（详见下）。

下载与安装

前往 Releases 下载：

• DSH-Desktop-Setup-<版本>-x64.exe：标准安装包（推荐）。
• DSH-Desktop-Portable-<版本>-x64.exe：免安装便携版。

支持 Windows 10 / 11 x64。首次启动需要展开约 300 MB 官方运行组件，比后续启动稍慢。

与原生 DSH 的数据关系

桌面端遵循官方 DSH Home 规则：

1. 设置了非空的 DSH_HOME 时，使用该目录。
2. 否则使用 ~/.dsh。

因此将来安装官方 DSH 后，可以继续使用已有设置、会话和插件。用户创建的插件应放在 ~/.dsh/plugins（或自己的项目目录）；Web Profile 的安装记录位于 ~/.dsh/profiles/web。这些目录都不属于桌面端可替换的运行时缓存。

内置插件采用多插件结构：plugins/ 下的每个 dsh-desktop-* 目录都是一个独立插件（各自携带 host/client 两半与 patch 行），启动时逐个按内容指纹部署并注册。目前内置十个插件：

• dsh-desktop-workbench — 工作台框架：对话页右侧分栏（文件 / Git 面板的宿主，页签行 [|] 按钮开关）
• dsh-desktop-files — 功能增强：文件工作台
• dsh-desktop-git — 功能增强：Git 面板
• dsh-desktop-ui — 视觉增强（见下）
• dsh-desktop-features — 功能增强聚合卡片（插件配置页中的分组入口，各功能插件把开关注册进它的子槽位）
• dsh-desktop-updates — 功能增强：检查更新
• dsh-desktop-context-menu — 功能增强：右键菜单
• dsh-desktop-notify — 功能增强：完成提醒
• dsh-desktop-tray — 托盘命令桥（新建任务 / 添加工作区 / 检查更新）
• dsh-desktop-opencode-models — OpenCode 实时模型发现：Zen / Go 每次主动获取模型时查询当前 /models，并用 Models.dev 的逐模型协议元数据保证目录外模型可保存、可路由；不维护静态白名单

dsh-desktop-browser（工作台内置浏览器）正在开发中：仓库源码随 npm start 开发模式部署调试，但暂不随安装包分发（打包配置里的 extraResources 过滤器已排除它，转正式时移除过滤器即随下一版发布）。

Git Bash 按需内置（极简模式 (Git Bash)）

DSH 的极简模式预设依赖 bash，但 Windows 默认没有。桌面端内置了自研的「极简模式 (Git Bash)」agent preset（presets/minimal-gitbash/，灵感来自社区 dsh-gitbash-preset 与 dsh-win32，见 第三方声明），并负责两件事：

1. 部署预设本体：DSH 的预设发现机制是启动时扫描 ${DSH_HOME}/.agent-presets/，桌面端在后端启动前把打包的预设幂等复制到该目录（已存在则不覆盖用户改过的版本），因此新建会话时就能直接选择「极简模式 (Git Bash)」，无需安装任何插件。

2. 按需提供 bash：启动时按以下顺序解析 bash（与预设执行器的探测顺序一致，结果通过 GIT_BASH 环境变量注入后端）：

1. 应用数据目录中已安装的便携版 runtime-tools\git-bash\bin\bash.exe；
2. 系统已装的 Git for Windows（GIT_BASH → Program Files → %LOCALAPPDATA%\Programs\Git → PATH，跳过 System32 下的 WSL 启动器 stub）；
3. 都没有时，弹窗说明下载用途并询问用户，同意后从 Git for Windows 官方 GitHub Release 下载最新 PortableGit（约 350–400 MB），用自带 7-Zip 解压到应用数据目录——不修改系统、不需要管理员权限。

与社区版的两处改进：

• 带写围栏的文件系统：官方极简模式挂裸 fs-local，不上报 sandboxMode，导致 str_replace_editor 在 Read Only 徽章下也没有写入围栏（deepseek-harness discussion #2066）。内置预设改用 dsh-fs-sandbox：权限徽章（read-only / workspace-write）真正约束编辑器写入；
• 中文错误与桌面端指引：bash 调用被沙箱拒绝时给出明确中文提示（如何切「完全访问」或发起单次升级）。

下载决策记录在 runtime-tools\git-bash-state.json：「不再询问」后 7 天内不弹窗，下载失败 1 天内自动重试。也可以不下载，自行安装 Git for Windows（git-scm.com）后重启应用即可识别。注意：会话沙箱为 workspace-write（或更窄）时，MSYS 运行时仍无法启动（DSH 沙箱边界），需切换完全访问或由模型按提示单次升级；bash 每次调用为全新 shell，不保留 cd/export 状态。

视觉增强开关（dsh-desktop-ui）

纯视觉定制，全部默认开启。设置入口在「设置 > 插件 > 视觉增强」，保存后页面自动刷新：

开关	功能
设置抽屉	设置页以左侧抽屉样式打开
会话日志导出	会话标题旁的导出按钮（替代右上角原始入口）
统计栏整宽	输入框下方统计信息整行居中显示

开关配置持久化在 $DSH_HOME/desktop-ui.json（默认 ~/.dsh/desktop-ui.json），关闭应用后也可以直接编辑该文件；无效字段会被忽略并回退默认值。若在 profile 的插件行中为 dsh-desktop-ui 配置了 config（如 dsh plugin 方式安装时的 patch 层），它作为中间层参与合并：内置默认值 < 插件行 config < desktop-ui.json。

功能增强开关（dsh-desktop-features 下的独立插件）

每个功能增强是独立插件，开关收纳在「设置 > 插件 > 功能增强」聚合卡片里，配置分别持久化在 $DSH_HOME/desktop-*.json：

功能	插件	说明
工作台	dsh-desktop-workbench	对话页右侧分栏框架：文件 / Git 等功能面板与对话并存显示（页签行 [
文件工作台	dsh-desktop-files	工作台「文件」页签：目录树 + 文件子页签预览（图片 / 视频 / 音频 / Markdown / PDF / 代码高亮 / JSON），对话中的文件链接自动打开，目录树显隐 / 宽度持久记忆
Git 面板	dsh-desktop-git	工作台「Git」页签：分支 / 暂存区与工作区文件列表 / VSCode 式 diff / 暂存 / 提交 / 历史；仓库选择按会话记忆，分栏尺寸持久记忆
检查更新	dsh-desktop-updates	「设置 > 检查更新」显示当前版本，手动检查 GitHub Releases，有新版本时弹窗选择「前往下载」或「暂不」
右键菜单	dsh-desktop-context-menu	右键输入框剪切 / 复制 / 粘贴 / 全选；右键工作区打开所在文件夹；右键选中内容直接复制
完成提醒	dsh-desktop-notify	回复完成或 AI 调起询问且应用窗口不在前台时，在右下角弹出系统通知；点击通知回到应用并跳转到对应聊天窗口（含最小化恢复）

更新机制

应用不会在每次启动时强制联网更新。发布新版时：

• npm run dist 会先同步 npm 上最新的 @deepseek-ai/dsh 及配套包，再打包。
• npm run dist:offline 只使用锁定版本，适合离线重建同一版本。
• 安装包生成 block map；运行时缓存按包增量替换，避免每次重新处理数万个文件。

本地构建

要求 Windows 10 / 11 与 Node.js 22.19+ 或 24（构建机自带即可，目标机不需要）：

git clone https://github.com/CCMu04/DSHDesktop.git
cd DSHDesktop
npm install
npm run dist

npm run sync:dsh 默认跟随 npm 的 latest 标签。验证官方预发布版本时， 可在 PowerShell 中显式选择版本，避免后续构建无意持续跟随 next：

$env:DSH_VERSION = '0.1.1-rc.2'
npm run sync:dsh

产物位于 dist/。如需复现锁定版本（build/runtime/node-x64.exe 已下载过时可离线完成）：

npm ci
npm run dist:offline

下载源说明：electron-builder 构建时需联网拉取 Electron 发行包与 winCodeSign/NSIS 等工具集。构建脚本在未设置环境变量时默认走 npmmirror 镜像 （ELECTRON_MIRROR / ELECTRON_BUILDER_BINARIES_MIRROR，GitHub 二进制被墙 的网络下也能构建）；已设置的环境变量优先，可自行覆盖为 GitHub 直连或其他镜像。

工作原理

桌面壳启动官方 DSH Web 服务并加载到隔离的 Electron 窗口。后端运行在安装包内置的官方 Node.js 运行时（DSH 的原生目录选择器依赖的 koffi 绑定与 node-pty 输出在 Electron-as-Node 下不可用，因此后端不能借用 Electron 进程）；桌面兼容层只调整 Windows 进程窗口的显示状态，不取消控制台，也不绕过 DSH 的 ACL 沙箱。官方包在磁盘上保持原样。

设置页的配置文件打开请求与目录打开请求由官方 Host 原样处理：官方 opener（Windows Invoke-Item）负责校验和打开，桌面端仅通过后端 preload 在派生 opener 子进程时清除 ELECTRON_RUN_AS_NODE / NODE_OPTIONS，避免这些变量污染 VS Code 等被打开的应用。不会修改官方 Host 或 Web UI 源码。

安全与隐私

• 仅监听 127.0.0.1 上的随机空闲端口。
• Electron 页面关闭 Node 集成，启用上下文隔离与沙箱。
• 非本地链接交给系统默认浏览器打开。
• 不上传、不迁移用户的 DSH 配置、会话、凭据与插件。

相关文档

• plugins/PLUGIN_STANDARDS.md：内置插件开发规范与工作流（插件体系、宿主端 / 客户端契约、集成优先级、部署与生命周期、测试与发布）
• docs/PLUGIN-README-TEMPLATE.md：插件 README 固定格式模板
• docs/TEMPLATES.md：项目文档格式模板
• CHANGELOG.md：全部版本变更记录

声明

本项目是社区维护的非官方桌面封装，与 DeepSeek 无隶属或背书关系。"DeepSeek"、"DeepSeek Harness" 及相关标识归其权利人所有。官方 DSH 使用 MIT License，详见上游项目与第三方声明。

内置工作台（右侧分栏、文件预览、Git 面板等功能集）参考了 DSH-better-sidebar（社区侧边栏工作台），在此向该项目的作者与贡献者致谢。实现按本仓库的插件规范从零编写，未复制其代码；功能边界（如 Git 面板不做 push / fetch、Office 不做内嵌预览）与其保持一致。

自动更新功能（electron-updater 集成与更新元数据发布）由 Can-can2026 贡献（PR #5），在此致谢。

本项目自身代码使用 MIT License。