桌面客户端 KhanZou/Deepseek-Harness-as-Desktop

DeepSeek Harness as Desktop（桌面客户端）

把 DeepSeek Harness 变成 Codex 式桌面应用：原生 WebView2 窗口、系统托盘常驻、开机自启、真实 Windows Toast，并附带一组 DSH 插件：桌面设置页、独立卡片式皮肤中心、可复用的右侧/底部面板框架、Git 图谱、文件/变更浏览、迷你终端与逐轮令牌统计。

English README

功能

- 🖥️ 原生 WebView2 壳（DshDesktop.exe，C# WinForms + WebView2，x64）——独立应用窗口内嵌 DSH Web UI。
- 🚀 一键启动——exe 检测后端（127.0.0.1:3080）；未运行时自动后台启动 corepack pnpm dsh web。
- 🧭 托盘常驻——最小化/关闭隐藏到系统托盘后台运行；托盘菜单"打开 / 退出"。仅当 exe 自己启动了服务时，退出才会一并停止服务。
- 🔁 开机自启动——可选 HKCU Run 注册。
- 🔔 真实 Windows Toast——任务完成通知进入操作中心（AUMID 注册的无包 Toast），失败回退托盘气泡。
- ⚙️ DSH Web 设置里的"桌面客户端"tab——管理关闭按钮行为、开机自启、会话通知；已本地化（zh/en），跟随 DSH 语言切换。
- 🧩 统一桌面框架——单个插件 dsh-desktop-framework 合并了原 settings/panels 框架与右侧面板：任意插件可用 registerTab/registerItem/get/set/subscribe 声明式添加设置 tab/条目，也可用 registerPanel 注册右侧/底部面板 tab，带持久化与跨插件同步（见 docs/settings-framework.md 与 docs/panels-framework.md）。
- 🎨 独立皮肤中心——独立的 皮肤中心 设置 tab（独立插件 dsh-skin-gallery）：现代预览卡片式——每张卡片用真实主题 token（不硬编码颜色）绘制一个迷你应用窗口缩略图（侧栏、聊天气泡、输入条与品牌色发送按钮），皮肤提供 accent 时使用其强调色；卡片显示名称/作者/描述，当前皮肤带 ✓ 角标，支持 全部/内置/皮肤 筛选。点击卡片即应用，持久化 activeSkin 并自动刷新。
- 📐 右侧/底部面板框架——属于 dsh-desktop-framework：渲染右侧栏与底部栏，带 tab、一键折叠/展开把手、拖拽调宿、状态持久化；任意插件可注册面板 tab（见 docs/panels-framework.md）。
- 📁 文件与变更面板——右侧面板 文件 tab（文件树 + 文本/图片预览）与 变更 tab（git status + stage/unstage/discard）。
- 💻 迷你终端——底部面板 终端 tab：在 harness 目录执行命令（支持 cd），由桌面客户端后端驱动。
- 🖼️ 多类型查看器——右侧面板是多标签工作区：可在可关闭的 tab 中打开 Markdown（GitHub 风格渲染）、代码/文本、图片（缩放）、视频（支持拖动进度）、PDF、网页与 3D 模型（WebGL STL/OBJ）；拖拽左边缘可调宽度。
- 🔗 会话超链接——对话输出里的 URL 与文件路径自动变成可点击链接：左键选择打开方式，右键菜单含「桌面端打开 / 系统默认应用 / 复制链接」。
- ⚙️ 按类型打开偏好——设置面板新增「文件打开」页，可按文件类型选择优先「桌面端打开」「系统默认应用」或「每次询问」。
- 🌿 Git 图谱视图——对话视图新增第四个 tab（对话 / 轨迹 / Git 图谱）：分支选择器、切换分支、提交历史泳道图。
- ⚡ 实时令牌统计——每条回答下方显示 TPS、LLM 耗时、输入/输出 token、缓存命中 token（提供商上报时）。
- 🔌 纯插件架构——全部以 DSH 插件（dsh-plugin）形式分发。

目录结构

Deepseek-Harness-as-Desktop/
├── dsh-desktop-window/ # 宿主插件 + 桌面客户端 │ ├── lib/index.js # DSH 宿主插件：窗口拉起、turn/end Toast、皮肤清单 │ └── shell/ # DshDesktop.exe + 源码 + WebView2 SDK + Toast 脚本 + whale.ico ├── dsh-desktop-settings/ # 客户端插件：桌面设置页（关闭行为/自启/通知） ├── dsh-desktop-framework/ # 统一桌面框架：设置 + 面板 + 文件/变更/终端 ├── dsh-skin-gallery/ # 独立卡片式皮肤中心（独立设置 tab） ├── dsh-git-graph/ # Git 图谱对话视图（分支选择 + 提交泳道） ├── dsh-live-stats/ # 逐轮令牌统计行 └── docs/ # skin-compatibility / settings-framework / panels-framework

环境要求

- Windows 10/11（x64）
- Node.js 22.19+ 或 24+，corepack 启用的 pnpm
- Microsoft Edge WebView2 Runtime（多数系统已预装）
- 一份 DeepSeek Harness 源码检出

