完整版内置 Node.js,不代表第一次启动时已经包含全部 Harness 文件。维护 DeepSeek Launcher 的过程中,我发现把这两个阶段解释清楚,能减少很多"安装好了为什么还在等"的疑问。
下面根据项目 v1.2.1 的 README,梳理安装、首次启动和后续启动的区别。
1. 安装包携带的是运行时

完整版安装包带有 Node.js 运行时,用户无需预装 Node.js;轻量版则要求系统已有 Node.js 22 或更高版本。
完整版安装阶段复制预压缩运行时文件。启动时优先复用已有私有 Node,再考虑兼容的系统 Node;没有可用运行时时,才校验并展开内置运行时。这意味着部分准备工作发生在第一次打开程序时。
2. 第一次启动还需要获取 Harness
Launcher 是启动和管理入口,Harness 是实际提供网页功能的上游程序。正式安装版第一次启动会获取上游 @deepseek-ai/dsh@latest,因此仍需要能访问相应包源的网络。

启动窗口先显示"正在启动 DeepSeek Harness",服务就绪后显示"启动完成,正在打开浏览器"。第一次启动的等待,可能包含运行时准备、包下载和本地服务启动。
安装器不需要联网下载 Node.js,与首次启动需要获取 Harness,是两个不同阶段。
3. 后续普通启动复用缓存版本
后续普通启动使用本地已缓存的确切 Harness 版本,不会每次都主动升级到最新版。需要更新上游时,再使用:
powershell
deepseek update
这条命令会更新 Harness 并重启服务,期间会短暂中断使用。
Launcher 自身的版本检查是另一条命令:
powershell
deepseek launcher update --check
它只检查 Launcher 更新,不安装。Launcher 更新检查失败不会阻塞正常启动。但能否使用具体模型,还取决于模型服务和网络条件,不能把缓存启动理解为所有 AI 功能都能离线使用。
4. 等待异常时,先看状态和日志
高级用户可用以下命令辅助排查:
powershell
deepseek status
deepseek logs 50
status 会区分运行中、未运行以及端口被未知进程占用。默认端口是 3080。Launcher 会核对进程身份,避免把电脑上其他服务当成 Harness。
logs 50 查看最近 50 行服务日志。提交 Issue 时,请描述是否首次启动、安装包类型、Windows 版本和错误提示;公开日志前应去掉 API Key、聊天内容等隐私。
需要纯终端启动与诊断输出时,可运行 deepseek start;Windows 交互式终端直接运行 deepseek 会复用桌面启动窗口。
5. 当前进展与参考
- 源码与使用文档:https://github.com/wyf-777/deepseek-launcher
- 项目首页:https://wyf-777.github.io/deepseek-launcher/
欢迎交流 Windows 启动体验和首次运行遇到的问题。
说明:DeepSeek Launcher 是社区独立项目,并非 DeepSeek 官方产品。