本地服务启动器cb2612129/dsh-butler

DSH 启动器 · DSH Butler

给 DeepSeek Harness (DSH) 本地 Web 服务用的图形化启动器 —— 双击图标就能启动 / 停止 / 重启服务，
不用每次都回到命令行敲 dsh web。

窗口标题栏上显示的是「DSH 管家」，那是程序内部的叫法，跟这里是同一个东西。

当前版本 v3.0 · Windows 10 / 11 · 系统自带 PowerShell 5.1 · 零第三方依赖（不装 Node 包、不装运行库）

主界面

它能做什么

- 一键启停：启动服务 / 停止服务 / 重启服务 / 打开页面，四个大按钮
- 状态一眼看到：运行中还是已停止、端口、进程 PID、已经跑了多久
- 浏览器随便选：主界面一排图标，点哪个「打开页面」就用哪个（自动列出系统里装了的浏览器）
- 双主题：白天米黄 / 夜间石墨，可以手动切、也可以跟随时间（7:00–19:00 白天）
- 常驻托盘：点 × 只是收到右下角，服务继续跑；托盘图标带状态点，悬停显示运行时长
- 开机自启：管家自身、以及顺便把 DSH 服务拉起来，都能在设置里开关
- 守护模式：服务意外挂了自动重启（每 30 秒检查一次）
- 顺手的小入口：左下角两个小鲸鱼按钮，直达 DeepSeek 网页版和平台用量页

环境要求

| 需要什么 | 说明 |
|---|---|
| Windows 10 / 11 | 界面是 WinForms，只在 Windows 上跑 |
| Windows PowerShell 5.1 | 系统自带，不用装 |
| .NET Framework 4.x | 系统自带，不用装 |
| DeepSeek Harness (DSH) | 源码运行（pnpm dsh web）或全局安装都行 |

快速开始

1. 下载 / 克隆本仓库，整个文件夹放到任意位置（建议就放在 DSH 源码目录旁边，管家会自动找到它）
2. 双击 DSH管家.exe
（不想用 exe 也行：右键 DSH管家.ps1 → 使用 PowerShell 运行，只是会多一个黑窗口）
3. 第一次运行会提示你选 DSH 工作目录 —— 就是含 package.json、平时敲 pnpm dsh web 的那个文件夹
4. 点「启动服务」，好了

首次运行 / 配置

管家会自己找 DSH：

1. 先看自己周围 1–3 层（工具放在 DSH 旁边时直接就找到了）
2. 再看桌面 / 文档 / 下载
3. 最后扫各盘根目录下面一层

找不到才会弹提示，让你在设置面板里手动选。找到过一次就记住了。

启动命令留空就行，管家按环境自动挑：

| 环境 | 自动用的命令 |
|---|---|
| 源码目录 + 有 pnpm | pnpm dsh web --no-open |
| 源码目录 + 只有 npm | npm run dsh -- web --no-open |
| 全局安装的 DSH（工作目录留空） | dsh web --no-open |

想用别的命令（比如带参数、或者自定义启动脚本），在设置面板的「启动命令」里直接写完整命令即可。

设置存在 %LOCALAPPDATA%\dsh-console\settings.json，不会往程序目录写任何东西。

常见问题

双击没反应？
先看 %TEMP%\dsh-butler.log，每次启动、端口、浏览器探测、报错都在里面。

提示找不到工作目录 / 启动服务失败？
在设置面板里点「浏览…」选中 DSH 源码目录。判断标准：那个文件夹里应该有 package.json，
而且你在里面手敲 pnpm dsh web 是能跑起来的。

我的 DSH 是全局安装的，没有源码目录？
工作目录留空即可，管家会用全局的 dsh 命令。

端口不是 3080？
设置面板里改端口，管家所有地方（状态检测、打开页面、token 解析）都会跟着变。

杀软报毒 / 不信任那个 exe？
DSH管家.exe 只是个 5 KB 的启动器（作用是别弹出黑色控制台窗口），源码就在 launcher/Launcher.cs，
可以用 launcher/构建启动器.ps1 自己重新编译，或者直接删掉它、改用 .ps1 启动。

怎么把它固定到任务栏？
Windows 11 不允许程序自动固定，需要两步：设置里勾「在开始菜单中显示」→ 开始菜单找到 DSH 管家 → 右键 → 固定到任务栏。

目录结构

DSH管家.ps1          主程序（单文件，所有配置集中在文件顶部的「配置区」）
DSH管家.exe          启动器：无控制台窗口地拉起上面的脚本（可选）
DSH管家.ico          程序图标（7 个尺寸）
使用说明.txt          中文详细说明书
assets/
deepseek-whale.png 主界面两个外链按钮用的小鲸鱼
launcher/
Launcher.cs        启动器源码
构建启动器.ps1      重新编译 DSH管家.exe
launcher.ico       启动器自己的图标
docs/screenshots/    README 里的截图

