lovstudio/clash-tun-doctor-skill

Latest recorded source activity: September 25, 2026 at 15:25

SkillsMP catalog refreshed: October 29, 2026 at 18:30

skills collected: 1

GitHub stars: 1
GitHub forks: 0

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/lovstudio/clash-tun-doctor-skill.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# Clash 网络医生 · Clash Network Doctor ![Version](https://img.shields.io/badge/version-0.6.2-CC785C) 基于最终运行态、实时连接和日志证据，诊断并修复 Clash Verge Rev TUN 导致的应用联网故障。 Independent source repository, also distributed through [lovstudio/skills](https://github.com/lovstudio/skills) — by [Lovstudio.AI](https://lovstudio.ai) ## 适用场景 - 开启 TUN 后微信图片发不出去。 - 微信朋友圈图片加载很慢或完全不显示。 - 应用被错误规则送进失效代理，持续 Loading。 - 订阅中已经关闭 IPv6，但最终运行配置仍启用 IPv6。 - Mihomo 日志出现 `no route to host` 或 `context deadline exceeded`。 ## Install ```bash npx skills add lov-clash-tun-doctor -g -y ``` 或使用 Claude Code 插件市场： ```text /plugin marketplace add lovstudio/skills /plugin install dev-tools@lovstudio ``` 依赖：macOS、Clash Verge Rev、Python 3.8+。诊断 CLI 只使用 Python 标准库。 ## Usage ```bash SKILL_DIR="${SKILL_SKILLS_INSTALL_DIR:?Set SKILL_SKILLS_INSTALL_DIR}/lov-clash-tun-doctor" # 只读诊断 python3 "$SKILL_DIR/scripts/clash_tun_doctor.py" diagnose --app wechat # 从运行连接和近期轮转日志生成 DIRECT 清单 python3 "$SKILL_DIR/scripts/clash_tun_doctor.py" direct-list \ --app miracleplus \ --host apply.miracleplus.com \ --output ./miracleplus-direct.yaml # 合并进当前规则并在线热加载，全程保持 Clash 运行 python3 "$SKILL_DIR/scripts/clash_tun_doctor.py" direct-list \ --app miracleplus \ --host apply.miracleplus.com \ --apply # 预演修复 python3 "$SKILL_DIR/scripts/clash_tun_doctor.py" fix-wechat # 备份、修复、重启并验证 python3 "$SKILL_DIR/scripts/clash_tun_doctor.py" fix-wechat --apply # 回滚最近一次修复 python3 "$SKILL_DIR/scripts/clash_tun_doctor.py" rollback --apply ``` ## 安全模型 - 永远先诊断，后修改。 - 修改命令默认 dry-run，必须显式传入 `--apply`。 - 每次修改创建时间戳备份和文件映射清单。 - DIRECT 清单与现有 `prepend` 合并，不覆盖用户已有规则。 - 规则型修复通过 Mihomo Unix Socket 热加载，Clash Verge 保持运行；服务模式下以 payload 热加载，被 Mihomo 拒绝时还原文件并输出原始报错。 - 不修改订阅 URL，不输出代理密钥或控制器 Secret。 - 修复后检查最终配置和 Mihomo 运行态（规则、控制 socket、Selector 选择与自动组的手动固定），而不是只检查源配置。 ## Options | 参数 | 默认值 | 说明 | |---|---|---| | `--data-dir` | 自动发现 | Clash Verge Rev 数据目录。 | | `--socket` | 自动发现 | Mihomo 控制器 Unix Socket；优先读取运行中内核的 `-ext-ctl-unix`，兼容服务模式，全部连不上时报错退出。 | | `--app` | `wechat` | 诊断时使用的应用过滤器。 | | `--host` | — | 明确加入清单的域名，可重复传入。 | | `--output` | — | 输出 Mihomo classical rule-provider YAML 清单。 | | `--live-logs` | 关闭 | 诊断时改为实时采样 Mihomo `/logs` 流（秒数）；服务模式内核日志仅 root 可读时使用，采样期间复现故障。 | | `--log-limit` | `4000` | 每段近期轮转日志读取的行数。 | | `--apply` | false | 明确授权修改或回滚。 | | `--no-reload` | false | 只持久化 DIRECT 清单，不热加载运行态。 | | `--no-restart` | false | 修改后不重启 Clash Verge。 | | `--json` | false | 输出 JSON 诊断结果。 | ## License MIT

Loading the repository README…

Skills in this repository

classification pending

skill

occupation

description

updated

lov-clash-tun-doctor

unclassified

Diagnose and repair application connectivity failures caused by Clash Verge Rev TUN routing, rule precedence, stale runtime state, proxy timeouts, or unusable IPv6 paths. Trigger for symptoms such as WeChat images failing to send, Moments images loading…

2026-09-25

Showing 1 of 1 collected skill.