桌面窗口启动器 kxSenlin/Deepseek-Harness-Window

DshGUI

支持 dsh 0.2.1-rc.2

因为用起来比较稳定就一直没更新

DeepSeek Harness（dsh）的 Windows WPF 启动器：把 dsh web 的界面装进一个原生窗口——双击打开、不用浏览器，并补上浏览器做不到的原生能力（崩溃插件清理、系统托盘、完成通知、全局快捷键、开机自启、权限提醒等）。

技术栈

| 层 | 技术 |
| 界面 | WPF（.NET 10，net10.0-windows） |
| 内嵌内容 | WebView2（Edge 的 Chromium 内核，渲染 dsh 的 Web UI） |
| 架构 | MVVM（ViewModelBase + RelayCommand，无第三方框架） |
| 运行时依赖 | 系统自带的 WebView2 Runtime（Win10/11 默认有）与 Node.js（运行 dsh 需要）；无其他大体积依赖 |

界面

工作原理

1. 启动时检测 dsh 是否已安装（在 PATH 里找 dsh.cmd）或已在运行（轮询设置中指定的端口，默认 http://127.0.0.1:3080）。
2. 未装 Node.js/npm → 加载面板提示「下载 Node.js + 重新检测」。
3. 有 Node.js 但未装 dsh → 加载面板内选择 npm 镜像源（官方 / 国内镜像），一键 npm install -g @deepseek-ai/dsh --registry <源>，安装日志实时滚动。
4. 已装 → 以子进程拉起 dsh --profile <profile> --port <端口> --no-open（默认 web），轮询端口就绪，启动期间面板显示日志与计时；dsh 0.1.2+ 会从输出中解析一次性访问令牌并自动带上。
5. WebView2 打开该地址。
6. WPF 与页面通过 WebView2 的 JS ↔ C# 桥接通信：注入脚本监听 ① 智能体运行状态（data-state="ongoing" / data-running）、② 深色主题（data-ds-dark-theme）、③ 当前会话标题、④ 权限审批（data-approval-key）。

已实现功能

启动、安装与设置

- 原生窗口外观：灰色外轮廓、圆角、阴影；WindowChrome 保留拖拽/缩放/贴边/双击最大化。
- 加载面板：启动/安装/更新期间显示状态文字、不确定进度条、已用计时与滚动日志；日志按 250 毫秒一批刷新（npm 一次吐出上千行也只刷几十次界面，不会卡住），面板切换状态时立刻补刷一次，最后几行不会比状态文字晚到。
- Node.js 前置检测：未装 Node.js 时提示下载官网 + 重新检测。
- 安装引导（内嵌，不弹窗）：选择镜像源 → 立即安装 → 日志滚动 → 自动启动。
- npm 镜像源：官方源 / 国内镜像（npmmirror）可选，安装、更新、检查更新三处共用。
- dsh 端口可配置：默认 3080；避开系统保留端口与常见服务端口，保存时校验端口占用，变更后自动按新端口重启连接；设置面板另有「重启 DeepSeek Harness」按钮，按当前设置（含新端口）一键重启。
- 配置档切换器（标题栏下拉）：选择 $DSH_HOME\profiles 下的配置档（默认 web）启动；切换即停止当前 dsh 并按新配置档重启，不同配置档的会话/插件数据相互隔离。
- 新版 dsh 令牌鉴权兼容：dsh 0.1.2+ 的 Web 访问启用一次性令牌（打印在启动地址 ?token=…）；DshGUI 自己启动的实例自动从输出解析，外部启动的实例则提示粘贴启动地址；0.1.1 及更早版本无令牌，直接兼容。
- 设置面板（内嵌抽屉）：主题 / 镜像源 / dsh 端口 / 忙完通知 / 开机自启 / 全局快捷键录制。
- 检查更新：在设置面板内手动检查；按 SemVer 读取 npm 的 latest 与 next 两个 dist-tag 作为可用更新提示，检查结果附带 npm 上全部已发布版本的下拉列表，可在其中任选一个版本安装（含未打 latest 标签的预览版）；版本号兼容 dsh-v 前缀，本地版本未知时也不会误报「已是最新」。此外会额外查询官方 GitHub Releases：若发现比已装版本更新、且尚未发布到 npm 的版本，会以高亮提示「上游 GitHub 已有新版本，但尚未发布到 npm」，仅供了解、不提供安装入口。更新时先停止 dsh（只停 DshGUI 自己启动的实例），再复用加载面板显示安装日志，完成后自动重启；加载面板同一时刻只归一个流程（启动 / 安装 / 更新）独占，程序刚启动就发起更新时，旧的启动等待会静默退场，不会在 npm 安装中途弹出「启动超时 + 重试」误导点击。

托盘、通知与快捷操作

