桌面快捷启动 LunarEclipse-LJH/dsh-desktop-shortcut

dsh 桌面快捷方式 🐋

一键在 Windows 桌面上创建 DeepSeek Harness (dsh) Web UI 的快捷方式，带官方风格的鲸鱼图标。
一键为 DeepSeek Harness (dsh) Web UI 创建 Windows 桌面快捷方式，带鲸鱼图标。

dsh 图标

这是什么 / 这是什么

双击桌面图标即可启动 dsh Web UI（npx @deepseek-ai/dsh web），并自动在浏览器打开 http://127.0.0.1:3080——不用每次手动敲命令。

一个桌面图标，可启动 npx @deepseek-ai/dsh web 并自动在浏览器中打开 Web UI——无需每次手动输入命令。

特性 / 特性

- 🖱️ 桌面快捷方式，双击即用 / 桌面快捷方式，双击即用
- 🐋 白色鲸鱼图标（取自 dsh 官方 favicon 渲染）/ 白色鲸鱼图标（取自 dsh 官方 favicon 渲染）
- 🌐 智能等待：轮询检测 3080 端口，等 dsh 服务器真正就绪后才打开浏览器，避免“连接被拒绝” / 智能等待：轮询检测 3080 端口，等 dsh 服务器真正就绪后才打开浏览器，避免“连接被拒绝”
- 📁 自动处理桌面重定向（OneDrive / 移动桌面）/ 自动处理桌面重定向（OneDrive / 移动桌面）
- 🔌 无额外依赖，复用已装的 Node.js + npx / 无额外依赖，复用已安装的 Node.js + npx

环境要求 / 环境要求

- Windows 10 / 11
- Node.js (>= 18)
- 已能通过 npx @deepseek-ai/dsh web 启动 dsh（首次运行会自动拉取）/ 已能通过 npx @deepseek-ai/dsh web 启动 dsh（首次运行会自动拉取）

安装 / 安装

一键安装（推荐 / 推荐）

git clone https://github.com/LunarEclipse-LJH/dsh-desktop-shortcut.git
cd dsh-desktop-shortcut
powershell -ExecutionPolicy Bypass -File .\install.ps1

脚本会：
1. 把启动器和图标安装到 %USERPROFILE%\.dsh-shortcut\
2. 在桌面创建 dsh 快捷方式（指向启动器，带鲸鱼图标）

脚本会执行以下操作：
1. 将启动器和图标安装到 %USERPROFILE%\.dsh-shortcut\
2. 在桌面创建 dsh 快捷方式（指向启动器，带鲸鱼图标）

手动安装 / 手动安装

把 start_dsh.cmd 和 assets\dsh.ico 放在你想放的位置，用 PowerShell 创建快捷方式：

将 start_dsh.cmd 和 assets\dsh.ico 放在你想放的位置，然后用 PowerShell 创建快捷方式：

$sh = New-Object -ComObject WScript.Shell
$lnk = $sh.CreateShortcut("$([Environment]::GetFolderPath('Desktop'))\dsh.lnk")
$lnk.TargetPath = "C:\path\to\start_dsh.cmd"
$lnk.IconLocation = "C:\path\to\dsh.ico,0"
$lnk.WorkingDirectory = "$env:USERPROFILE"
$lnk.Save()

使用 / 使用

双击桌面 dsh 图标 → 黑色命令行窗口弹出（服务器日志）→ 等几秒，浏览器自动打开 dsh Web UI（http://127.0.0.1:3080）。

双击桌面上的 dsh 图标 → 黑色命令行窗口弹出（服务器日志）→ 等几秒，浏览器自动打开 dsh Web UI（http://127.0.0.1:3080）。

不要关那个黑色窗口，它是 dsh 服务器的电源。最小化可以，关掉 dsh 就停了。想彻底停止时，关掉黑框即可。
不要关闭那个黑色窗口——它是 dsh 服务器的电源。最小化可以；关闭它就会停止 dsh。要彻底停止 dsh，只需关闭那个窗口。

文件结构 / 文件结构

dsh-desktop-shortcut/
├── install.ps1 # 一键安装：装启动器 + 建桌面快捷方式 / 一键安装 ├── start_dsh.cmd # 启动器：轮询端口就绪后开浏览器 / 带端口轮询的启动器 ├── assets/ │ └── dsh.ico # 鲸鱼图标（多尺寸）/ 鲸鱼图标（多尺寸） ├── LICENSE # MIT 许可证 ├── .gitignore └── README.md

常见问题 / FAQ

Q: 双击后黑框一闪就没了？/ 快捷方式双击后一闪就消失？
检查 start_dsh.cmd 是否使用 CRLF 行尾（Windows 批处理要求），否则重新 clone。/ 检查 start_dsh.cmd 是否使用 CRLF 行尾（Windows 批处理要求），否则重新 clone。

Q: 浏览器显示“无法访问此网站 / 拒绝访问”？/ 浏览器显示“连接被拒绝”？
start_dsh.cmd 已内置端口轮询，理论上不会出现。若仍有，可能是首次启动 dsh 下载依赖较慢——稍等或手动访问 http://127.0.0.1:3080。/ start_dsh.cmd 已内置端口轮询，因此不应出现此问题。若确实出现，可能是首次运行时依赖下载较慢——请稍等或手动打开 http://127.0.0.1:3080。

Q: 能改端口吗？/ 我可以更改端口吗？
可以，改 start_dsh.cmd 里的 3080 和轮询命令中的端口。/ 可以——将 start_dsh.cmd 中的 3080（以及轮询命令中的端口）改为你的端口。

许可证

MIT — 图标来自 deepseek-ai/deepseek-harness（MIT）。
MIT — 图标来自 deepseek-ai/deepseek-harness（MIT）。