SuperAPI AI 工具集

pi-agent

编程与开发

查看项目

更新于 10-15 23:43

技能介绍

用途:当用户想操作 Pi 或在 Pi 之上构建时使用本技能。Pi 是一个极简终端编码工具,可通过 TypeScript 扩展、技能、提示模板、主题、包、自定义模型/提供商、SDK、RPC 模式、JSON 事件流和 TUI 组件进行扩展。

主要能力与参考文档:概览与安装(references/overview.md、quickstart.md)、日常 CLI 用法与项目信任(usage.md)、提供商认证与 API 密钥(providers.md)、自定义模型与本地模型/代理(models.md)、本地 llama.cpp 路由与 /llama(llama-cpp.md)、设置项与环境变量(settings.md、environment-variables.md)、扩展开发(extensions.md)、自定义提供商与 OAuth(custom-provider.md)、SDK 嵌入(sdk.md)、RPC 集成(rpc.md)、JSONL 事件(json.md)、TUI 组件(tui.md)、打包(packages.md)、子智能体与编排(pi-subagents.md)、MCP(mcp.md 内置,pi-mcp-adapter.md 可选适配器)、交互式访谈(pi-interview.md)、网页访问(pi-web-access.md)、技能编写(skills.md)、提示模板与主题、会话与压缩、安全与容器化、键盘与终端问题、Pi 自身开发。

构建方式选择:Node/TypeScript 应用优先用 SDK,单会话用 createAgentSession(),需替换会话用 createAgentSessionRuntime(),认证与模型查找走 ModelRuntime.create()。非 Node 客户端、需进程隔离或语言无关 JSONL 协议时用 RPC 模式,先以 pi --mode rpc --no-session 做无状态集成;RPC 客户端按唯一请求 id 关联响应,订阅后再发提示,等待 agent_settled。一次性命令行管道用 JSON 模式:pi --mode json "prompt"。Pi 原生行为用扩展,跨机器共享用包。

常用命令:npm install -g --ignore-scripts @earendil-works/pi-coding-agent;pi;pi -p "Summarize this codebase";pi --mode json "List files";pi --mode rpc --no-session;pi --provider anthropic --model claude-sonnet-4-5;pi --model sonnet:high "Solve this complex problem";pi --tools read,grep,find,ls -p "Review this repository";pi --tui-mode fullscreen;pi install npm:pi-subagents;pi update --all。

限制与安全:Pi 默认本地运行且无沙箱,扩展、包、技能、shell 命令和项目内 .pi 资源均以 Pi 进程权限执行;项目信任只控制加载哪些项目输入,不是沙箱。不可信仓库或无人值守自动化应使用 Docker、OpenShell、Gondolin、VM 或远程沙箱隔离。不要把密钥写入项目文件,优先用环境变量、~/.pi/agent/auth.json、/login 的 OAuth 或命令式密钥查询。参考文档基于 Pi 0.99.2(2026-09-30)及 pi-subagents 0.74.0、pi-mcp-adapter 4.0.0、pi-interview 0.13.0、pi-web-access 0.35.0;认证流程、付费模型/搜索调用、图形界面和外部沙箱仅经文档验证。适配其他版本前请检查 pi --version、pi --help、已安装包 README 与 TypeScript 声明。