dsh-launcher

English · 简体中文

DeepSeek Harness 的 Windows 轻量启动器：开机自启 + 独立小窗口，双击即用，不用敲命令。

安装

方式一：MSI 安装包（推荐给新手）

1. 到 Releases 下载 dsh-launcher-<版本>.msi
2. 双击安装，向导里可勾选开机自启 / 桌面快捷方式 / 开始菜单快捷方式，也可自定义安装目录
3. 安装和卸载会弹一次 UAC 管理员确认（系统级安装，默认装到 %ProgramFiles%\dsh-launcher）
4. 卸载：设置 → 应用 → dsh-launcher → 卸载（或开始菜单"卸载 dsh-launcher"）

方式二：便携版 ZIP

1. 下载 dsh-launcher-windows.zip，解压到任意文件夹
2. 双击 DshWeb.exe 即可
3. 卸载：删掉文件夹（自启/快捷方式用 uninstall-autostart.cmd 清理）

环境要求

依赖	说明	怎么检查/安装
Node.js 18+	dsh 服务运行必需（dsh 不必全局安装，启动器会自动用 npx 拉取）	https://nodejs.org 下载 LTS 版，默认安装
.NET Desktop Runtime 10	壳程序运行必需	缺失时双击无反应，见下方排障；winget install Microsoft.DotNet.DesktopRuntime.10
WebView2 Runtime	窗口渲染用	Windows 10/11 通常已自带，无需操作

特性

• 🚀 开机自启：登录后静默启动 dsh 服务，不弹窗口
• 🪟 轻量窗口：WebView2 独立窗口（约 50–150MB，关窗即释放），替代完整浏览器
• 🔌 自动拉起：服务没开时自动启动并等待就绪（首次运行需下载组件，有进度提示）
• 🔔 差错提示：缺 Node.js / 下载失败 / 端口占用等都会明确弹窗说明，不再静默
• 🎛️ Node 服务驻留：在 dsh 设置页（配套插件）切换"常驻 / 托盘驻留 / 跟随窗口"，决定关窗后 node 服务是继续跑还是跟着停（省内存）
• 🌗 主题跟随：窗口标题栏（自绘）、窗口/任务栏图标跟随 dsh 主题即时切换（深色/浅色），不用重启
• 📋 日志：dsh 服务日志 %USERPROFILE%\.dsh-web.log；壳启动轨迹 DSH_HOME\dsh-launcher\shell.log（启动异常时定位利器）

与 dsh 插件联动

dsh 设置页里有一个配套插件 dsh-launcher-lifetime（GitHub · npm），提供 "Node 服务驻留" 设置页：三个单选切换服务模式（跟随窗口 / 常驻 / 托盘驻留），立即生效、不用重启。

dsh plugin add dsh-launcher-lifetime

• 模式保存在 DSH_HOME\dsh-launcher\settings.json（默认 ~/.dsh\dsh-launcher\settings.json，与 dsh 生态一致），启动器在关窗/托盘退出时读取执行
• 托盘图标右键菜单保持精简（显示/隐藏 + 退出），服务模式切换统一在插件的设置页里做
• 没装插件时启动器按默认"跟随窗口"模式工作，插件只是提供图形化切换入口

启动不了？按现象排查

大多数"没反应"都出在环境依赖上。先对照上方"环境要求"确认 Node.js 和 .NET 都装了，再按现象查。

现象 1：双击后完全没反应（没有窗口、没有弹窗）

多半是缺少 .NET Desktop Runtime 10。在 PowerShell 运行：

winget install Microsoft.DotNet.DesktopRuntime.10

装完再双击。仍不行 → 看下方"看日志"。

现象 2：弹出"未检测到 Node.js，无法启动 dsh 服务"

安装 Node.js 18+（LTS 版，一路默认下一步即可），装完重新打开 dsh-launcher。

现象 3：卡在"正在启动 dsh 服务…首次运行需要下载组件"很久

第一次使用会自动下载 dsh 组件（通过 npx），可能几分钟，取决于网络速度。耐心等：

• 正常下载完 → 自动进入窗口
• 超过 3 分钟 → 会弹窗提示原因（下载慢 / 网络问题），并附日志尾部

网络较慢可配置 npm 国内镜像后重试：

npm config set registry https://registry.npmmirror.com

现象 4：弹出"dsh 服务未能就绪"或"dsh 服务不可用"

打开日志看最后几行：%USERPROFILE%\.dsh-web.log（记事本打开即可；用 DSH_WEB_PORT 换过端口则是 .dsh-web.端口.log）

• 日志里有 npm ERR 或网络相关报错 → 网络/代理问题，重试或换网络
• 日志里有 'npx' 不是内部或外部命令 → Node.js 没装好，重装 Node.js（现象 2）
• 日志里有 EADDRINUSE → 端口 3080 被占用，见现象 5

还查不出来 → 看壳的启动轨迹 DSH_HOME\dsh-launcher\shell.log（默认 ~/.dsh\dsh-launcher\shell.log），里面记录了单实例、端口探测、服务拉起、就绪判定、窗口显示等每个决策点，反馈问题时附上它。

现象 5：端口 3080 被其他程序占用

设置环境变量 DSH_WEB_PORT 换端口后重启，壳会自动按新端口拉起 dsh 服务（最简单，推荐）：

$env:DSH_WEB_PORT = "3090"

如果服务是你自己手动起的，也可以用 DSH_WEB_URL 指向它（壳不再自动拉起服务，细节见 docs/DETAILS.md）：

$env:DSH_WEB_URL = "http://127.0.0.1:3090"

现象 6：界面文字/图标模糊（系统缩放 125%/150% 时）

v0.1.8 已修复（Per-Monitor DPI），请升级到最新版本。

现象 7：升级后"设置 → 应用"里有两个 dsh-launcher

新版会自动检测旧版本并弹窗提示一键提权清理（旧版是 per-user 安装，跨版本升级不会自动移除）。按提示点"是"即可，不会误删其他软件（有 UpgradeCode 精确校验）。

看日志：

Get-Content "$env:USERPROFILE\.dsh-web.log" -Tail 30

日志第一行会写明本次是用全局 dsh 还是 npx 回退启动的，方便判断问题出在哪一环。

常见问题

Q：必须先手动跑 npx @deepseek-ai/dsh web 才有窗口？ 不需要。v0.1.2+ 起启动器自动回退 npx -y @deepseek-ai/dsh，无需全局安装 dsh。

Q：MSI 和 ZIP 有什么区别？ 内容完全相同。MSI 有标准安装/卸载流程（推荐新手）；ZIP 免安装（便携党）。

Q：能自定义安装目录吗？卸载会误删同目录文件吗？ MSI 向导可自定义目录；卸载只删本应用文件，目录非空则保留（已实测验证）。

Q：dsh 服务一直占内存（几百 MB）？ dsh 是完整服务（含 Web UI），常驻是设计（秒开）。想要省内存：dsh 设置页 → "Node 服务驻留" → 跟随窗口（关窗即停服务，下次启动自动拉起）。

更多

• 技术实现 / 安全 / 发版策略 / 从源码构建：docs/DETAILS.md
• 更新日志：CHANGELOG.md

免责声明

本仓库是独立的第三方工具，与 DeepSeek / DeepSeek AI 官方无关。DeepSeek Harness（dsh）是官方项目（MIT）。窗口图标使用了 DeepSeek 品牌标识，版权归 DeepSeek 所有，仅作个人本地使用。

许可证

MIT © dsh-launcher contributors