@qraxiss/pi-gemini-auth

为Pi平台提供Gemini OAuth认证兼容的扩展包

安装使用

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

帮我安装这个 AI Skill:@qraxiss/pi-gemini-auth。
它的用途是:为Pi平台提供Gemini OAuth认证兼容的扩展包
完整的 Skill 内容见:https://321skill.com/skills/qraxiss-pi-gemini-auth/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“帮我在Pi Skill里集成Gemini Pro模型来总结用户上传的文档。”,它会引导你安装此扩展包,并指导你配置OAuth凭证。之后在你的Skill代码中,你可以调用该包提供的方法自动获取访问令牌,然后轻松调用Gemini API处理文档内容。

介绍

该Skill解决了在Pi平台上使用Gemini API时,因认证方式不匹配而无法直接调用的问题。它作为一个中间适配层,将Pi平台自身的认证机制与Gemini API所需的OAuth流程进行桥接,使得开发者无需自行处理复杂的OAuth令牌获取与刷新逻辑。

使用方式通常是在Pi平台的Skill开发中,通过npm安装此包并导入,调用其提供的认证函数来获取访问Gemini API所需的、有效的Bearer Token。开发者只需提供必要的配置(如API密钥或服务账号信息),该包会处理后续的令牌生命周期管理。

它主要适合在Pi平台上开发集成Gemini模型(如Gemini Pro、Gemini Flash)功能的Skill开发者。无论是构建聊天机器人、内容生成工具还是数据分析应用,只要需要安全、合规地调用Gemini API,都可以使用此包简化认证环节。

在使用时,建议开发者仔细阅读Gemini API的官方文档,了解其配额、速率限制和可用模型。同时,务必妥善保管你的API密钥或服务账号凭证,避免在客户端代码中硬编码敏感信息,建议通过Pi平台的安全配置项或环境变量来管理。

核心特点

这是专为Pi平台生态定制的Gemini OAuth适配器,而非通用Node.js库,深度集成了Pi的运行时环境与配置管理。它封装了Pi平台特有的凭证获取流程,与Gemini的OAuth 2.0服务端流程无缝对接,省去了开发者手动实现令牌交换与刷新的工作。

注意事项

此Skill仅适用于在Pi平台内部开发Skill,不适用于其他AI Agent平台或独立的Node.js项目。

常见问题

这个包和直接用Google的官方Gemini SDK有什么区别?

此包专注于解决Pi平台与Gemini OAuth的认证兼容,在Pi环境中自动处理凭证,而官方SDK需要开发者自行管理整个OAuth流程或使用API密钥。

需要自己申请Google Cloud项目和OAuth凭证吗?

是的,你需要拥有一个启用了Gemini API的Google Cloud项目,并配置好OAuth 2.0客户端ID或服务账号。

给 AI 助手的安装指引

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

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