- 系统托盘：× 缩到托盘、─ 最小化到任务栏；右键菜单「打开 / 插件管理 / 退出」。
- 忙完通知：智能体空闲且窗口最小化/托盘时弹 Toast，带会话标题，点击回主窗口。
- 权限审批提醒：窗口不在前台时弹持久 Toast，点击唤起窗口，审批解决后自动消失。
- 全局快捷键（可录制，默认关）：显示/隐藏窗口。
- 开机自启：在用户 Startup 文件夹创建 DshGUI.lnk 快捷方式（启动时自动清理旧版注册表项）；可选「静默到托盘」——窗口从不显示（零闪屏），dsh 在后台启动，托盘打开时看到加载进度。
- 单实例：二次启动打开已有窗口。

插件管理

- 操作台（标题栏拼图按钮）：独立窗口查看各配置档实际加载的插件行（id/name/来源/实体/状态）。
- 屏蔽 / 解除屏蔽：运行中的 dsh 先弹红色停止按钮，内置核心行有启动失败警告，修改后提示手动重启。
- 卸载：官方依赖走 dsh plugin remove，手工插件同步删除实体与 patch 引用，内置行只提供屏蔽。
- 插件包导出 / 导入：.dshpkg 携带入口配置与本地插件源码；导入前显示重名与新增列表，可在弹窗中选择目标 Profile，已有插件不替换，本地插件离线恢复。
- 会话内撤销：卸载前完整暂存 profile，冲突文件会列出并确认；DshGUI 退出后撤销副本清理。
- 离线恢复：dsh 因插件崩溃/卡死时仍可按入口文件盘点，屏蔽或卸载可疑插件后重启；bundle 声明多个 patch 文件时（如 @deepseek-ai/dsh-web-app 的主 patch + 若干 preset）按声明顺序逐个组合，与 dsh 自身的加载顺序一致。

界面与状态

- 深色/浅色主题（跟随系统/浅色/深色）：壳标题栏 ↔ 网页主题联动；插件管理弹窗标题栏与滚动条同样跟随。
- 窗口置顶（标题栏图钉）。
- 标题栏实时显示当前会话名。
- 记住状态：窗口大小/位置/是否最大化 + 上次主题。
- 应用图标 / 托盘图标（dsh 鲸鱼 logo，多尺寸 .ico）。

使用指南

首次启动

1. 双击运行 DshGUI。
2. 程序自动检测 Node.js 与 dsh：
- 未装 Node.js → 点「下载 Node.js」前往官网装 LTS 版，装完点「重新检测」。
- 未装 dsh → 在面板里选镜像源（默认官方，网络慢可选国内镜像），点「立即安装」，等日志滚动到「安装完成」后自动进入界面。

日常使用

- 关闭按钮 × 缩到系统托盘（后台继续运行）；托盘右键菜单可「打开 / 插件管理 / 退出」。
- 标题栏图钉可让窗口始终置顶。
- 当前会话名会实时显示在标题栏。

通知与权限

- 忙完通知：智能体空闲且窗口最小化/在托盘时，右下角弹提示，点击回主窗口。
- 权限审批：dsh 请求权限且窗口不在前台时，右下角弹持久提示，点击回到窗口处理；批准后提示自动消失。

设置

- 点标题栏齿轮打开右侧抽屉，可设置：主题（跟随系统/浅色/深色）、npm 镜像源、dsh 端口、忙完通知、开机自启（可勾选「静默到托盘」）、全局快捷键（点「录制」后按组合键）。
- dsh 端口默认 3080；系统保留端口与 RDP/数据库等常用服务端口会被拒绝，新端口已被占用时保存会弹窗确认。
- 标题栏下拉可切换 dsh profile（切换会重启 dsh）。
- 设置页可「关闭 / 重启 DeepSeek Harness」：只影响 DshGUI 自己启动的实例；外部手动启动的 dsh 不会被停止。

插件管理

- 点标题栏拼图按钮或托盘菜单「插件管理」打开操作台。
- 左侧是入口文件实际加载的插件行；右侧「已安装依赖」列出 package.json.dependencies，bundle 包会生成左侧插件行，普通依赖只能从右侧卸载。
- 选中插件行可「屏蔽 / 解除屏蔽」：运行中的 dsh 会先弹红色「停止 DeepSeek Harness」按钮；内置核心行有启动失败警告；写 profile（或 home）的 cordis.patch.yml，完成后提示手动重启 dsh。
- 选中依赖或手工插件行可「卸载」：官方依赖走 dsh plugin remove，手工行同步删实体与 patch 引用；内置行只提供屏蔽。
- 「导出插件包」把入口配置与本地插件源码打成 .dshpkg，不打包 node_modules；「导入插件包」先做格式自检，再显示重名/新增列表，勾选要导入的插件并选择目标 Profile；已有插件不替换，本地插件离线恢复，远程插件按 lockfile 重建。
- 导入前会备份当前 Profile，自动保留最近 5 份，更早的备份自动清理。
- 右侧「本会话卸载记录」可撤销本次 DshGUI 运行期间的卸载；卸载后文件被改动时，撤销前会列出变化文件并要求确认；DshGUI 退出后撤销副本清理。
- dsh 启动失败/卡死时，操作台仍按入口文件离线盘点，可先屏蔽可疑插件再重启。
- 底部日志与上方列表之间有分隔条，可上下拖动调整高度。

