DeepSeek Harness Web 一键启动器

告别每次手动输入 npx @deepseek-ai/dsh web，双击即可启动 DeepSeek Harness Web。
https://gitee.com/devangbamboo/ds/tree/master/start

---

https://gitee.com/devangbamboo/ds/tree/master/start

📁 文件说明

文件	类型	说明
dsh-web.exe	可执行文件	双击即用，单文件自包含，可拷贝到任意位置
dsh-web.ps1	PowerShell 脚本	主逻辑脚本（exe 运行时内嵌调用的就是它）
dsh-web.cmd	批处理文件	双击启动器（调用 ps1 脚本）
build-exe.ps1	PowerShell 脚本	重新打包脚本，修改 ps1 后运行此文件重新生成 exe

---

🚀 使用方式

方式一：双击 dsh-web.exe（推荐）

==============================================
        DeepSeek Harness Web
==============================================
  服务状态: 未运行（按回车会先启动服务再打开浏览器）

  直接按回车 : 打开默认浏览器 (http://127.0.0.1:3080)
  输入 9      : 退出

• 按回车 → 自动启动服务，服务就绪后自动弹出浏览器
• 输入 9 → 退出
• 如果服务已经在运行（比如你已经在终端启动过），按回车会直接打开浏览器，不会重复启动

方式二：双击 dsh-web.cmd

效果与 exe 完全相同（exe 内部就是用 PowerShell 运行 ps1）。

方式三：右键 dsh-web.ps1 → “使用 PowerShell 运行”

同上。

---

🛠 重新打包 exe

如果修改了 dsh-web.ps1，需要重新生成 exe：

# 右键 build-exe.ps1 → "使用 PowerShell 运行"
# 或者在终端中执行：
powershell -ExecutionPolicy Bypass -File build-exe.ps1

打包原理：将 ps1 内容 base64 编码嵌入 C# 启动器，用 Windows 自带的 csc.exe 编译为独立 exe。无需安装任何第三方工具。

---

⚡ 工作原理

dsh-web.exe
  ├─ 将内嵌的 ps1 释放到临时目录
  ├─ 启动 powershell.exe 执行脚本
  ├─ 脚本检测端口 3080
  │   ├─ 已运行 → 直接用默认浏览器打开 http://127.0.0.1:3080
  │   └─ 未运行 → 启动 npx @deepseek-ai/dsh web（前台）
  │              → 后台任务监听端口就绪后自动打开浏览器
  └─ 服务停止后自动清理临时文件

---

📋 环境要求

• Node.js（需要 npx 命令）
  • 下载：https://nodejs.org
  • 安装后 npx 自动可用
• Windows 10/11（使用了 Get-NetTCPConnection 命令）

---

💡 常见问题

Q：双击 exe 后什么都没发生？
A：exe 本身只是调用 PowerShell 运行脚本，如果 PowerShell 执行策略被限制，右键 → “以管理员身份运行” 或者用方式二/三。

Q：首次运行很慢？
A：首次运行 npx 会自动下载 @deepseek-ai/dsh 包（约 30MB），需要联网。下载后会缓存，后续启动秒开。

Q：Ctrl+C 停止服务后，浏览器怎么没自动打开？
A：Ctrl+C 会同时终止脚本。如果服务需要重启，重新运行 exe 即可。

Q：浏览器打开后显示空白？
A：服务可能还没完全启动。关闭浏览器，等几秒后重新运行 exe。也可以手动访问 http://127.0.0.1:3080。