big0lives/dsh-win-quick-launcher

DSH Win Quick Launcher 使用 DeepSeek Harness(DSH)时,每次启动都要打开终端、执行 pnpm dsh web(或 dsh web)、再从输出里复制带 token 的地址。本启动器把这串动作压缩成一次双击:桌面图标 → 服务后台启动 → 应用窗口自动弹出 → 关窗即停。

catalog descriptioncatalog 简介 / catalog description:DSH 的 Windows 便捷启动器:双击桌面图标启动 DeepSeek Harness Web,关掉浏览器窗口即停服务。支持源码安装与 npm 安装。

Project Overview项目介绍

This is a purpose-built quick launcher for DeepSeek Harness (DSH) running on Windows. It streamlines the DSH startup workflow that originally requires opening a terminal, running the dsh web command, and copying the token-included URL to access the authenticated interface. The launcher supports both DSH installation methods: local source build and global npm installation. It also includes a machine-readable AGENTS.md that lets AI agents like Claude Code and Codex complete automatic installation with clear operation boundaries.

After installation, a desktop shortcut for DSH Web is created automatically. Users just need to double-click the shortcut to launch the DSH service in the background. The launcher captures the tokened authentication URL from the service output and opens it in a standalone app mode window with either Edge or Chrome. No terminal window will pop up during the entire process, and when the user closes the browser window, the launcher automatically terminates the entire DSH service process tree.

This launcher has zero npm dependencies, and requires only Windows 10 or 11, Node.js, and a working DSH installation to run. It makes no changes to the DSH core files, does not write to the Windows registry, and can be fully uninstalled by deleting just the desktop shortcut and the configuration file. It is released under the permissive MIT open source license, and users should note that it conflicts with the dsh-web-window-companion plugin, so only one should be enabled at a time to avoid crashes.

这是一款专门为 Windows 平台的 DeepSeek Harness (DSH) 打造的便捷启动器,旨在简化原本需要打开终端、执行启动命令、复制带认证令牌地址的繁琐启动流程。它支持 DSH 的两种安装模式:源码构建版本和全局 npm 安装版本,还内置 AI Agent 可识别的安装手册,支持 AI 自动完成安装。

安装完成后,用户仅需双击桌面生成的 DSH Web 快捷方式,即可自动在后台拉起 DSH 服务,捕获带令牌的认证地址,并用 Edge 或 Chrome 的应用模式打开独立无地址栏窗口,全程无需弹出终端。关闭窗口后,启动器会自动终止整个 DSH 服务进程树,无需手动停止服务,适合追求简洁操作体验的日常用户。

本启动器零 npm 依赖,仅需 Windows 10/11、Node.js 和已正确安装的 DSH 即可运行,完全卸载只需删除桌面快捷方式和配置文件,不会修改 DSH 本体也不写入注册表。它采用 MIT 许可证开源,注意不要和 dsh-web-window-companion 同时启用,避免冲突闪退。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 3 warnings3 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
  • 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:big0lives/dsh-win-quick-launcher

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

READMEREADME

DSH Win Quick Launcher

DeepSeek Harness 的 Windows 便捷启动器:无终端窗口、自动携带认证令牌、关窗即停服务
支持源码构建与 npm 两种安装方式 · 支持 AI Agent 自动安装 · 零 npm 依赖

DeepSeek Harness Node.js Windows License: MIT

中文 · English

使用 DeepSeek Harness(DSH)时,每次启动都要打开终端、执行 pnpm dsh web(或 dsh web)、再从输出里复制带 token 的地址。本启动器把这串动作压缩成一次双击:桌面图标 → 服务后台启动 → 应用窗口自动弹出 → 关窗即停。

功能特性

功能 说明
无窗口运行 通过 WScript 隐藏宿主启动服务,全程不弹出终端窗口
自动认证 捕获服务输出中 dsh web: <url>?token=... 一行,直接使用带令牌的地址,跳过 authentication required 页面
双安装模式 同时支持源码构建(pnpm dsh web)与 npm 安装(dsh web,即 npm install -g @deepseek-ai/dsh 或 npx @deepseek-ai/dsh web)的用户
Agent 可安装 仓库内置 AGENTS.md 操作手册,把提示词发给你的 AI Agent 即可完成安装与验证
应用模式窗口 以 Edge / Chrome 的 --app 模式打开独立窗口(无地址栏,使用独立浏览器配置目录)
关窗即停 监视浏览器进程,窗口关闭后自动结束整个服务进程树

⚠️ 与姊妹插件 dsh-web-window-companion 二选一:两者共用同一个浏览器专用配置目录,同时启用会导致窗口互踢闪退、服务被误停。用桌面图标就不需要装那个插件。

快速开始

委托给你的 AI Agent(推荐)

把下面这段提示词原样发给你正在使用的 AI Agent(Codex、Claude Code、Kimi 等):

请帮我安装 DSH Win Quick Launcher。项目地址为 https://github.com/big0lives/dsh-win-quick-launcher。先阅读仓库的 AGENTS.md 与 README,确认本机环境(Windows、Node.js、DSH 安装方式)满足前置条件,再按 AGENTS.md 的步骤完成安装与验证。执行前向我说明将要改动的位置;遇到杀软排除项、终止进程、凭据或覆盖已有文件时,先停下向我确认。

Agent 只会读写本仓库目录并创建一个桌面快捷方式;它不会改动你的 DSH 源码目录,也不会调整杀毒软件设置。

手动安装

前置条件:Windows 10 / 11、Node.js,以及以下二选一——源码安装(已执行过 pnpm run build 的 DSH 源码目录)或 npm 安装(npm install -g @deepseek-ai/dsh,dsh 命令在 PATH 中可用)。

git clone https://github.com/big0lives/dsh-win-quick-launcher.git
cd dsh-win-quick-launcher

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-rule-engine 下一个 Next dsh-office-toolkit →