@aliou/pi-ts-aperture
通过Tailscale Aperture路由Pi的LLM请求
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@aliou/pi-ts-aperture。 它的用途是:通过Tailscale Aperture路由Pi的LLM请求 完整的 Skill 内容见:https://321skill.com/skills/aliou-pi-ts-aperture/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'用Aperture提供商调用GPT-4写一个Python脚本,实现斐波那契数列',它会自动通过Aperture路由请求,无需你手动配置任何API密钥,直接返回代码。你也可以说:'列出Aperture暴露的所有MCP工具',它会调用aperture_connector_list元工具返回可用工具列表。
介绍
这个Skill解决了Pi用户需要管理多个LLM提供商API密钥且无法集中路由的问题。在实际开发中,开发者经常需要为不同模型切换不同提供商,并手工管理凭证,容易泄露且效率低下。
使用方式很简单,你只需要先安装扩展,然后运行 /aperture:onboarding 向导,输入你的Aperture网关URL,选择需要的能力(专用provider、代理现有provider或连接MCP工具),之后就可以通过自然语言指令来调用模型,所有请求都会自动通过Aperture路由,无需在客户端存储任何上游凭证。
它非常适合需要统一管理LLM调用和MCP工具暴露的团队或个人。尤其是那些已经使用Tailscale搭建私有网络,希望将AI网关、API密钥管理和请求路由一体化管理的用户。
建议在配置Aperture前确保网关已正确启动并暴露了可用模型列表。需要注意的是,该扩展依赖Pi v0.8+版本,且Aperture暴露的模型能力映射为默认值(128k上下文等),如需自定义模型参数需手动编辑 ~/.pi/agent/models.json。
常见问题
如何获取Aperture URL?
运行 `/aperture:onboarding` 向导时输入你的Aperture网关地址,向导会进行健康检查。你也可以在 `/aperture:settings` 中随时修改。
可以同时使用专用provider和代理模式吗?
可以。在 `/aperture:settings` 中你可以分别开启或关闭专用provider、代理现有provider和连接器功能,三者互不冲突。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/aliou-pi-ts-aperture/raw/index.md 读取 @aliou/pi-ts-aperture 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/aliou-pi-ts-aperture/raw/index.md(查看排版版本)