DSH-Desktop-Huacai (DeepSeek Harness Desktop)

DeepSeek Harness 桌面客户端 —— 自包含单文件启动器：内置 Node.js 运行时与 dsh 应用，双击即用，目标电脑无需安装任何依赖。

项目简介

DSH-Desktop-Huacai 是一个基于 DeepSeek Harness 的自包含桌面客户端。启动器（C# / Windows Forms）将便携版 Node.js 运行时、dsh 应用与插件打包进单个 exe，双击后自动完成解压、配置引导、插件安装与服务启动，并在浏览器中打开 dsh 界面。

主要功能

• 自包含免安装：exe 内置便携版 Node.js 运行时与完整 dsh 应用，全程离线可用
• 一键启动：双击 exe → 自动解压内置运行时（仅首次）→ 引导 profile → 安装插件 → 启动 dsh web → 打开界面
• 启动器管理：自动检测与启动 DeepSeek 服务端；解压进度条 + 加载遮罩，不黑屏等待
• 自定义皮肤：一键切换浅色主题，5 套预设主色调（粉/蓝/绿/紫/橙）+ 自定义取色器；可选照片背景（内置默认图或上传 ≤15MB）、半透明面板、AI 回复毛玻璃卡片；设置自动保存
• 归档管理：侧边栏「归档」集中查看/恢复/彻底删除归档会话，与 dsh 原生操作实时联动
• 插件系统：内置编辑器插件（dsh-editor）、更新检查插件（dsh-updater）等 @local 插件
• 应用内更新：设置 → 通用设置中一键检查并更新 dsh 核心（npm 官方源，失败自动切换镜像），失败自动回滚
• 托盘驻留：关闭窗口最小化到托盘，服务不中断；右键托盘可"打开界面"或"停止并退出"
• 浏览器集成：支持无地址栏的应用窗口模式，或系统默认浏览器

技术架构

• 启动器：C# / Windows Forms（.NET Framework 4.x，使用系统内置 csc 编译）
• 运行时：内置便携版 Node.js（含 npm）
• 应用内核：DeepSeek Harness（dsh）web 应用
• 插件系统：基于 @local 命名空间的本地插件架构
• 构建工具：PowerShell 脚本（build.ps1）+ 自举打包流程

目录结构

├── src/
│   └── Launcher.cs              # 启动器核心逻辑（C#）
├── tools/
│   ├── icon-gen.cs              # 图标生成工具
│   ├── zipdir.cs                # ZIP 打包工具
│   ├── pack-exe.mjs             # exe 组装脚本
│   ├── parse-payload.mjs        # 内嵌载荷解析/校验
│   └── test-*.{cs,mjs}          # 测试工具
├── dsh-bundle/
│   ├── apply-update.mjs         # 更新应用脚本
│   ├── install-skin-plugin.mjs  # 皮肤安装脚本
│   └── plugin/@local/
│       ├── dsh-editor/          # 编辑器插件
│       └── dsh-updater/         # 更新检查插件
├── build.ps1                    # 构建脚本（产出 exe）
├── run-test.ps1                 # 测试脚本
├── merge-exe-parts.bat          # 合并分卷，还原发布版 exe
├── DSH-Desktop-Huacai-1.11.exe.part1/.part2  # 发布版分卷（各 <100MB）
├── 使用说明.md / 更新文档.md / 新增功能说明.md
└── LICENSE

注：皮肤/归档插件不在仓库源码目录中，构建时由 build.ps1 从上一版 exe 的内嵌载荷继承（自举构建）。

获取发布版

Gitee 免费仓库单文件上限 100MB，发布版 exe（约 123MB）拆为两个分卷提交。获取方式：

git clone https://gitee.com/huacaicaicai/dsh-desktop-huacai.git
cd dsh-desktop-huacai
# 合并分卷（也可直接双击 merge-exe-parts.bat）：
copy /b "DSH-Desktop-Huacai-1.11.exe.part1" + "DSH-Desktop-Huacai-1.11.exe.part2" "DSH-Desktop-Huacai-1.11.exe"

