Introduction¶

During runtime, DSH Web processes may crash or be interrupted unexpectedly, resulting in session interruptions and service unavailability. Manually recovering services and checking health status is cumbersome and error-prone. This plugin addresses these issues by providing centralized settings storage, a Web Supervisor, and recovery mechanisms.

What Is This¶

It is the core of DSH Web, containing a monitoring daemon, settings storage, approval guard, and cross-machine synchronization engine. It combines four independent features into a single package. The plugin implements self-recovery and state persistence by running as a host+client inside dsh web and as a system daemon externally.

Core Features¶

• DSH Web Supervisor (monitoring daemon): System-level monitoring (systemd), polls service status every 3 seconds, saves last known good (LKG) snapshots, detects crashes and performs automatic rollback, and generates health reports including Git Diff and logs.
• Automatic Recovery: After DSH Web has been running for 8 seconds, automatically finds and resumes sessions that were interrupted within autoResumeWithin (default 5 minutes).
• Automatic Reload: Browser-side client plugin that automatically reloads the page when the Web service restarts or the network disconnects.
• Settings Storage: Provides a global settings.json store and Maestro settings cards for read/write access by other modules.
• Approval Guard: Provides rule classification and approval entry points; check status via maestro_guard_status.
• Cross-machine Synchronization: Provides backup, restore, retention policy GC, and two-machine synchronization features.

Installation and Enablement¶

Use the official command to install the plugin:

dsh plugin --profile web add @ddtcorex/dsh-maestro-core

If you need to specify a version, you can use:

dsh plugin --profile web add @ddtcorex/dsh-maestro-core@<version>

After installation, restart dsh web. This package includes cordis.patch.yml; do not manually copy it or add duplicate Row IDs.

Typical Usage¶

Manage it via command-line tools or the Systemd daemon:

# 启动守护进程（前台调试）
node packages/dsh-maestro-core/lib/index.js daemon

# 查看状态
node packages/dsh-maestro-core/lib/index.js status

# 恢复指定时间范围内的中断会话
node packages/dsh-maestro-core/lib/index.js resume --within 5m

Enable the Systemd daemon for system-level monitoring:

bash packages/dsh-maestro-core/scripts/install-systemd.sh
systemctl --user daemon-reload
systemctl --user enable --now dsh-web-supervisor
systemctl --user status dsh-web-supervisor

Applicable Scenarios and Notes¶

• Environment requirements: Requires Node.js ^22.19.0 || >=24.0.0 and pnpm 11+, with DSH version 0.1.x or 0.2.x.
• Build requirements: The lib/ directory is ignored by Git; after modifying source code, run pnpm build. Client build requires build-client.mjs.
• Permission risks: The plugin runs with the current DSH process permissions; if the DSH process has elevated permissions, the plugin has the corresponding permissions as well. It is recommended to review the source code and license before installation.
• Configuration: Telegram Bot Token is optional and used for notifications.

Conclusion¶

By integrating monitoring, storage, and synchronization capabilities into a single package, dsh-maestro-core reduces the maintenance complexity of DSH Web and improves system robustness.

• GitHub repository
• Skill Center directory