自己编译启动器

在 launcher 目录下
.\构建启动器.ps1

用的是 Windows 自带的 csc.exe（.NET Framework 4.x），编译产物覆盖上一层的 DSH管家.exe。

它是怎么跟 DSH 打交道的

| 干什么 | 怎么做的 |
|---|---|
| 判断服务在不在 | 检查配置的端口有没有在监听（netstat），不依赖进程名 |
| 启动服务 | 在 DSH 目录里执行启动命令，输出重定向到 %TEMP%\dsh-web.log |
| 停止服务 | 找到占用该端口的进程（PID），弹确认框后结束它 |
| 打开带 token 的页面 | 从服务日志里抓 http://127.0.0.1:端口/?token=...；抓不到就退回不带 token 的地址，不会报错 |
| 换浏览器打开 | 走系统安装的浏览器列表（注册表 StartMenuInternet），也可以指定某一个 |

中文

DSH 管家 是 Windows 上本地 DeepSeek Harness (DSH) Web 服务器的一个小巧 GUI 控制台——
无需接触终端即可启动 / 停止 / 重启它。

- Windows 10/11，内置 Windows PowerShell 5.1，内置 .NET Framework 4.x——无第三方依赖
- 四个大按钮：启动 / 停止 / 重启 / 打开页面；实时状态、端口、PID 和运行时长
- 选择用哪个已安装的浏览器打开页面（主界面上有一排图标）
- 浅米色 / 深石墨主题，可手动或按时间切换
- 常驻系统托盘，可选登录时自启动，可选守护模式在服务器挂掉时自动重启
- 界面语言为中文（欢迎提交 PR）

快速开始

1. 克隆或下载此仓库；将文件夹放在任意位置（放在你的 DSH 检出目录旁边效果最佳——它会被自动检测到）
2. 双击 DSH管家.exe（或用 PowerShell 运行 DSH管家.ps1）
3. 首次运行时，系统会询问你的 DSH 工作目录（包含 package.json 的文件夹，即你通常运行 pnpm dsh web 的地方）
4. 点击 启动服务

自动检测——启动器会先在自己周围查找 DSH，然后是桌面/文档/下载，最后是每个驱动器的根目录。
启动命令会自动选择：pnpm dsh web --no-open、npm run dsh -- web --no-open，或全局安装时的 dsh web --no-open。
将工作目录留空即可使用全局安装的 dsh。

日志——%TEMP%\dsh-butler.log（应用本身），%TEMP%\dsh-web.log（服务器输出）。
设置保存在 %LOCALAPPDATA%\dsh-console\settings.json；绝不会在可执行文件旁边写入任何内容。

该 .exe 只是一个 5 KB 的启动器，用于隐藏控制台窗口。源码位于 launcher/Launcher.cs，
用 launcher/构建启动器.ps1 重新构建它，或者删除它直接运行 .ps1。

版本演变

| 版本 | 主要变化 |
|---|---|
| v2.1 | 双主题诞生（白天米黄 / 夜间石墨）+ 日夜开关 + 渐变过渡 |
| v2.2 | 代码与目录整理，加上全局出错兜底日志（双击没反应时有据可查） |
| v2.3 | 运行时长显示 + 第一版设置面板（选浏览器 / 工作目录） |
| v2.4 | 图标体系升级（真齿轮）+ 时长改独立徽章 + 状态卡片重排 |
| v2.5 | 系统托盘常驻 + 开机自启 + 开始菜单入口 + 设置面板重做 + 守护模式 |
| v2.6 | 主界面浏览器图标条 + 底部「对话 / 用量 / 退出」+ 文字粗细整理 + 日夜开关改矢量绘制 |
| v3.0 | 面向开源：工作目录自动探测、启动命令自动识别、首次运行引导、启动器源码、README / 协议 / 目录整理 |

更新日志

| 版本 | 亮点 |
|---|---|
| v2.1 | 双主题（米黄 / 石墨），日夜切换，缓动过渡 |
| v2.2 | 代码与文件夹整理，全局错误日志 |
| v2.3 | 运行时长显示，首个设置面板 |
| v2.4 | 新图标集（真齿轮），运行时长徽章，状态卡片重做 |
| v2.5 | 托盘常驻，自启动，开始菜单入口，设置重做，守护模式 |
| v2.6 | 浏览器图标条，底部栏（对话 / 用量 / 退出），排版整理，矢量绘制的主题切换 |
| v3.0 | 面向开源：自动检测 DSH 文件夹和启动命令，首次运行向导，启动器源码，README / 许可证 / 仓库整理 |

许可证

MIT——见 LICENSE。