dsh-web-quick-launcher

Windows 一键启动脚本，简化 @deepseek‑ai/dsh web 启动流程，自动抓取真实访问地址，非官方社区工具 ⚠️ 社区非官方工具，本项目与 DeepSeek‑AI 无任何关联，仅为简化本地部署的辅助脚本。

📖 项目介绍

原生 npx @deepseek‑ai/dsh web 启动时存在以下痛点：

• 无法自动获取运行端口，手动输入地址容易出现 127.0.0.1 拒绝连接
• 需要等待后台下载完成，新手不知道什么时候服务就绪

本 .bat 脚本功能：

1. 执行官方 npx 命令启动 DSH‑Web 本地服务
2. 自动抓取程序输出的真实访问网址
3. 服务就绪后自动唤起浏览器打开页面
4. 兼容随机端口，不需要手动固定端口号

脚本不会上传、分发、修改任何 DSH 本体程序，所有资源全部从官方 npm 源在线拉取。

✅ 前置依赖（必须先安装）

你的电脑需要提前安装 Node.js LTS 长期支持版

• 下载地址：https://nodejs.org/zh-cn/download/
• ⚠️ 安装过程中，务必勾选 Add to PATH（添加到系统环境变量）
• 安装完成后关闭所有终端窗口，再运行本脚本

🚀 使用教程

1. 将 启动DSH.bat 下载到本地
2. 双击运行脚本
3. 黑窗口不要关闭，最小化即可（关闭窗口服务就停止）
4. 等待片刻，浏览器会自动打开 DSH‑Web 页面

💡 第一次启动较慢：npx 需要从网络下载 DSH 程序包，耗时取决于网速，等待时间 30秒‑3分钟属于正常现象。 如果超过 4 分钟一直卡在等待页面，可以关闭黑窗口重新运行脚本。

❓ 常见问题 FAQ

1. 双击弹出「此应用无法在你的电脑上运行」

99% 的原因：文件后缀被浏览器自动改成了 .bat.txt 解决：

1. 文件资源管理器顶部 → 查看 → 勾选【文件扩展名】
2. 将文件名后缀修改回 .bat

2. 长时间卡在【等待服务启动...】

• 首次运行：后台下载 npm 包，耐心等待
• 下载卡死：关闭窗口重开，或者切换手机热点重试
• 第二次启动速度会非常快，包会缓存在本地

3. 黑窗口提示 npx 不是内部或外部命令

Node.js 没有正确安装 / 没有勾选添加 PATH。 卸载 Node，重新安装 LTS 版本并勾选 Add to PATH。

4. Windows 提示该 bat 文件可能有害

属于 Windows 对下载而来的批处理脚本的安全警告。 你可以打开脚本查看全部源码，脚本无任何隐藏操作，可放心允许运行。

📜 开源声明

• 本仓库仅存放辅助启动脚本，不包含 DeepSeek‑DSH 的任何二进制程序
• DSH 以及 @deepseek‑ai/dsh 版权归属 DeepSeek‑AI
• 本脚本仅供个人学习使用，请遵守 DSH 的官方开源协议