目录结构

DshGUI/
├── DshGUI.slnx
└── DshGUI/
├── DshGUI.csproj
├── App.xaml / App.xaml.cs 入口、单实例、托盘、退出 ├── GlobalAliases.cs 消解 WinForms 与 WPF 的同名类型 ├── Assets/App.ico 应用图标（由 dsh 的 favicon.svg 生成） ├── Models/ │ ├── AppSettings.cs 持久化设置模型 │ ├── PluginModels.cs 插件行/卸载分类/撤销记录 │ └── PluginPackageModels.cs 插件包清单与导入预览 ├── ViewModels/ │ ├── ViewModelBase.cs INotifyPropertyChanged 基类 │ ├── MainViewModel.cs 主窗口状态 │ ├── SettingsViewModel.cs 设置面板（含快捷键录制） │ └── PluginManagerViewModel.cs 插件操作台状态与命令 ├── Views/ │ ├── MainWindow.xaml(.cs) 无边框壳 + 标题栏 + 加载面板 + WebView2 + Win32 钩子 │ ├── SettingsView.xaml(.cs) 内嵌设置抽屉 │ ├── PluginManagerWindow.xaml(.cs) 插件操作台窗口 │ ├── PluginConfirmDialog.xaml(.cs) 危险操作确认/插件名输入 │ ├── PluginNoticeDialog.xaml(.cs) 醒目提示弹窗 │ ├── PluginStopDshDialog.xaml(.cs) 停止 DeepSeek Harness 确认弹窗 │ ├── PluginImportPreviewDialog.xaml(.cs) 插件包导入预览与勾选 │ └── ToastWindow.xaml(.cs) 右下角通知 ├── Services/ │ ├── DshService.cs dsh/Node 检测、安装（镜像源+进度）、端口配置、拉起、日志 │ ├── DshPaths.cs DSH_HOME、配置档、dsh 安装根、模块解析 │ ├── DshCliService.cs dump-config / plugin remove / plugin install │ ├── PatchDocument.cs cordis.patch.yml 行级解析与编辑 │ ├── PluginInventory.cs 离线组合 + dump-config 事实解析 │ ├── PluginManagerService.cs 屏蔽/卸载/撤销流程与暂存 │ ├── PluginPackageService.cs .dshpkg 导出/导入/预览 │ ├── PluginInventoryBaseline.cs 跨运行首次盘点基线 │ ├── ProfileManifestEditor.cs package.json 最小编辑 │ ├── DshFileSystem.cs junction/hardlink/原子写/哈希规则 │ ├── ThemeService.cs 主题解析 + WebView2 联动 │ ├── TrayService.cs 托盘图标 + 右键菜单 │ ├── NotificationService.cs 通知队列（右下角纵向堆叠） │ ├── UpdateService.cs npm 版本检查（SemVer，含 rc/alpha 预发布比较与更新列表） │ ├── AutoStartService.cs 开机自启（Startup 文件夹快捷方式） │ ├── SingleInstanceService.cs 单实例（Mutex + 事件聚焦） │ ├── DiagnosticLog.cs 落盘日志：入队即返回，后台线程批量写 │ └── SettingsService.cs %LOCALAPPDATA%\DshGUI\settings.json 读写 └── Infrastructure/ ├── RelayCommand.cs ICommand 实现 ├── IconHelper.cs 从 exe 提取图标 └── ThrottledLogSink.cs 日志攒批：250 毫秒一批刷给界面

说明与已知边界

- WPF 自身配置存 %LOCALAPPDATA%\DshGUI\settings.json，与 dsh 的 ~/.dsh 隔离。
- 日志统一写入 %LOCALAPPDATA%\DshGUI（dsh.log + app.log，含 webview/plugin 分类）：调用方只入队（微秒级，不做文件 IO），后台线程每 200 毫秒批量落盘一次、写完就松开句柄；超阈值自动清空覆盖以防无限增长（单个文件：会话内首次写时超过 2 MB 清空，会话累计超过 10 MB 再清空）；队列溢出或写不进去时只丢日志并在 app.log 记一笔，不阻塞也不影响运行。WebView2 初始化只执行一次、后续复用结果，避免重复初始化卡住。
- 会话标题、运行状态、主题、权限审批靠读取 dsh 页面的 DOM 信号；dsh 是开发者预览版，若其前端结构变动，这些信号可能失效（不会崩）。
- 全局快捷键默认关闭；录制后即时生效。
- 端口可在设置中修改（默认 3080）；端口被占用时会提示，系统保留端口与常见服务端口会被拒绝。
- dsh 0.1.2+ 的 Web 访问需要一次性令牌：DshGUI 自动解析自己启动的实例；外部实例请在提示框粘贴其启动地址（含 ?token=）。
- 本项目为非官方项目；DeepSeek 及相关商标归其权利人所有。