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