---

name: maintain-clash-scripts description: Maintain helper scripts under scripts/ for this repo (update_direct_from_cn.py, update_dns.py, update_dns_rules.sh, update_zashboard.sh). Use when creating, modifying, or documenting these scripts, or when wiring their outputs into repo files or cron tasks.

Maintain Clash Scripts

Scope

• Work within scripts/ and keep behavior aligned with OpenClash/Mihomo usage.
• Update scripts/README.md whenever a script’s behavior, options, or usage changes.

Script-specific guidance

• Preserve update_direct_from_cn.py markers and keep output normalized to IP-CIDR/IP-CIDR6 with ,no-resolve.
• Keep update_dns.py output at force_ttl_rules.txt and retain DNS failover + source URL list handling.
• Keep update_dns_rules.sh safety checks (download success, non-empty file, header check) and allow user-configurable REMOTE_URL/LOCAL_FILE/RESTART_CMD.
• Keep update_zashboard.sh target under /usr/share/openclash/ui/zashboard, OpenWrt-friendly download tooling, and quiet-by-default behavior.

Guardrails

• Avoid changing user-specific URLs, paths, or cron schedules unless asked.
• Keep shell scripts POSIX sh compatible (busybox ash friendly).
• Prefer minimal dependencies and clear configuration blocks at the top of scripts.