SuperAPI AI 工具集

pi-sdk

通用与其它

查看项目

更新于 10-16 07:17

技能介绍

用途:帮助开发者用 Pi 的 TypeScript SDK 做进程内集成,构建、调试或解释与 Pi 编码智能体的集成代码。要求所有 API 名称、导入、选项和事件都依据与已安装 Pi 版本匹配的文档或类型,不得仅凭 CLI 推断 SDK 行为。

主要能力:按任务读取技能内文档——用 reading.md 确认已安装包、SDK 文档、版本及源码检出是否不一致;按 sessions、运行时替换、事件、工具、资源、模型、运行模式读取 patterns.md;应用使用 Effect v4 时读 effect-integration.md 及仓库 Effect 技能的相关分支;需要使用 ChatGPT Plus/Pro Codex 订阅时读 openai-codex-subscription.md。

使用方式:优先选择满足需求的最小接口——进程内 TypeScript 控制用 SDK,进程隔离或语言无关控制用 RPC,Shell 级自动化用 CLI/print/JSON 模式。新增导入或依赖前先检查项目的包管理器、TypeScript 配置和既有集成约定;用项目中最窄且有意义的类型检查、测试或冒烟命令验证,并报告 Pi 版本、包/文档来源、已检查文件以及任何不一致或未验证假设。API 路由建议:基本提示、流式文本、中止或清理用 AgentSession;新建、切换、fork、克隆或导入 JSONL 用 AgentSessionRuntime;流中提示排队区分 steer() 与 followUp();自定义工具用 defineTool() 和 customTools,需要生命周期钩子、命令或 UI 时用扩展;技能、扩展、提示模板、主题和上下文文件用 ResourceLoader;模型选择与认证用 ModelRuntime。

限制与安全边界:会话可能暴露 bash、edit、write,文档或检查任务应使用显式只读工具白名单(read、grep、find、ls)。不得打印、复制、提交或硬编码 auth.json、API 密钥、OAuth 令牌、提供方请求头、models.json 密钥、会话或机器特定路径。ModelRuntime 可能读取 Pi 凭据和模型配置,测试需要凭据时应优先使用内存凭据存储或显式不持久化的运行时覆盖,且绝不暴露其值。不得从请求的本地模型或提供方静默回退到云提供方,应分别验证所选模型和端点。不应仅为回答文档问题而安装包、修改 Pi 设置或运行带写工具的智能体。完成清单包括核对已安装 pi 版本和包范围、阅读匹配的 sdk.md/类型/源码/官方文档、明确 SDK、RPC 与 CLI 边界、工具与凭据遵循最小权限且不泄漏、完成类型检查/测试或明确说明验证限制。资料未提供具体安装命令、代码示例细节与平台支持信息。