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 设置界面移除桌面快捷方式,否则快捷方式会残留在桌面上,日志保存在本地用户目录,最多保留两份日志。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-web-launcher(ayingQAQ/dsh-web-launcher)
仓库:https://github.com/ayingQAQ/dsh-web-launcher
本站详情页:https://www.yhbd.top/plugins/ayingqaq-dsh-web-launcher/
本站登记:类型 client · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 5 · 最近提交 2026-09-27 · 主语言 JavaScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 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 官方产品。
YaoApp/yao
See-Sol-Lab/DeepSeekGUI
PolinniZhong/dsh-session-workbench
YMRYMR/deepseek-peak
Jensen-Yao/deepseek-harness-android-app
Leon0555/dsh-lan-access
hibays/DSHL