@danypops/pi-ipv4-fallback
在树莓派启动时探测IPv6连通性，若失败则全局优先使用IPv4，解决网络超时问题。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@danypops/pi-ipv4-fallback。 它的用途是：在树莓派启动时探测IPv6连通性，若失败则全局优先使用IPv4，解决网络超时问题。 完整的 Skill 内容见：https://321skill.com/skills/danypops-pi-ipv4-fallback/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我的树莓派应用在连接公司VPN后，调用Google Cloud API经常超时，怀疑是IPv6问题，帮我看看怎么用这个Skill。’，它会引导你安装并集成此模块到启动脚本中，解释其如何通过启动时探测来规避IPv6黑洞，从而稳定API连接。
介绍
该Skill旨在解决在特定网络环境（如某些VPN）下，由于IPv6被黑洞（blackhole）而非正常拒绝，导致应用（如OAuth认证、Vertex AI ADC令牌获取）出现难以诊断的网络超时问题。它通过在进程启动时执行一次IPv6可达性探测，如果发现IPv6不可用，则强制整个进程优先使用IPv4协议栈，从而绕过有问题的IPv6路由，确保网络请求的可靠性。
使用方式非常简单，通常只需在树莓派启动脚本或应用初始化代码中引入此模块即可。它会自动执行探测并根据结果设置系统的网络地址选择策略（Address Selection Policy），无需用户进行复杂的配置或手动干预网络设置。整个过程对上层应用透明，旨在无缝修复连接问题。
该Skill非常适合在树莓派等嵌入式设备上开发或部署网络应用，尤其是那些需要稳定访问外部API（如Google Cloud服务）的开发者。当你的应用在特定网络（尤其是配置了某些企业VPN的网络）下遭遇神秘且间歇性的超时，而常规网络诊断工具又显示连接正常时，这个Skill可能正是你需要的解决方案。
建议在部署到生产环境前，在目标网络中进行充分测试，以确认其能有效解决你的特定超时问题。需要注意的是，此Skill的决策是基于启动时的一次性探测，如果运行过程中网络状态发生变化（例如VPN连接断开重连），它不会动态调整。因此，它最适合网络配置相对稳定的场景。
核心特点
与一般网络配置工具不同，它专门针对“IPv6黑洞”这一特定但棘手的问题，通过进程级别的地址选择策略修复，而非简单的禁用IPv6，能更精准地解决OAuth等库因IPv6连接挂起导致的超时。
注意事项
不适合网络环境在进程运行期间动态变化的场景，也无法解决非IPv6黑洞引起的其他网络问题。
常见问题
这个Skill能修复所有网络超时吗？
不能，它专门针对因IPv6被黑洞（连接挂起）导致的特定超时，对其他原因（如DNS故障、防火墙阻断）无效。
它会影响设备上其他进程的网络连接吗？
不会，它只修改调用它的当前进程的网络地址选择策略，是进程隔离的。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/danypops-pi-ipv4-fallback/raw/index.md 读取 @danypops/pi-ipv4-fallback 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/danypops-pi-ipv4-fallback/raw/index.md（查看排版版本）