dsh-ops

@liangjiehappy/dsh-ops — DSH Ops Workbench

中文说明

A dev/ops workbench for DSH-managed sites. It checks health, SEO, GEO, code and security, and does snapshot / deploy / rollback with automatic recovery.

14 tools + 1 skill.

Install

dsh plugin --profile web add @liangjiehappy/dsh-ops

Then set your API key (get one at https://dshio.org/me/):

dsh plugin config dsh-ops --set api_key=<your-key>

Or set the environment variable DSH_OPS_KEY.

Tools

Tool	What it does	Mutates
ops_status	Summary of all sites: score, per-category score, last deploy, open issues	no
ops_check	Run 15 checkers on one site, return detailed pass/warn/fail	no
ops_issues	Open issues, sorted by severity, with first-seen and count	no
ops_snapshot	Incremental snapshot (sha256 diff + hard links)	yes (add only)
ops_deploy	Deploy with impact analysis, auto-snapshot, auto-rollback	yes
ops_rollback	Restore to a snapshot	yes
ops_restart	Restart a systemd service	yes
ops_traffic	Real traffic: today vs yesterday, humans vs bots vs service worker, top pages and landing pages	no
ops_http	Probe page status, size, title and latency from the server	no
ops_read	Read a server text file (code/config/log) with line numbers and secret redaction	no
ops_service	Service status / restart / reload / nginx -t (authorised units only)	yes (restart/reload)
ops_exec	Read-only diagnostics: df du ps uptime wc grep nginx_test	no
ops_disk	Disk status / cleanup (journal, nginx cache, old snapshots, old rotated logs); dry-run by default	yes (on clean)

Checkers (15)

Category	Checkers
deploy	deploy_smoke deploy_assets deploy_sitemap
seo	seo_title seo_desc seo_canonical seo_hreflang seo_structured
geo	geo_ai_crawler geo_citable
code	code_language_mix code_package_clean code_secret
security	sec_fail2ban sec_backup

Skill

ops-guide — loaded when the user asks about site status, deployment or rollback. It explains which tool to use, what to check before a risky operation, and how to read the deploy impact analysis.

Deploy safety — three layers

The ops_deploy tool was built in response to a real incident: an rsync --delete removed 3 static JS files and broke mobile layout, the feedback button and the PWA prompt for 4 days.

1. Source completeness — if the build directory is missing expected subdirectories, deploy aborts (source is older than target).
2. Impact analysis — the tool lists every file that would be deleted. Files not in the source and not on the delete whitelist abort the deploy.
3. Verify + rollback — a snapshot is taken before deploy; smoke checks run after; any failure triggers automatic rollback.

Always run ops_deploy with dry_run: true first.

Data source

API: https://deepseekbase.com/work/api/

Third-party project. Not affiliated with DeepSeek.

• Homepage: https://deepseekbase.com/work/
• Standards: https://dshio.org/
• License: MIT