@aizigao/pi-proxy-fetch
基于域名规则的智能代理路由扩展
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@aizigao/pi-proxy-fetch。 它的用途是:基于域名规则的智能代理路由扩展 完整的 Skill 内容见:https://321skill.com/skills/aizigao-pi-proxy-fetch/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'给Pi配置代理,让api.openai.com和api.anthropic.com直连,其他网站通过http://127.0.0.1:7890代理访问,失败时自动回退',它会自动在~/.pi/proxy.json中生成规则,并立即生效。之后所有fetch请求都会按规则路由,无需手动切换。
介绍
这个Skill解决了AI编码代理在访问外部网络时,需要根据目标域名智能选择直连或代理的问题。在实际开发中,AI代理需要调用OpenAI、Anthropic等API,这些必须直连以确保低延迟和稳定性;同时抓取网页内容时可能需要通过代理访问受限资源。手动切换代理配置繁琐且容易出错,而全局代理又会拖慢AI服务的响应速度。
使用方式很简单,你只需要在~/.pi/proxy.json中配置规则,定义哪些域名直连、哪些强制走代理、哪些先直连失败后回退给代理。之后通过/proxy命令可以打开设置菜单,一键开关代理、查看请求统计、热加载配置。Pi扩展会自动修补globalThis.fetch,按规则路由所有网络请求,无需手动修改代码。
它非常适合需要配置编码代理的AI编码代理用户,尤其是那些同时使用多个AI服务(如OpenAI、Anthropic、Google)和需要抓取外网内容的团队或个人。已经使用Pi作为编码助手的开发者可以无缝集成,无需额外学习成本。对于经常切换网络环境(如在家办公、出差)的开发者,也能快速适配。
建议在初始化代理规则时,优先将AI API域名加入直连列表,避免代理影响AI响应速度。需要注意的是,它只拦截fetch请求,不拦截其他HTTP客户端(如axios、node-fetch),如果使用其他库需额外配置。此外,规则匹配是自上而下的,第一个匹配项生效,因此需要将精确域名放在通配符前面。
常见问题
如何配置多个域名规则?
在`~/.pi/proxy.json`的rules数组中添加多个对象,每个对象包含match(匹配模式)、action(direct/proxy/fallback)和comment(可选注释)。支持通配符如*.example.com、10.*等,规则自上而下匹配,第一个命中生效。
如何查看代理统计和重载配置?
在Pi中发送`/proxy`命令打开设置菜单,选择
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/aizigao-pi-proxy-fetch/raw/index.md 读取 @aizigao/pi-proxy-fetch 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/aizigao-pi-proxy-fetch/raw/index.md(查看排版版本)