Clash Verge Diagnostics

Inspect Clash Verge or mihomo, manage profile-specific routing, and diagnose connectivity.

Routing

Confirm the target profile, constraints, requested access path, and done-when signal.
Load references/full-guide.md for commands, templates, and diagnosis matrices.
Load references/local-hub.md before hub, align, roles, clone, setup-ai, or switch, and whenever the user says a previous sync did not apply.
Keep the change limited to the requested target.

Safety

Diagnose and align are read-only. Writes require a shown summary and explicit confirmation.
Edit enhancement overlays or the confirmed local-hub YAML. Do not edit raw subscription dumps.
tun.route-exclude-address is union-only. DIRECT is not a TUN bypass.
Never invent or print node IPs, credentials, subscription UIDs, or machine hostnames.
After an overlay or hub-YAML write, quit and reopen Clash Verge. PUT /configs does not re-merge overlays.

Modes

Argument	Mode
empty or a hostname	diagnose
`profiles` / `list` / `ls`	list local and remote profiles
`status`	live kernel, TUN, and selected nodes
`hub` / `roles`	local-hub topology
`align` / `sync-check`	read-only multi-machine comparison
`switch-check` / `health`	pre-switch health
`clone` / `setup-ai` / `switch`	confirmed profile writes
`rustdesk` / `bypass`	TUN exclusion for a relay IP

Resolve the named target before setup-ai. Apply airport-style enhancement overlays only when that target is type: remote; edit the named hub YAML when it is type: local.

Verify

Parse the target YAML after every write.
Query mihomo by trying both Unix sockets and then the configured HTTP controller; fall back on request failure, not socket existence alone.
For routes, chains[-1] is the matched group and chains[0] is the dialed node.
Report files changed, commands run, evidence, and remaining risk.

References

references/full-guide.md — commands, templates, and diagnosis matrix
references/local-hub.md — hub ownership, node roles, alignment, and landmines

clash-doctor