ayingQAQ/dsh-web-launcher

Windows 上的 DeepSeek Harness Web 一键启动器|支持后台重启和浏览器刷新的一键启动器。

Project Overview项目介绍

dsh-web-launcher is a native one-click launcher built exclusively for DeepSeek Harness (DSH) on Windows. It creates a desktop shortcut for DSH Web, and offers two installation paths: you can install it as a DSH plugin via the DSH CLI command, or install it globally as an independent npm package. After installation via DSH plugin, it automatically creates or updates the desktop shortcut for DSH Web, and you can check the status, recreate, or remove the shortcut directly in DSH’s general settings panel. The independent npm install works for users who prefer not to add it to their DSH profile.

When you double-click the generated shortcut for the first time, it launches the DSH Web service and automatically opens the DSH interface in your default browser at the default 127.0.0.1:3080 address. If you double-click the shortcut again, it checks that the port is running DSH, restarts the DSH service in the background, and refreshes any existing open DSH browser window. If no existing DSH window is found, it opens a new one. This lets any newly installed, modified, or removed plugins take effect immediately, making it ideal for DSH plugin developers who frequently test changes.

The current version only supports Windows, and only works with DSH's default web profile and default 3080 port. It is released under the open-source MIT license, and is an independent community project not affiliated with DeepSeek. Before uninstalling the plugin, you must first remove the desktop shortcut via DSH's settings, because DSH does not run third-party uninstall scripts when removing plugins. Logs are stored in %LOCALAPPDATA%\dsh-web-launcher\logs and only the current and previous log are retained.

dsh-web-launcher 是专为 DeepSeek Harness (DSH) 开发的原生 Windows 一键启动器,核心作用是为 DSH Web 创建桌面快捷方式,支持通过 DSH 插件命令或独立 npm 两种方式安装。通过 DSH 插件方式安装后,由 DSH 的 web 配置文件统一管理版本和依赖,安装完成后会自动在桌面生成可用的 DSH Web 快捷方式,用户也可在 DSH 设置界面手动管理快捷方式。

日常使用时,首次双击桌面快捷方式会启动 dsh web 并自动打开浏览器访问 DSH Web 页面;再次双击会在后台重启 DSH 服务,并刷新已打开的 DSH 页面,让刚安装、修改或卸载的插件立即生效。连续点击会自动合并为单次操作,避免重复停止、启动进程,适合需要频繁调试、安装或卸载 DSH 插件的开发者日常使用。

本项目当前仅支持 Windows 系统,只适配 DSH 默认的 web 配置文件和 3080 默认端口,采用 MIT 许可开源,是独立开发工具并非 DeepSeek 官方产品。卸载插件前需要先在 DSH 设置界面移除桌面快捷方式,否则快捷方式会残留在桌面上,日志保存在本地用户目录,最多保留两份日志。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:ayingQAQ/dsh-web-launcher

把 ayingQAQ/dsh-web-launcher 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DSH Web Launcher

由 DSH 管理的 Windows 一键启动器。它为 DeepSeek Harness Web 创建桌面快捷方式: 首次双击启动 dsh web 并打开浏览器,再次双击则在后台重启 DSH 并刷新现有页面, 让刚安装、卸载或修改的插件立即生效。

通过 DSH 安装

dsh plugin --profile web add github:ayingQAQ/dsh-web-launcher

重新启动一次 DSH Web。插件加载后会自动创建或更新桌面的 DSH Web 快捷方式, 以后插件的安装、更新和卸载记录均由 web profile 管理。

在 DSH 的 设置 → 通用设置 → DSH 一键启动器 中可以检查状态、重新创建或 移除桌面快捷方式。卸载插件前若不再需要快捷方式,请先在这里将其移除。

卸载插件:

dsh plugin --profile web remove dsh-web-launcher

独立安装

不希望把它加入 DSH profile 时,也可以继续作为普通 npm 工具使用:

npm install -g dsh-web-launcher
dsh-web-launcher setup

可用命令:

