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 时，安装器会弹窗引导下载。
方式一（推荐）
- 仓库页点绿色 Code → Download ZIP，解压到任意文件夹（或
git clone https://github.com/DaYanQAQ/DSH-Shortcut.git） - 双击解压出来的
install.bat→ 自动解除下载锁定并启动中文安装器 - 按提示选择安装位置（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 崩溃、启动报错、程序损坏时使用。
最简方式（推荐）：
- 按
Win + R打开"运行"窗口 - 粘贴下面这行，回车：
powershell -NoExit -ExecutionPolicy Bypass -File "%LOCALAPPDATA%\DeepSeek\reinstall.ps1"
- 弹出的窗口会询问"确认执行重装？"——输入
y回车开始，其他任意键取消
备选方式：打开文件夹 %LOCALAPPDATA%\DeepSeek（复制到文件管理器地址栏回车），右键 reinstall → 使用 PowerShell 运行，同样输入 y 确认。
三步自动完成，任何一步失败都会中止，不做破坏性操作：
- 停止运行中的 Harness（按端口持有者精确识别，不误杀其他程序）
- 清空 npx 缓存中的程序文件，下次启动自动下载最新版（加
-Full参数清空整个缓存） - 自动重新启动（与双击快捷方式同款流程）
放心事项：
- 不删除对话记录、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
