Introduction

The DSH ecosystem emphasizes “everything is a plugin.” The community plugin directory is an independent site with no official affiliation to DeepSeek / Fenxiang, nor is it an official app store.

For developers using DSH, installing a plugin is not the end of operations work. Issues such as secure restart, version upgrades, health checks, backup recovery, vendor quota queries, and Linux file permission maintenance all require an entry point that allows repeated operations, maintains a history, and prevents accidental operations. Below is an introduction to gehennawu/dsh-service, which is an operations panel designed for DSH Web.

What is it

  • Plugin Name: gehennawu/dsh-service
  • Maintainer: gehennawu
  • License: MIT
  • Positioning: DSH Web Operations Panel: Secure restart, health monitoring, backup, and Linux permission maintenance.
  • Environment Requirements: Node.js >=22

In short, it concentrates high-frequency operations from daily DSH Web maintenance into a single panel: first check the status, then execute restart, backup, quota query, skill and sub-agent configuration, and finally handle sessions and plugin health.

Core Features

Secure Restart

dsh-service provides secure restart capabilities. Before restarting, it checks if there are currently active Agents, background tasks, or terminal-like work running; if such work is detected, the restart is automatically rejected.

You can also trigger a secure restart by typing /restart directly in the chat:

/restart

This action is not simply ending the process, but using “can I restart now” as a prerequisite judgment.

Version Management and One-Click Upgrade

The version and update section checks npm’s latest and next dual tags:

latest
next

When a new version is detected, version comparison is expanded inline; after executing one-click upgrade, it automatically restarts.

Health Diagnosis

Health diagnosis is used to view the current running status of DSH, including:

  • Uptime
  • Memory
  • Session count
  • Active Agents
  • Background tasks

In addition, deep file permission checks and repairs can be performed. If the current environment appears to be started manually, the health diagnosis will prompt that restart is not guaranteed; it will not automatically restart after exiting.

Quota Query

Quota query is used to view vendor window usage, including:

  • Vendor window percentage
  • Independent progress bar
  • Reset time
  • Force refresh

Query results are cached for 60 seconds. On failure, it uses a 30s x 2 exponential backoff, capped at 15 minutes. Requests are not initiated for unadapted vendors.

Credentials are written to the DSH credential database:

$DSH_HOME/.credentials.yaml

The API key is only parsed within the host process; the browser only receives normalized window data.

Backup Management

Backup management supports creating .tar.gz archives and performing export/download, import/upload, and delete operations.

Integrity checks are performed before importing or restoring:

  • Validate gzip/tar
  • Validate paths
  • Validate entry types

Only accepts:

sessions
Three allowed configurations
profiles/<name>/package.json

And rejects:

  • Out-of-bounds paths
  • Symlinks
  • Special files
  • Unknown content
  • Corrupted archives
  • Illegal profile lists

Restore pre-checks also verify the archive’s SHA-256 against the current target fingerprint. If a drift occurs, execution is rejected.

Skill Management

Skill management organizes local skills into three status levels:

  • Auto-load
  • Manual call only
  • Completely disabled

Double switches can directly rewrite the SKILL.md frontmatter to adjust skill invocation methods.

Sub-agent Models

Sub-agent models support three modes:

  • Initial
  • Follow main model
  • Custom

Fallback models and thinking levels can also be configured.

Route configuration is written to:

$DSH_HOME/dsh-service-subagent-route.json

Uses atomic writes during writing and sets 0600 permissions. A one-click reset is available after configuration is complete.

Task Notifications

Task notifications are used to alert users when critical events occur, including:

  • Master switch
  • Task completion
  • Authorization and questioning
  • Input box bell visibility

Session Management

Session management supports filtering between the following views:

  • All
  • Archived only
  • Deleted

Multiple sessions can be selected and executed:

  • Export
  • Archive
  • Delete

Plugin Health Check and Compatibility Scan

Plugin health check checks for plugin abnormal states. Manually disabled plugins are not considered abnormal.

Plugin compatibility scanning is a pure local scan with cached results and zero network usage.

Mobile Adaptation and Liveness Check

dsh-service provides mobile adaptation and a /healthz liveness check capability:

/healthz

Installation and Enablement

First check the local Node version:

node --version

Requirements:

>=22

Verified information does not provide official installation commands, so this article will not concatenate installation commands. Before installing, please check the current instructions on the GitHub repository and confirm the local DSH plugin mechanism.

After installing or enabling, you can enable the needed capabilities in the plugin configuration. When the corresponding plugin configuration switch is turned off, the interface is hidden, polling stops, and the host denies the corresponding capabilities; Overview and Restart are always retained.

Typical Usage

1. Trigger Secure Restart

Type in the chat:

/restart

If running work is detected, it will automatically be rejected.

2. Check Version and Upgrade

Enter the Version and Update section, check npm’s latest and next tags. When a new version is available, version comparison is expanded inline. Confirm and execute one-click upgrade; it will automatically restart after upgrading.

3. Perform Health Diagnosis

Enter Health Diagnosis to view uptime, memory, session count, active Agents, and background tasks. Perform deep file permission checks and repairs if needed.

4. Query Vendor Quota

Enter Quota Query to view the vendor window percentage, independent progress bar, and reset time. Click Force Refresh if needed.

5. Create Backup

Enter Backup Management to create a .tar.gz archive. You can export/download, import/upload, or delete backups. Integrity checks and restore pre-checks are performed before restoring.

6. Manage Skills

Enter Skill Management to set local skills to Auto-load, Manual call only, or Completely disabled. Double switches directly rewrite the SKILL.md frontmatter.

7. Configure Sub-agent Models

Enter Sub-agent Models to select Initial, Follow main model, or Custom mode. Configure fallback models and thinking levels if needed.

8. Handle Sessions

Enter Session Management to filter between All, Archived only, and Deleted views. Select multiple sessions and execute Export, Archive, or Delete.

Applicable Scenarios and Notes

Suitable for the following scenarios:

  • Frequent need to restart the DSH Web service
  • Need to view service health status
  • Need to manage backups and recovery
  • Need to query vendor quotas
  • Need to maintain Linux file permissions
  • Need to manage skills, sub-agents, and sessions

It is worth noting that dsh-service operates the local DSH state, including credentials, backups, configurations, permissions, and plugin health. Plugins run with the permissions of the current dsh process; please check the source code and license before installing.

Links

  • GitHub: https://github.com/gehennawu/dsh-service
  • Directory page clue (marked as a clue in verified data, not appearing in scraped data): https://www.skillhub.cn/plugins/gehennawu/dsh-service