@aizigao/pi-proxy-fetch

基于主机名规则智能路由fetch请求的Pi扩展包

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@aizigao/pi-proxy-fetch。
它的用途是:基于主机名规则智能路由fetch请求的Pi扩展包
完整的 Skill 内容见:https://321skill.com/skills/aizigao-pi-proxy-fetch/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘帮我在项目中配置@aizigao/pi-proxy-fetch,让所有访问api.internal.com的请求直连,而访问external.service.com的请求通过我的本地代理8080端口。’ 它会引导你完成安装,并生成相应的配置代码示例。

介绍

该Skill旨在解决开发者在复杂网络环境下(如混合了内网、代理、公网服务)进行网络请求时,需要手动切换代理配置或处理跨域问题的痛点。它通过一个统一的fetch接口,根据预设的域名规则,自动将请求路由至直连、代理或备用路径,简化了网络请求的配置与管理。

使用方式非常简单:安装此扩展包后,在您的Pi项目中引入并配置相应的主机名规则即可。例如,您可以指定某些内部域名直接访问,某些外部域名通过特定代理访问,而其他域名则使用备用的请求策略。它接管了全局的fetch函数,无需修改现有业务代码中的每个请求。

该Skill非常适合前端开发者、全栈工程师以及需要在不同网络环境(如公司内网开发、跨地域部署测试)下工作的项目团队。它尤其有助于那些需要同时与多个具有不同网络策略的后端服务进行交互的应用程序。

在使用建议上,请注意仔细规划和测试您的域名匹配规则,避免规则冲突导致请求被错误路由。对于生产环境,建议将规则配置外部化,以便于不同环境的灵活切换。同时,需关注代理服务器的可用性与性能,避免因代理故障成为单点瓶颈。

核心特点

与同类网络请求代理工具相比,其核心区别在于提供了基于主机名规则的、声明式的智能路由策略,并能无缝集成到Pi生态中,直接替换全局fetch,无需侵入业务逻辑。

注意事项

不适合对请求路由有极低延迟要求或需要复杂、动态路由逻辑(如基于请求内容而非主机名)的场景。

常见问题

如何配置代理规则?

在引入包后,通过配置对象定义主机名模式与对应的代理或直连行为。

会影响现有的fetch调用吗?

会透明地接管globalThis.fetch,现有代码无需修改即可生效。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/aizigao-pi-proxy-fetch/raw/index.md 读取 @aizigao/pi-proxy-fetch 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。