DaYanHCD/DSH-Shortcut

dsh-shortcut

DeepSeek Harness（dsh web）的 Windows 桌面快捷方式工具：双击智能启动 / 唤起、浏览器打开前终端自动最小化，崩溃可一键重装救援。纯 PowerShell 实现，零依赖、零收集。

作者：DaYanQAQ · License: MIT

功能

- 🖱️ 一键安装：双击 install.bat，中文交互菜单（选盘、路径校验、缺 Node.js 弹窗引导下载）
- 🔧 一键重装救援：Harness 崩溃 / 启动异常时，一条命令停止服务 → 清空程序缓存 → 自动重启最新版，不删除任何用户数据
- 🚀 智能启动：未运行 → 弹出终端自动启动；已在运行 → 零窗口把浏览器页面带到前台（浏览器关了自动重开网页），并把被恢复出来的终端重新收进任务栏
- 🪟 窗口自动管理：服务就绪、浏览器打开前，终端自动最小化；连续双击不堆叠窗口；最大化的浏览器不会被误缩小
- 🎨 圆角图标：品牌蓝（#4D6BFE）圆角方块 + 官方白色鲸鱼，纯 .NET 渲染官方 SVG 为 ICO，零外部依赖
- 🛡️ 隐私干净：全明文脚本，零上传、零日志、零收集
- 🗑️ 干净卸载：一条命令删除快捷方式与安装目录

安装

环境要求：Windows 10 / 11 + Node.js（npx 可用）。未安装 Node.js 时，安装器会弹窗引导下载。

方式一（推荐）

1. 仓库页点绿色 Code → Download ZIP，解压到任意文件夹（或 git clone https://github.com/DaYanQAQ/DSH-Shortcut.git）
2. 双击解压出来的 install.bat → 自动解除下载锁定并启动中文安装器
3. 按提示选择安装位置（C 盘 / D 盘 / 自定义），完成 ✅

方式二（手动 / 指定目录）

powershell -ExecutionPolicy Bypass -File ".\install.ps1"                     # 交互式，同 install.bat
powershell -ExecutionPolicy Bypass -File ".\install.ps1" -Path "D:\DeepSeek" # 指定目录，跳过交互

卸载：

powershell -ExecutionPolicy Bypass -File ".\uninstall.ps1" [-Path "D:\DeepSeek"]

使用

双击桌面的「DeepSeek Harness」快捷方式：

| 双击时 | 表现 |
| --- | --- |
| Harness 未运行 | 终端显示 → 运行 npx -y @deepseek-ai/dsh web → 浏览器打开前自动最小化 |
| Harness 已运行 | 不弹任何窗口，唤起已有浏览器页面（浏览器已关则重开网页），并把被恢复出来的终端重新收进任务栏 |
| 端口 3080 被占用 | 终端显示占用提示与进程名 |

首次运行 npx 会自动下载 @deepseek-ai/dsh（稍慢，之后很快）。

本工具只负责"启动与窗口体验"，不含 AI 能力。与 AI 聊天需自行在
platform.deepseek.com 申请 API Key 并在 Harness 中配置；
没有 Key 时程序照常启动，只是 AI 不回复。

一键重装（崩溃救援）

Harness 崩溃、启动报错、程序损坏时使用。

最简方式（推荐）：

1. 按 Win + R 打开"运行"窗口
2. 粘贴下面这行，回车：

powershell -NoExit -ExecutionPolicy Bypass -File "%LOCALAPPDATA%\DeepSeek\reinstall.ps1"

3. 弹出的窗口会询问"确认执行重装？"——输入 y 回车开始，其他任意键取消

备选方式：打开文件夹 %LOCALAPPDATA%\DeepSeek（复制到文件管理器地址栏回车），右键 reinstall → 使用 PowerShell 运行，同样输入 y 确认。

三步自动完成，任何一步失败都会中止，不做破坏性操作：

1. 停止运行中的 Harness（按端口持有者精确识别，不误杀其他程序）
2. 清空 npx 缓存中的程序文件，下次启动自动下载最新版（加 -Full 参数清空整个缓存）
3. 自动重新启动（与双击快捷方式同款流程）

放心事项：

- 不删除对话记录、API Key 和配置（保存在 ~/.dsh，与程序文件分开存放）
- 已安装的 dsh 插件（如余额插件）不受影响——插件装在配置目录里，重装只清理程序缓存
- 重装后快捷方式照常可用，只是第一次启动需重新下载 dsh（约一两分钟）

项目结构

├── install.bat / install.ps1     # 一键安装（中文交互、路径校验、图标缓存刷新）
├── uninstall.ps1                 # 卸载
├── dispatcher.ps1                # 隐藏调度器：已在运行零窗口唤起；未运行拉起可见终端
├── start-harness.ps1             # 可见启动器：运行 npx、轮询端口、浏览器打开前自动最小化
├── reinstall.ps1                 # 一键重装救援：停止服务 → 清空程序缓存 → 自动重启
├── render-logo.ps1               # 图标渲染：官方 SVG → 圆角 PNG / ICO
├── assets/                       # 官方 Logo 矢量源与生成的圆角图标
├── LICENSE
└── README.md

常见问题

| 问题 | 处理 |
| --- | --- |
| 双击脚本被 Windows 拦截 | install.bat 已自动解除锁定（Unblock-File） |
| 提示缺少 Node.js | 弹窗点"是"打开官网下载，装完重试 |
| 桌面图标未变圆角 | 右键桌面 → 刷新；仍无效则重启资源管理器 |
| 双击快捷方式无反应 | 确认 Node.js 已装、Harness 终端在运行；端口占用时终端会给出提示 |
| Harness 崩溃 / 启动异常 | 运行安装目录（%LOCALAPPDATA%\DeepSeek）下的 reinstall.ps1（右键 → 使用 PowerShell 运行） |
| 快捷方式本身损坏 | 重新运行 install.bat（或 install.ps1）即可修复 |

致谢

- 图标矢量取自 @deepseek-ai/dsh 官方 Web 前端（favicon.svg），版权归 DeepSeek 所有，仅本地非商业使用

相关项目

- dsh-balance-mini：作者的另一款 dsh 插件——极简余额监视器

License

MIT © 2026 DaYanQAQ