便携单文件版 CharonMac/dsh-portable

DeepSeek Harness 便携版(单文件 exe)

把 DeepSeek Harness 完整打包成一个 105MB 的单文件 exe。内置安装向导 + 启动器:
安装时可选择位置、自动创建桌面图标,启动后用独立应用窗口打开界面(不用浏览器)。

文件

- DeepSeekHarness.exe — 主程序(安装器 + 启动器二合一)
- cat.ico — 应用图标(exe 和桌面快捷方式使用)
- src\Program.cs — C# 启动器源码(如需修改可重新编译)
- build.ps1 — 一键打包脚本
- bundle.zip — 内部依赖包(启动器 + zip + 长度标记 = 最终 exe)

安装(第一次双击)

1. 双击 DeepSeekHarness.exe
2. 弹出安装向导,选择安装位置(默认 %LOCALAPPDATA%\DeepSeekHarnessPortable)
3. 自动解压组件(约 40 秒,首次需要)
4. 自动在桌面创建"DeepSeek Harness"图标
5. 自动启动并打开界面

日常使用

- 双击桌面图标即可启动,界面以独立应用窗口打开(Edge 应用模式, 没有地址栏/标签页,像原生软件;Edge 不可用时自动改用默认浏览器)
- 运行后托盘出现小猫图标:打开界面 / 打开数据目录 / 打开命令行(含 Git) / 退出
- 再次双击(或从托盘打开)不会重复启动服务,只是重新打开窗口
- 重启电脑后,双击桌面图标即可

内置 Git(可选组件)

便携版可内置免安装的 git(MinGit),随包一起分发,无需在系统里安装 git:

- 打开命令行(含 Git):托盘菜单 → 打开命令行(含 Git),弹出 cmd 窗口, 工作目录 = workspace,可直接使用 git 命令
- dsh 服务进程的 PATH 也已包含内置 git,项目内的 git 操作开箱即用
- 首次使用请先配置身份(在命令行里执行一次):

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

- 如何打包进 git:下载 MinGit zip(约 50MB,见下方链接),解压后把 cmd、mingw64 等顶层内容放到 build\app\git\ 目录,再运行 build.ps1 重新打包:

build\app\git\cmd\git.exe ← 存在即表示已内置

MinGit 下载地址(任选):
- 官方:<https://github.com/git-for-windows/git/releases> → 选 MinGit-*-64-bit.zip
- 国内镜像:<https://registry.npmmirror.com/-/binary/git-for-windows/>

上传项目到 GitHub

1. 在 GitHub 创建个人访问令牌(PAT),不要用账号密码(GitHub 已不支持密码认证): GitHub → Settings → Developer settings → Personal access tokens → 生成新 token, 勾选 repo 权限,复制 token
2. 在 Git 命令行里保存凭据(只需一次,token 只保存在本机):

git config --global credential.helper store

3. 推送时用户名填 GitHub 用户名,密码框粘贴 token 即可;后续推送不再询问

首次使用

- 在 Web 界面里配置模型 API Key(设置 → 模型)
- 数据目录默认在安装位置,可删可挪

高级选项

| 环境变量 | 作用 |
| DSH_PORTABLE_BASE | 指定数据/解压目录(默认 exe 所在目录) |

| 命令行参数 | 作用 |
| --port 3080 | 指定 Web 端口(默认 3080) |
| --extract-only | 只解压不启动(测试用) |

开机自启

把桌面快捷方式复制一份到 shell:startup 文件夹即可 (Win+R → 输入 shell:startup → 回车 → 把快捷方式粘贴进去)。

卸载

1. 托盘图标右键 → 退出
2. 删除安装目录(整个文件夹)
3. 删除桌面快捷方式

技术说明

- 自解压原理:exe = C# 启动器(18KB,含图标) + 依赖 zip(105MB) + 4 字节长度标记
- 双模式:未安装 → 安装向导;已安装(exe 旁有 install.info)→ 启动器
- 启动器把 zip 解压到安装位置,然后隐藏窗口启动 node.exe + dsh web
- 界面窗口:Edge --app 应用模式(独立窗口、无浏览器 UI),失败自动回退浏览器
- 依赖树包含 Node.js 运行时(v24) + dsh 全部 246MB 依赖 + Web 前端产物
- profile 的 node_modules 使用 junction 指向解压目录,完全自包含、离线可用
- 单实例:重复双击只会重新打开窗口,不会起第二个服务

重新打包(开发者)

1. 生成图标(可选,已生成 cat.ico)
csc makeicon.cs && makeicon.exe cat.ico

2. 编译启动器(系统自带 csc,无需安装 .NET SDK) csc /nologo /target:winexe /win32icon:cat.ico /out:DeepSeekHarnessLauncher.exe /r:System.dll /r:System.Windows.Forms.dll /r:System.Drawing.dll /r:System.IO.Compression.dll /r:System.IO.Compression.FileSystem.dll src\Program.cs

3. 打包依赖 + 合并 → 直接运行 build.ps1 一步到位 powershell -ExecutionPolicy Bypass -File build.ps1

目录结构(安装后)

<安装目录>/ ├── DeepSeekHarness.exe # 启动器(桌面快捷方式指向这里) ├── install.info # 安装标记 ├── app\ # 完整运行环境(node.exe + node_modules + 前端) ├── home\ # DSH_HOME:profiles / sessions / 配置 ├── workspace\ # 默认工作目录 └── launcher.log # 启动日志(排查用)