DeepSeek Harness plugin

dsh-plugin-guardian

DeepSeek Harness 插件管家：安全地卸载插件、自动清理残留、出问题一键退回。全程图形界面，不用碰命令行。

Repository: songoao25/dsh-plugin-guardian
Latest update: Aug 17, 2026
Category: Security & Permissions
GitHub stars: 1
Format: plugin
Catalog sources: dshworks/awesome-dsh-plugins
Catalog evidence: Upstream dsh.bundle evidence
Evidence path: package.json#dsh.bundle
Checked against: 0.1.0-rc.8
Upstream check date: 2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/songoao25/dsh-plugin-guardian
Plugin: dsh-plugin-guardian
Author: songoao25

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files

README.mdSource · read only

DSH Plugin Guardian

English | 中文

> Safe uninstall with snapshot rollback for DeepSeek Harness plugins.

!License !Version !Platform

What is this?

A plugin for DeepSeek Harness that helps you safely uninstall other plugins — no leftover files, no broken startup, no command line needed.

If you've ever uninstalled a DSH plugin and found leftover .bak files, orphaned data directories, or your Harness refusing to start — this is the tool that fixes that.

Features

Plugin List — See all installed plugins with versions and data directories
Residue Scanner — Find .bak backup files and orphaned data left behind by previous operations
One-Click Cleanup — Delete residue files with preview and confirmation
Pre-Uninstall Snapshot — Automatically backs up your config files before any uninstall
Safe Uninstall — One button does: snapshot → uninstall → clean data → clean leftovers
Health Check — Check port 3080, config validity, and bundle status before startup

Installation

# In your DSH workspace directory
dsh plugin add dsh-plugin-guardian

Or manually copy this directory into your DSH plugins folder and restart Harness.

Usage

1. Open DSH Settings (gear icon in sidebar) 2. Find the "插件管家" (Plugin Guardian) tab 3. Click any of the three buttons: - 已装插件 (Installed Plugins) — View and uninstall plugins - 扫描残留 (Scan Residues) — Find and clean leftover files - 启动前体检 (Health Check) — Check system health before restart

Uninstalling a plugin

1. Click 已装插件 to see your installed plugins 2. Click 卸载 (Uninstall) next to the plugin you want to remove 3. Confirm the action — Guardian will automatically: - Create a snapshot of your config files - Run pnpm remove to uninstall the package - Clean up the plugin's data directory - Clean up related .bak files 4. Manually restart DSH to apply changes (e.g., zsh scripts/restart-deepseek-harness.sh)

FAQ

Q: Why do I need to restart manually after uninstalling? A: DSH assembles plugins at startup — removing one requires reassembly. Auto-restart is planned for a future version.

Q: Where are snapshots stored? A: In ~/.dsh/.plugin-guard-snapshots/<timestamp>-<plugin-name>/. They're local only, never uploaded.

Q: Is it safe? A: All delete operations require confirmation. Plugin names are validated against injection attacks. Shell commands are properly quoted.

Limitations

Snapshot auto-restore is experimental (snapshots are created but auto-restore UI is not yet available)
Auto-restart is deferred — manual restart required after uninstall
Residue scan covers top-level directories only

License

Back to search Open GitHub repository

Source facts