---

name: maintain-clash-mihomo-config description: Maintain and update this Clash/Mihomo configuration repo (mihomo.yaml, mihomo.js, rules/*.list, *Merged.list, force_ttl_rules.txt). Use when editing proxy groups, rule providers, DNS/TTL rules, or regenerating merged lists in this project.

Maintain Clash Mihomo Config

Overview

Keep the Mihomo/Clash config, custom rules, and generated lists consistent in this repo, following the project guardrails.

Key files

• mihomo.yaml: primary Mihomo/Clash config (providers, DNS, proxy groups, rule providers, rules)
• mihomo.js: JS config generator; keep group and rule names identical to mihomo.yaml
• rules/*.list: custom rule lists in Clash classical text format
• *Merged.list: generated/merged rule lists with source headers
• force_ttl_rules.txt: generated PaoPaoDNS rules
• scripts/update_dns.py: regenerate force_ttl_rules.txt (requires network and requests)
• scripts/update_dns_rules.sh: server-side updater for PaoPaoDNS
• Chinese-named directories: ImmortalWrt build notes and ACL4SSR archive (treat as notes/vendor data)

Update workflows

Custom rules

• Edit the relevant file in rules/.
• Ensure the rule list is referenced in mihomo.yaml or mihomo.js.
• Keep one rule per line using Clash keywords DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD, IP-CIDR, IP-CIDR6 with optional ,no-resolve.

Mihomo config

• Keep proxy group names and rule targets identical across mihomo.yaml and mihomo.js.
• Keep placeholders __MEIYING_URL__ and __YUNDONG_URL__ intact unless updating subscription URLs.

PaoPaoDNS rules

• Run python scripts/update_dns.py to refresh force_ttl_rules.txt.
• Expect network access and the requests package to be available.

Merged lists

• Regenerate from the sources listed in each file header.
• Preserve headers and metadata; avoid manual edits unless regenerating.

Validation

• Validate YAML syntax for mihomo.yaml.
• Validate JS syntax for mihomo.js.
• Verify rule list formatting (one rule per line, valid Clash keywords).