路径约定：桌面客户端与插件可重定位——配置、数据、脚本路径均从自身位置推导。唯一与机器相关的路径是 DeepSeek Harness 检出目录，默认为 D:\deepseek harness，可通过 config.json 的 serverWorkDir 键按安装修改，或用 --workdir 启动参数覆盖。

快速开始

1. 准备 Harness（一次性）：
git clone https://github.com/deepseek-ai/deepseek-harness.git "D:\deepseek harness"
cd /d "D:\deepseek harness"
corepack pnpm install
corepack pnpm run build

2. 放置应用——把 dsh-desktop-window 文件夹复制到任意位置（如 D:\dsh-desktop-window），双击 dsh-desktop-window\shell\DshDesktop.exe （或用 Program.cs 自行编译，见下文）。它会按需启动后端并打开原生窗口。

3. 安装插件到 web profile。本仓库自带全部六个插件——每个插件是仓库根目录下的一个文件夹(dsh-desktop-window/、dsh-desktop-settings/、dsh-desktop-framework/、dsh-skin-gallery/、dsh-git-graph/、dsh-live-stats/)。把 add 指向对应文件夹（可把文件夹复制到任意位置，或直接用本仓库内的路径）：
cd /d "D:\deepseek harness"
corepack pnpm dsh plugin --profile web add D:\dsh-desktop-window
corepack pnpm dsh plugin --profile web add D:\dsh-desktop-settings
corepack pnpm dsh plugin --profile web add D:\dsh-desktop-framework
corepack pnpm dsh plugin --profile web add D:\dsh-skin-gallery
corepack pnpm dsh plugin --profile web add D:\dsh-git-graph
corepack pnpm dsh plugin --profile web add D:\dsh-live-stats

重启桌面应用后：
- 设置 → 桌面客户端——关闭行为、开机自启、会话通知。
- 设置 → 皮肤中心——现代预览卡片式皮肤（迷你窗口缩略图按真实主题绘制），切换自动刷新。
- 会话头部 ◧ ◨ ▤ 按钮——一键折叠/展开右侧面板与底部终端。
- 对话标签——对话 / 轨迹 / Git 图谱。
- 每条回答下方出现实时令牌统计。

宿主插件（dsh-desktop-window）可选但推荐：负责 turn/end Toast 与刷新 skins.json。桌面应用自己启动后端时会通过 DSH_DESKTOP_AUTO=0 关闭重复开窗。

配置

配置保存在 D:\dsh-desktop-window\config.json：

| 键 | 取值 | 说明 |
| closeBehavior | tray（默认）/ exit | 关闭按钮行为 |
| autoStart | true / false | 开机自启动（HKCU Run） |
| notifyOnComplete | true / false | 任务完成 Toast |
| activeSkin | 皮肤 id 或 "" | 皮肤中心选择（"" = DSH 默认） |
| apiPort | 3980 | 本地配置 API 端口 |
| serverWorkDir | D:\deepseek harness | 作为后端启动的 Harness 检出目录 |
| panelRightOpen / panelBottomOpen | true / false | 面板开关状态（面板框架持久化） |
| panelRightWidth / panelBottomHeight | px | 面板尺寸（面板框架持久化） |

桌面设置页通过 exe 的本地 HTTP API（127.0.0.1:3980，CORS 开放）写入这些配置：

| 端点 | 说明 |
| GET /api/config | 读取配置 |
| POST /api/config {key,value} | 更新配置 |
| GET /api/skins | 皮肤清单（默认 + 已装皮肤） |
| POST /api/notify {title,message} | 发送真实 Windows Toast |
| GET/POST /api/settings {key,value} | 通用键值设置（框架后端） |
| GET /api/fs/list?dir= | 列目录（文件/文件夹 + 大小） |
| GET /api/fs/read?path= | 读取文本文件（图片返回 data URL 预览） |
| GET /api/git/branches?dir= | 分支列表 + 当前分支 |
| GET /api/git/log?dir=&branch=&limit= | 提交历史（hash/父提交/作者/日期/主题） |
| GET /api/git/status?dir= | Porcelain 状态（分支 + 变更） |
| POST /api/git/checkout {dir,branch} | 切换分支 |
| POST /api/git/stage|unstage|discard {dir,path} | 暂存/撤销/丢弃（path 为 . 表示全部） |
| GET /api/shell/cwd | 当前终端工作目录 |
| POST /api/shell/exec {dir,command} | 执行命令（cmd.exe）；cd 更新工作目录 |

皮肤中心与皮肤兼容

皮肤中心（独立设置 tab，dsh-skin-gallery，排列在所有原生设置 tab 之后）是几选一卡片选择器：DSH 本体内置默认 + 所有已装皮肤插件。每张卡片用实际主题 token 绘制一个迷你应用窗口缩略图（无硬编码颜色）——侧栏、聊天气泡、输入条与品牌色发送按钮——当清单提供皮肤 accent 时使用其强调色，否则回退到当前主题。当前皮肤带 ✓ 角标，卡片悬停浮起，支持 全部/内置/皮肤 筛选。
选中后持久化 activeSkin 并自动刷新；每次启动只保留选中的皮肤挂载。

