gluztm/DSHGuard 预览 preview

gluztm/DSHGuard

给 DeepSeek Harness(DSH)配的一个 Windows 桌面"守护壳":改动前自动存档、出事一键回滚,上游破坏性更新或插件改坏配置都能退回原样;本地就能寻找、安装、管理插件,不需要另装插件市场;引擎一键启动与停止,日志随时可看、还能导出诊断——全程图形界面,不需要命令行。网页引擎与官方桌面版(Electron)两边都能管。

catalog descriptioncatalog 简介 / catalog description:DSH 守护壳:DeepSeek Harness 的一键启动与救援工具——改动前自动存档、出事整组回滚、本地管理插件、诊断日志导出;Web 引擎与官方桌面版双轨管理

Project Overview项目介绍

DSHGuard is a Windows-only desktop guard shell built exclusively for the DeepSeek Harness (DSH) web engine. It offers a full graphical user interface that eliminates the need for users to interact with the command line to manage any part of DSH. It is packaged as a standard Windows installer for easy deployment on most modern Windows systems. Key core features include automatic snapshots before any configuration or plugin changes, one-click rollback to a previous working state when issues occur, local plugin browsing and management that doesn’t require a separate plugin marketplace, and one-click engine control with real-time log access and one-click diagnostic export.

This tool is targeted at users who are not familiar with working with command line interfaces, and solves many common pain points that users regularly encounter when using DSH. These include having no restore point after changing configurations or installing new plugins that break the system, no centralized browsing interface for discovering new plugins, no accessible logs for debugging when the engine fails, inability to roll back after breaking upstream updates, and the need to manually start the engine via terminal commands. DSHGuard follows a "monitor only, do not take over" design principle, so it runs as an independent program and does not alter the core logic of the DSH engine itself.

DSHGuard is built on .NET and released under the permissive MIT open source license, so it can be used and modified freely for any purpose, including commercial use. After installation, you launch it from the Start menu or a desktop shortcut, and first-time users just need to click the one-click start button to get the engine running. The first launch will take a little extra time because it needs to download and cache the DSH engine, but subsequent launches will be much faster. By default it does not modify DSH’s original configuration directory, and it only makes changes after creating a backup when fixing critical errors.

DSHGuard 是专为 DeepSeek Harness(DSH)网页引擎开发的 Windows 桌面守护壳,全程提供图形化操作界面,用户无需接触命令行即可完成 DSH 的全生命周期管理。核心能力包括改动配置或插件前自动创建快照,出问题时支持一键回滚到上一个正常状态;本地即可浏览、安装和管理插件,无需额外安装插件市场;还支持引擎一键启停、实时查看日志并导出诊断包。

它面向不熟悉命令行的普通用户,解决了 DSH 使用过程中常见的痛点:修改配置或安装插件后出问题无还原点、找不到插件浏览入口、引擎故障无现场日志可查、上游破坏性更新无法回退、需要手动敲命令启动引擎等问题。设计原则为"只做看护,不做接管",守护壳是独立程序,仅负责启动监测和问题处理,不接管 DSH 引擎本身的运行逻辑。

DSHGuard 基于 .NET 开发,采用 MIT 开源许可证,可免费使用和修改。安装后从开始菜单或桌面图标双击启动,首次使用点击一键启动引擎即可,首次启动会稍慢因为需要下载缓存引擎。它默认不会修改 DSH 原配置目录,仅在必要的异常修复时会先备份再修改,卸载也不会触碰 DSH 原有数据。

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:gluztm/DSHGuard

把 gluztm/DSHGuard 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DSH 守护壳(DSHGuard)

简体中文 | English

给 DeepSeek Harness(DSH)配的一个 Windows 桌面"守护壳":改动前自动存档、出事一键回滚,上游破坏性更新或插件改坏配置都能退回原样;本地就能寻找、安装、管理插件,不需要另装插件市场;引擎一键启动与停止,日志随时可看、还能导出诊断——全程图形界面,不需要命令行。网页引擎与官方桌面版(Electron)两边都能管。

它面向不熟悉命令行的用户:安装后双击启动,点按钮即可运行引擎;出现故障、卡顿或插件状态异常时,也能在同一个窗口里查看和处理。

