自动维护 Google Firebase Cloud Messaging (FCM) 优选 Hosts。项目在中国大陆双栈机器上直接采集、实测、发布，目标是给 Android / microG / Google Play services 提供更稳定的 FCM 长连接入口。

当前生产架构是单机流水线：

1. Harvest：使用 EDNS Client Subnet (ECS) 查询 mtalk.google.com，采集候选 IPv4/IPv6。
2. Seed：读取仓库内上一轮成功的 fcm_*.hosts，把历史可用 IP 继续作为种子。
3. Verify：在大陆双栈 self-hosted runner 上对候选 IP 执行 TCP 5228 连接测速。
4. Expand：对已成功 IP 做小范围邻近扩展，再次实测。
5. Publish：生成并提交 fcm_ipv4.hosts、fcm_ipv6.hosts、fcm_dual.hosts。

核心实现是 Go 单二进制，无 Python runtime、无 pip 依赖、无跨 runner artifact 搬运。

• fcm_dual.hosts：推荐。双栈输出；若某次只选出单栈，会自动降级。
• fcm_ipv6.hosts：纯 IPv6 输出。
• fcm_ipv4.hosts：纯 IPv4 输出。

默认每天更新 4 次；临时刷新可手动触发 GitHub Actions。

服务器分发地址：

https://fcm-hosts.cagedbird.cn/fcm_dual.hosts

向后兼容地址（旧路径，仍可用）：

https://cagedbird.cn/fcm-hosts-next/fcm_dual.hosts

可用于：

• 系统 hosts 定时拉取并原子覆盖。
• sing-box / Clash 的 hosts 数据源。

go test ./...
go run ./cmd/fcmhost run -workdir .

常用调试：

go run ./cmd/fcmhost run -workdir . -dns=false -v

-dns=false 只使用现有 hosts/raw seeds 做验证，适合快速确认当前网络能否连通 FCM 5228。

Status: Automated / Mainland dual-stack verified

• 自动化运行 / runner 发布 / 本地验证 -> .agents/skills/runner-publish/SKILL.md

• .agents/skills/runner-publish/SKILL.md: 管理 FCM hosts 更新流水线、SSH 秘钥配置与本地运行验证。Trigger: 修改 GitHub Actions 工作流、排查 hosts 刷新/服务器发布故障或验证业务代码。

• README.md: 架构、产物列表与基本用法

Agent 应该首先读取 AGENTS.md 了解项目级硬规则与定位，随后根据任务选择读取对应的 skill 或文档，禁止无序扫描整个仓库。