合并后双击 DSH-Desktop-Huacai-1.11.exe 即可运行（Windows 10/11，无需安装任何东西）。

合并前请确保该 exe 未在运行；分卷完整性已验证（合并哈希与原文件一致）。

从源码构建

构建机需要：Windows、.NET Framework 4.x（含系统 csc）、Node.js。

powershell -ExecutionPolicy Bypass -File build.ps1 -OutExe DSH-Desktop-Huacai-1.11.exe

脚本流程：提取上一版 exe 的内嵌插件（自举构建）→ 叠加 dsh-bundle\ → 打包内置 Node 运行时 → 从 npx 缓存复制最新 dsh（或 -FreshApp 走 npm）→ 编译启动器 → 组装新 exe。

内嵌载荷布局或版本变化时，必须同步提升 src\Launcher.cs 中的 EMBEDDED_VERSION。

配置说明（launcher.json）

在 exe 同目录放一个 launcher.json 可覆盖默认值（可选）：

字段	说明	默认值
port	dsh web 端口	3080
openBrowser	就绪后自动打开界面	true
appMode	浏览器"应用窗口"模式（无地址栏）	true
browserExe	指定浏览器 exe 完整路径（留空自动查找）	null
dshHome	DSH_HOME 目录（默认 ~/.dsh）	null

内置功能（@local 插件）

四大内置功能（皮肤、归档、更新、编辑器模式）均为 exe 内嵌的 @local 插件，首次启动自动装入 profile，开箱即用；数据（会话/工作区/密钥/设置）不受影响。

🎨 皮肤（浅色主题）

入口：设置（左下角）→ 皮肤

• 一键启用浅色主题；5 套预设主色调（粉/蓝/绿/紫/橙）+ 自定义取色器，配套悬停色、气泡色、面板底色自动衍生
• 可选照片背景：内置默认背景图，或上传本地图片（≤15MB）
• 半透明面板透明度调节（滑杆 0.15–0.95）；AI 回复毛玻璃卡片
• 设置自动保存至 ~/.dsh/dsh-skin.json，刷新/重启均保留

📦 归档（归档会话管理）

入口：侧边栏底部「归档」按钮（设置上方）

• 集中查看所有已归档会话（标题、工作区、更新时间、运行状态），与别处归档/恢复/删除操作实时联动刷新
• 恢复：一键将归档会话移回侧边栏原位置（幂等）
• 彻底删除：输入标题确认后删除存档，不可恢复；运行中的会话双重保护（前端禁用 + 后端 409 校验）

📝 编辑器模式（dsh-editor）

入口：侧边栏底部「编辑器模式」，三栏布局（左侧文件树 + 中间编辑器 + 右侧对话），随时切回默认对话模式

• 文件树浏览/切换工作区；直接编辑文件，Ctrl+S 写回磁盘；未保存标记与切换确认
• 语法高亮支持 30+ 语言（JS/TS/Python/Rust/Go/Java/C/C++/C#/SQL/HTML/CSS/Shell/YAML 等），超大文件自动关闭高亮保证流畅
• 只读写当前工作区目录内的文件，路径越界防护

🔄 应用内更新（dsh-updater）

入口：设置 → 通用设置 →「DeepSeek Harness 更新」

• 检查 npm 官方最新版（失败自动切换 npmmirror）；一键下载安装并自动重启，无需重装 exe
• 失败自动回滚旧版本；离线电脑仍可正常使用（仅无法在线更新）

文档

• 使用说明：使用说明.md
• 更新机制、重新构建步骤与常见问题：更新文档.md
• 本次桌面版新增功能：新增功能说明.md

开源协议

本项目遵循开源协议，具体信息请参考仓库中的 LICENSE 文件。

相关链接

• 项目地址：https://gitee.com/huacaicaicai/dsh-desktop-huacai
• DeepSeek 官网：https://deepseek.com
• 问题反馈：https://gitee.com/huacaicaicai/dsh-desktop-huacai/issues