rpvvn/EasyDSH
Lightweight one‑click launcher for DeepSeek Harness DeepSeek‑Harness(DSH)轻量一键启动器
安装Install
dsh plugin --profile web add github:rpvvn/EasyDSH把 rpvvn/EasyDSH 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
✨ 功能特性
- 🚀 一键启动：自动检测环境并后台启动 DSH Web 服务，服务就绪后自动打开浏览器
- 🔄 一键重启：强制停止当前服务 → 等待端口释放 → 重新启动
- ⏹ 停止服务：全局扫描所有运行中的 DSH 进程（node 进程 + 3080 端口），强制结束
- 📦 一键安装：执行
npm install -g @deepseek-ai/dsh全局安装 - 🔍 环境检测：检测环境缺失提供下载，实时展示 Node.js / npm / DSH（全局 / npx 缓存）/ 服务端口状态，彩色圆点卡片
- 🎨 WPF 矢量界面：圆角按钮、彩色状态卡片、悬停高亮
- 📦 单文件绿色版：无需安装、无需配置文件，可放入 U 盘随处运行
- 🛡 服务冲突诊断：启动失败时自动识别「插件服务名冲突」，弹窗说明谁占用、谁冲突，并可一键卸载其中一方
- 🔌 灵活关闭：关闭窗口时可选择「停止并关闭」或「仅关闭窗口」，让 DSH 服务继续后台运行而不强制停止
- 🚫 单实例运行：启动时自动检测，若已有实例在运行则提示「已经运行，请勿重复运行」并自动退出
- ℹ️ 额外支持：npm国内镜像源切换、下载本地代理切换、DSH版本管理
界面展示
📋 环境依赖
| 依赖 | 说明 |
|---|---|
| Windows 7+ | 需 .NET Framework 4.0+（Windows 10/11 已自带） |
| Node.js | 含 npm，用于运行 / 安装 DSH |
🚀 使用方法
- 从 Release 下载
DSH-Launcher.exe，或按下方说明自行编译 - 双击运行
- 首次使用点「安装 DSH」（或确保 DSH 已通过
npx缓存 / 全局安装） - 点「一键启动」，服务就绪后自动打开浏览器访问
http://127.0.0.1:3080
提示：关闭启动器窗口时，若 DSH 仍在运行会弹窗询问——可选择「停止并关闭」「仅关闭窗口」（服务继续后台运行）或「取消」。
🔨 编译
无需安装 Visual Studio 或任何 SDK，Windows 自带的 .NET Framework 4.0 编译器（csc.exe）即可编译。
方式一：一键编译
build.bat
方式二：手动编译
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe ^
/nologo /codepage:65001 /target:winexe /win32icon:icon.ico ^
/out:DSH-Launcher.exe ^
/r:"C:\Windows\Microsoft.NET\Framework64\v4.0.30319\WPF\PresentationCore.dll" ^
/r:"C:\Windows\Microsoft.NET\Framework64\v4.0.30319\WPF\PresentationFramework.dll" ^
/r:"C:\Windows\Microsoft.NET\Framework64\v4.0.30319\WPF\WindowsBase.dll" ^
/r:"C:\Windows\Microsoft.NET\Framework64\v4.0.30319\System.Xaml.dll" ^
/r:"C:\Windows\Microsoft.NET\Framework64\v4.0.30319\System.Drawing.dll" ^
/r:"C:\Windows\Microsoft.NET\Framework64\v4.0.30319\System.Management.dll" ^
DshLauncher.cs
32 位系统请把路径中的
Framework64替换为Framework。
如何发布版本
git tag v1.0.0
git push origin v1.0.0
推送后，工作流会自动编译 DSH-Launcher.exe 并发布到新的 Release。
⚙️ 工作原理
| 动作 | 实现 |
|---|---|
| 启动 | 优先全局 dsh web，否则 npx --yes @deepseek-ai/dsh web |
| 停止 | WMI 扫描命令行含 deepseek-ai 的 node 进程 + netstat 找 3080 端口进程，taskkill /F /T 强制结束 |
| 检测 | node -v / npm -v / `npm config get prefix |
| 端口 | 默认 127.0.0.1:3080 |
| 冲突诊断 | 捕捉 dsh web 输出，正则识别服务名冲突，解析占用方/冲突方包名，弹窗并提供一键卸载 |
📁 目录结构
├── .github/workflows/build.yml # 自动编译与发布
├── DshLauncher.cs # 全部源码
├── icon.ico # 应用图标
├── build.bat # 一键编译脚本
├── UpdateLog.md # 更新说明（Release notes）
├── README.md # 中文文档（本文档）
├── readmeEN.md # 英文文档
├── patches/ # 附带的 DSH 补丁
└── .gitignore
🔧 常见问题
- 提示「未检测到 Node.js」：请先安装 Node.js。
- 点「停止服务」后浏览器仍能打开：属正常现象，刷新页面后即失效。
- 图标不显示：编译时确保
icon.ico与源码在同一目录。 - 启动失败提示「插件服务冲突」：两个插件注册了同名 Cordis 服务（常见如
pet）。按弹窗提示卸载其中一方即可；对应的 DSH 报错改进补丁见patches/dsh-cordis-service-collision-message.patch。
社区支持 Linux.do
MIT License
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…