mcpField
C
clash-doctor

clash-doctor

github.com/majiayu000云与 DevOps288136 次安装今天更新
代码仓库

关于 clash-doctor

clash-doctor 是用于检查 Clash Verge 和 mihomo、管理配置文件路由及诊断连接的技能。它区分只读检查与需确认的写入，并提供本地 hub 和多设备对齐流程。

主要功能

  1. 01诊断连接与运行状态
  2. 02列出本地及远程配置文件
  3. 03检查多设备配置差异
  4. 04确认后执行配置文件写入
  5. 05验证 YAML 与路由结果

适用场景

  1. 01排查 Clash Verge 或 mihomo 连接问题
  2. 02比较多台设备的配置
  3. 03检查切换节点前的健康状态
  4. 04按确认结果调整路由或 TUN 排除项

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/majiayu000/spellbook --skill clash-doctor

安装后在 Claude Code 中输入/clash-doctor确认已加载。

附带文件references/full-guide.mdreferences/local-hub.md

详细介绍

Clash Verge 诊断

检查 Clash Verge 或 mihomo，管理特定配置文件的路由，并诊断连接问题。

路由

  • 确认目标配置文件、限制条件、所需访问路径以及完成信号。
  • 加载 references/full-guide.md，查看命令、模板和诊断矩阵。
  • 执行 hub、align、roles、clone、setup-ai 或 switch 前，以及用户表示之前的同步未生效时，加载 references/local-hub.md。
  • 将变更限制在请求的目标范围内。

安全

  • 诊断和对齐操作均为只读。写入前须展示摘要并获得明确确认。
  • 编辑增强覆写文件或已确认的本地 hub YAML。不要编辑原始订阅转储文件。
  • tun.route-exclude-address 只能添加，不能移除。DIRECT 不能绕过 TUN。
  • 切勿编造或打印节点 IP、凭据、订阅 UID 或机器主机名。
  • 写入增强覆写文件或 hub YAML 后，退出并重新打开 Clash Verge。PUT /configs 不会重新合并覆写文件。

模式

参数模式
空值或主机名诊断
profiles / list / ls列出本地和远程配置文件
status实时查看内核、TUN 和已选节点
hub / roles本地 hub 拓扑
align / sync-check只读的多机器对比
switch-check / health切换前健康检查
clone / setup-ai / switch经确认后写入配置文件
rustdesk / bypass为中继 IP 配置 TUN 排除项

执行 setup-ai 前，先解析指定的目标。仅当目标为 type: remote 时，才应用机场风格的增强覆写文件；若目标为 type: local，则编辑指定的 hub YAML。

验证

  • 每次写入后解析目标 YAML。
  • 查询 mihomo 时，依次尝试两个 Unix 套接字，然后尝试已配置的 HTTP 控制器；仅在请求失败时回退，不能仅凭套接字是否存在来判断。
  • 对于路由，chains[-1] 是匹配的组，chains[0] 是拨号节点。
  • 报告变更的文件、运行的命令、证据和剩余风险。

参考资料

  • references/full-guide.md — 命令、模板和诊断矩阵
  • references/local-hub.md — hub 所有权、节点角色、对齐和注意事项

评论

支持 Markdown