第三方皮肤不打进包里。要让皮肤出现在选择器中，需在包旁提供 skin.json 并用 dsh plugin --profile web add 注册。完整约定见 docs/skin-compatibility.md。

推荐皮肤

- 深海女仆工坊 / Abyssal Maid Atelier（Small-tailqwq，CC BY-NC-SA 4.0）——双女仆背景、深海蓝蕾丝 UI、Q 版侧栏。安装：
git clone https://github.com/Small-tailqwq/dsh-deep-whale "D:\dsh-deep-whale"
corepack pnpm dsh plugin --profile web add D:\dsh-deep-whale\maid-atelier

面板（右侧栏 + 底部终端）

dsh-desktop-framework 渲染面板壳并注册 Files/Changes/Terminal tab 与头部开关。右侧面板与左侧边栏共用同一填充（--dsw-specific-sidebar-fill），面板按钮/tab 复用应用原生按钮 token，跟随主题。
会话头部（模式选择旁）的 ◧ / ◨ 与 ▤ 按钮可一键折叠/展开右侧面板与底部终端；折叠后变成右侧/底部的细长把手，点击即可展开。拖拽面板边缘可调整大小；宽度/高度与开关状态都会持久化。其他插件也可注册自己的面板 tab （见 docs/panels-framework.md）。

查看器与文件打开

右侧面板是多标签工作区（dsh-desktop-framework）。从「文件」tab 或会话链接打开的文件会在可关闭的 tab 中渲染：

| 类型 | 查看器 |
| Markdown | GitHub 风格渲染 |
| 代码 / 文本 | 等宽字体、自动换行 |
| 图片 | 图片查看器（滚轮 / +- 缩放） |
| 视频 | HTML5 播放器（支持拖动进度，基于 byte-range） |
| PDF | Chromium 内置 PDF 查看器 |
| HTML | iframe 渲染为真实网页（相对 css/js/图片由桌面客户端经 /serve/ 提供） |
| 网页 | iframe |
| 3D（STL/OBJ） | WebGL 查看器——拖拽旋转、滚轮缩放 |

网页支持三种形式，均在 iframe 中渲染：本地 .html 文件（由 DshDesktop.exe 经 /serve/ 提供，相对资源可正常解析）、本地端口页面（http://127.0.0.1:）、以及公网 URL。HTML 文件默认在桌面端查看器中打开；可在「文件打开」设置页按类型修改。

左键点击会话链接可选择「桌面端打开 / 系统默认应用 / 复制链接」，右键菜单提供相同操作。「文件打开」设置页可分别设置每类文件的默认打开方式（每次询问 / 桌面端打开 / 系统默认应用）。系统默认应用/浏览器打开由桌面客户端（DshDesktop.exe）的本地 API 完成。

CLI（测试用）

dsh-desktop-framework 附带一个无依赖的 Node CLI，方便在不开 UI 的情况下测试插件与桌面客户端 API：

cd D:\dsh-desktop\dsh-desktop-framework
node cli.js check # 健康检查 web(3080) + 桌面 api(3980)
node cli.js raw [range] # 拉取 /api/fs/raw（支持 byte-range）
node cli.js open # 用系统默认应用打开
node cli.js open-url # 用默认浏览器打开
node cli.js settings [k [v]] # 读写桌面设置存储
node cli.js type # 打印文件的查看器类型
node cli.js samples [dir] # 生成 md/stl/pdf 示例文件

从源码编译壳

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe /nologo /target:winexe /platform:x64 ^
/win32icon:dsh-desktop-window\shell\whale.ico ^
/resource:dsh-desktop-window\shell\whale.ico,DshDesktop.whale.ico ^
/out:dsh-desktop-window\shell\DshDesktop.exe ^
/r:dsh-desktop-window\shell\Microsoft.Web.WebView2.Core.dll ^
/r:dsh-desktop-window\shell\Microsoft.Web.WebView2.WinForms.dll ^
/r:System.dll /r:System.Core.dll /r:System.Drawing.dll /r:System.Windows.Forms.dll /r:System.Web.Extensions.dll ^
dsh-desktop-window\shell\Program.cs

本地化

所有 UI 插件通过 DSH 客户端 locale 服务注册 zh/en 词典，跟随 Harness 的语言切换。Toast 消息双语。

更新日志

见 CHANGELOG.md。

许可证与第三方声明

- 我们的代码：MIT（LICENSE）。
- Microsoft.Web.WebView2.Core.dll / WinForms.dll / WebView2Loader.dll： Microsoft Edge WebView2 SDK（MIT），按许可再分发。
- whale.ico：DeepSeek 官方鲸鱼图标（衍生自 harness 仓库 apps/web/public/favicon.svg），仅用于标识 DeepSeek Harness 应用。
- 第三方皮肤（如深海女仆工坊）保留各自许可证，不随包分发。