dsh-web-launcher start
dsh-web-launcher setup
dsh-web-launcher status
dsh-web-launcher remove

行为

  • 默认地址为 http://127.0.0.1:3080,使用默认 web profile。
  • 首次启动显示 DSH 自身的终端窗口,服务就绪后自动打开浏览器。
  • 再次双击会核对本次启动记录的进程、地址和新版 DSH 的启动令牌,再在后台重启。
  • 使用 --no-open 避免 DSH 重启时自己再弹出浏览器;就绪地址仅从本次启动输出读取。
  • 重启后在标题含“DeepSeek Harness”的现有浏览器窗口中重新进入鉴权地址;不关闭窗口,找不到时打开新页面。页面可能回到首页,不保证保留当前会话路由。
  • 重启沿用原 DSH 命令路径、工作目录和 DSH_HOME,不会因为 PATH 顺序变化切换安装来源。
  • 连续点击会合并成一次操作,避免重复停止、启动和刷新。
  • 稳定运行文件位于 %LOCALAPPDATA%\dsh-web-launcher\runtime。
  • 日志位于 %LOCALAPPDATA%\dsh-web-launcher\logs,最多保留当前和上一份日志。
  • 快捷方式使用原生 Windows Shell Link API 创建,不调用 PowerShell。

限制

当前版本仅支持 Windows 和默认 web profile,绑定本机回环地址,默认端口 3080。 如需不同端口,可在启动器进程的环境中设置 DSH_LAUNCHER_URL=http://127.0.0.1:4080。 PowerShell 中临时设置的环境变量只影响该窗口启动的 CLI;桌面快捷方式不会自动继承。 DSH 删除插件时不会 主动执行第三方卸载脚本,因此应先从插件设置项移除桌面快捷方式,再卸载插件。

0.2.5 兼容性修复

  • 适配新版 DSH 首页鉴权,不再把正常的 401 误报为其他程序占用端口。
  • 首次进入和重启都使用 DSH 提供的鉴权地址,不绕过或关闭 DSH 鉴权。
  • 从旧版启动器升级后,或 DSH 原本由其他方式启动时,需要先手动关闭一次 DSH,再双击快捷方式。启动器不会自动接管未知实例。
  • 插件管理接口仅接受本机请求,并复用 DSH connection.admit() 鉴权。旧版 DSH(如 0.1.1-rc.2)缺少此接口时,设置页管理会返回明确提示;请使用 dsh-web-launcher setup/status/remove,插件内也可通过 node <插件目录>/bin/dsh-web-launcher.js <命令> 调用。
  • logs 和 server.json 可能包含本机启动令牌,反馈问题前请先删除 URL 中的 token,不要公开这些文件。
  • 需要保留 DSH 的启动地址输出(printUrl: true,默认开启);关闭后启动器无法取得安全入口,会超时提示而不会绕过鉴权。

已针对 0.1.7-rc.2 发布包核对协议,并以隔离服务测试启动、重启和鉴权流程; 不是对所有未来 DSH 版本或浏览器组合的兼容保证。运行 npm test 可执行回归测试, Windows 集成测试使用临时目录和随机端口,不启动真实 DSH,也不操作桌面浏览器。 GitHub Actions 在 Windows 上对 Node.js 20、22、24 执行这些回归测试。

0.2.6 错误提示修复(issue #2)

  • 报错弹窗在 15 秒后自动关闭,启动器对弹窗进程最多等待 20 秒,避免无人点击时长期残留。
  • 即使错误发生在初始化之前,也会替换旧版无超时的弹窗脚本;完整错误仍输出到 stderr。
  • 补充鉴权文本与状态码组合、关闭端口和弹窗超时测试,并修正 Windows 短路径引起的 CI 测试误报。

许可与归属

本项目采用 MIT License。DeepSeek Harness 图标来源与许可见 THIRD_PARTY_NOTICES.md。本项目是独立工具,不是 DeepSeek 官方产品。

← 上一个 Prev femo-plugin 下一个 Next dsh-context-zip →