快照页:改动前自动存档,出问题整组回滚

插件页:本地就能寻找、安装与管理插件,不需要另装插件市场

日志页:日志随时可看,一键导出诊断


2.0.0:Web 引擎与桌面版双轨管理

2.0.0 将两套 DSH 运行目标统一纳入一套管理体验:

  • 左上角全局开关统一切换 Web 引擎 / 桌面版,插件页与快照页同步切换;选择会记住,未检测到桌面版时自动置灰。
  • 两个目标拥有独立的插件清单、配置、下载来源与快照;快照列表按当前目标分开显示。
  • 两边都支持插件启用、禁用、安装、卸载、重装、单个更新与一键更新。桌面版写入走自己的 profile 与 pnpm,不会误改 Web 引擎。
  • 更新与兼容性判定始终针对当前目标,插件卡片的来源、链接与本地目录也不会串轨。
  • 有插件操作进行时禁止切换目标,避免在写入过程中误操作另一套 profile。

为什么会有它

我长期使用 DSH,把日常反复遇到的不便一条条记下来,最终做成这样一个一键管理式启动器。下面列出的就是当初要解决的问题,每一条在后面的功能章节里都能找到对应做法:

反复遇到的不便 守护壳里的对应做法
装了新插件或改了配置之后出了问题,没有还原点可退 快照页的改动前自动存档与一键回滚,出事就退回上一次正常的状态,参见快照页
装了一堆插件,说不清谁在启用、谁被关掉、谁该升级;想装新的又没有可浏览的入口 插件页的本地清单与社区收录,寻找、安装、管理都在本机完成,不需要另装插件市场,参见插件页
引擎起不来时没有任何现场,不知道去哪看日志 日志页的实时输出、历史日志与「导出诊断」,参见日志页
引擎按上游标签安装,上游一发破坏性更新,跑起来的就是另一个版本 版本记忆锁住现在这个版本,配合快照回滚,参见设置页
每次都要在终端里敲命令启动引擎,还要自己找端口、自己开页面 状态页的「一键启动引擎」,参见状态页

设计原则是只做看护,不做接管:守护壳是独立程序,和 DSH 引擎是两回事。引擎原本由外部启动,守护壳只负责启动与监测,并在需要时处理现场。


它长什么样

左侧是导航栏,共六个页面(状态、日志、快照、插件、设置、说明),最下方是「退出UI」;右栏常驻三块信息:服务控制(当前可用的引擎操作)、DSH 版本(正在用的版本与最新版)、事件信息(最近发生了什么)。界面为全中文,标题栏右侧可切换日夜配色。

状态页:引擎运行中

页面 管什么
状态 引擎在不在跑、跑的是哪个端口、最近输出与事件;右栏是一键启动与终止
日志 本次会话的实时输出、历史日志、导出诊断与复制日志
快照 改动前存档,随时按项或整组回滚;网页引擎与桌面版的存档分开列、分开存
插件 「寻找插件」逛社区收录并安装;「本地插件」启停、更新、卸载;管理哪一边由左上角开关决定
设置 常规(开关与端口)、路径(各种目录,含桌面版)、版本(升级与回退)
说明 应用内说明与常见问题

一、状态页:看到引擎在不在跑

它解决什么痛:引擎原本要在终端里手动拉起,端口是不是对的、进程还活着没有,全靠自己确认。

具体能做什么

  • 顶部状态卡显示当前状态:引擎运行中(附本次已运行时长)、正在启动…、引擎未运行。
  • 显示引擎的访问地址与端口,一眼确认端口号是否与设置一致。
  • 「实时输出」实时滚动引擎最近的输出,不用切到别的页面。
  • 右栏「服务控制」按当前状态给出唯一正确的动作:未运行时是绿色「一键启动引擎」,启动中是带百分比的进度条,运行中是红色「终止引擎」与绿色「加载引擎」(重新打开浏览器页面)。
  • 右栏「DSH 版本」显示当前运行的版本、最新版与版本策略;点击卡片可直接跳到设置页的版本页。
  • 右栏「事件信息」记录本次使用发生过什么:启动、停止、设置变更、插件动作、失败与告警各按严重程度着色。

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-tps 下一个 Next dsh-plugin-install →