拓冰网站定制 
PAIPiAI Agent 完全指南 整理定位大道至简 · 极速编程 Agent 核心特点仅4个基础工具1000 token系统提示词打招呼仅占上下文4%编程速度提升1.5–2×基准测试DataBreaK百万行代码基准Pai GPT4.8 组合在不同成本区间表现优异代码质量达到高点。 核心理念核心越小越干净模型发挥越好用户自由度最大。一、安装指南Windows右键打开PowerShell从官网复制一键安装命令执行。 未装Node.js时输入Y自动安装随后输入Y安装Pai。完成后重启终端输入pai启动。macOS打开终端执行官网提供的curl命令即可完成安装。你刚才安装的就是Windows版本安装最后一步选择Y添加PATH之后重启终端输入pai进入交互界面。二、模型配置方式一API Key在Pai中执行/login选择API Key方式。输入关键词筛选支持40模型供应商粘贴Key即可。方式二模型订阅选择Sign in with account以OpenAI订阅为例浏览器登录后CtrlL调出模型列表即可看到ChatGPT模型。常用命令/model切换模型ShiftTab调整思考强度CtrlL快速选择模型三、基础操作创建项目新建文件夹 → 在文件夹右键打开终端 → 输入pai当前目录即为项目目录。输入指令换行Shift Enter或Ctrl G打开记事本编辑保存自动同步。快速运行命令!指令前加!临时运行模型可见!!运行shell命令但模型不可见四、指令追加steering 与 follow-upSteering引导默认方式执行过程中直接追加指令立刻干预方向相当于“打方向盘”实时调整任务。Follow-up排队指令排队等当前轮次完成后才执行。Windows PowerShell 需要先删除CtrlAltEnter快捷键再用AltEnter发送macOS 使用OptionEnter。原理Pai 使用双层循环。内层循环注入steering消息实现实时响应follow-up等待内层完成后再进入外层循环。五、会话管理 SessionSession每次对话历史为一个会话/new开启新会话pai -c从最近会话继续pai -r挑选历史会话对话树/treeSession可分支回退到历史节点创建新分支仅回退对话不回退代码需要搭配git做完整代码回滚。克隆与分叉/clone复制整个Session/fork选择节点复制出新Session上下文压缩/compact手动压缩历史对话降低token占用。经验清空优于压缩任务结束建议直接开新会话。六、核心工具与哲学仅4个基础工具无MCP、无Subagent、无Todo极简换取高效支持Skill扩展。读文件读取任意文件写文件创建/覆写文件改文件精准修改内容运行命令执行Shell / Bash理念让工具来适应你的工作流而不是让你去适应工具。七、插件生态无限扩展联网搜索pai-web-search插件零配置自动接入Exa服务获得联网能力子代理 agents插件支持并行运行多个子代理例如同时开发5个风格各异网页MCP接入pai-mcp-adapter接入任意MCP server高德地图等读取.mcp.json配置旁路对话btw原生无btw安装插件后执行/btw开启旁路对话不影响主任务计划模式pai-plan插件执行/plan modeAgent先输出计划确认后执行Go模式pai-go插件执行/go给定目标Agent自动迭代多次直到完成动态工作流pai-dynamic-workflows类似Cloud Code调度多个子代理协同处理复杂任务移动端连接pai-v-chat插件手机扫码配对微信/通讯录向Pai发指令、接收结果八、Skills技能系统遵循标准Skills协议放到项目目录agents/skills或全局目录用户目录/.agents即可识别。 常用Skill示例Playwright CLI浏览器自动化操控Chrome完成网页任务Markdown Converter任意文档转Markdown需uvx工具tts文本转语音免费无需API Key获取GitHub / Skill Hub 获取技能也可以让Pai自己安装。九、网页版UI社区项目4200 Star图形界面安装后自动打开浏览器。 功能文件树浏览、项目切换模型配置与订阅管理技能/插件后台控制对话面板支持截图粘贴Token与成本统计十、记忆系统agent.md在项目目录创建agent.md每次对话自动携带该上下文避免重复交代背景。全局提示词放在用户目录.pai/agent/agent.md对所有项目生效优先级项目目录 全局目录还支持append-system.md追加系统提示十一、安全机制Pai本体几乎不设防启动后不做极高权限自动执行命令不中断设计理念不做沙箱保持极简。 安全方案容器/虚拟机隔离WSL、Docker、Hyper-V运行Pai隔离风险权限插件安装pai-permission-system敏感操作需要审批十二、让Pai自己写插件插件本质是TypeScript文件放项目目录.pai/extensions或全局配置目录。 示例插件方向天气插件从IP获取地理位置查询天气并展示在UI上文件保护禁止编辑.env文件自动拦截删除确认执行rm命令前弹窗询问十三、源码架构与SDK核心包组成pai-ai模型统一调用层适配几十家模型厂商pai-agent模型核心双循环实现Agent循环机制coding-agent编程功能4个基础工具、Skills、插件tui命令行界面SDK使用引入pai-ai的createModel接入任意模型引入pai-agent作为可嵌入Coding Agent。十四、行动建议上手步骤第一步安装Pai最小配置体验“大道至简”核心用法用steering实时纠偏用follow-up排队补充任务写agent.md让Agent记住项目背景复杂任务使用go模式 子代理并行成倍提速结语极简是一种力量。快速上手路线结合你Windows环境关闭当前终端新开PowerShell输入pai进入交互界面执行/login配置模型API Key在项目文件夹内启动写agent.md记录项目背景开始写代码 Pi Agent的基础使用
PAIPiAI Agent 完全指南 整理定位大道至简 · 极速编程 Agent 核心特点仅4个基础工具1000 token系统提示词打招呼仅占上下文4%编程速度提升1.5–2×基准测试DataBreaK百万行代码基准Pai GPT4.8 组合在不同成本区间表现优异代码质量达到高点。 核心理念核心越小越干净模型发挥越好用户自由度最大。一、安装指南Windows右键打开PowerShell从官网复制一键安装命令执行。 未装Node.js时输入Y自动安装随后输入Y安装Pai。完成后重启终端输入pai启动。macOS打开终端执行官网提供的curl命令即可完成安装。你刚才安装的就是Windows版本安装最后一步选择Y添加PATH之后重启终端输入pai进入交互界面。二、模型配置方式一API Key在Pai中执行/login选择API Key方式。输入关键词筛选支持40模型供应商粘贴Key即可。方式二模型订阅选择Sign in with account以OpenAI订阅为例浏览器登录后CtrlL调出模型列表即可看到ChatGPT模型。常用命令/model切换模型ShiftTab调整思考强度CtrlL快速选择模型三、基础操作创建项目新建文件夹 → 在文件夹右键打开终端 → 输入pai当前目录即为项目目录。输入指令换行Shift Enter或Ctrl G打开记事本编辑保存自动同步。快速运行命令!指令前加!临时运行模型可见!!运行shell命令但模型不可见四、指令追加steering 与 follow-upSteering引导默认方式执行过程中直接追加指令立刻干预方向相当于“打方向盘”实时调整任务。Follow-up排队指令排队等当前轮次完成后才执行。Windows PowerShell 需要先删除CtrlAltEnter快捷键再用AltEnter发送macOS 使用OptionEnter。原理Pai 使用双层循环。内层循环注入steering消息实现实时响应follow-up等待内层完成后再进入外层循环。五、会话管理 SessionSession每次对话历史为一个会话/new开启新会话pai -c从最近会话继续pai -r挑选历史会话对话树/treeSession可分支回退到历史节点创建新分支仅回退对话不回退代码需要搭配git做完整代码回滚。克隆与分叉/clone复制整个Session/fork选择节点复制出新Session上下文压缩/compact手动压缩历史对话降低token占用。经验清空优于压缩任务结束建议直接开新会话。六、核心工具与哲学仅4个基础工具无MCP、无Subagent、无Todo极简换取高效支持Skill扩展。读文件读取任意文件写文件创建/覆写文件改文件精准修改内容运行命令执行Shell / Bash理念让工具来适应你的工作流而不是让你去适应工具。七、插件生态无限扩展联网搜索pai-web-search插件零配置自动接入Exa服务获得联网能力子代理 agents插件支持并行运行多个子代理例如同时开发5个风格各异网页MCP接入pai-mcp-adapter接入任意MCP server高德地图等读取.mcp.json配置旁路对话btw原生无btw安装插件后执行/btw开启旁路对话不影响主任务计划模式pai-plan插件执行/plan modeAgent先输出计划确认后执行Go模式pai-go插件执行/go给定目标Agent自动迭代多次直到完成动态工作流pai-dynamic-workflows类似Cloud Code调度多个子代理协同处理复杂任务移动端连接pai-v-chat插件手机扫码配对微信/通讯录向Pai发指令、接收结果八、Skills技能系统遵循标准Skills协议放到项目目录agents/skills或全局目录用户目录/.agents即可识别。 常用Skill示例Playwright CLI浏览器自动化操控Chrome完成网页任务Markdown Converter任意文档转Markdown需uvx工具tts文本转语音免费无需API Key获取GitHub / Skill Hub 获取技能也可以让Pai自己安装。九、网页版UI社区项目4200 Star图形界面安装后自动打开浏览器。 功能文件树浏览、项目切换模型配置与订阅管理技能/插件后台控制对话面板支持截图粘贴Token与成本统计十、记忆系统agent.md在项目目录创建agent.md每次对话自动携带该上下文避免重复交代背景。全局提示词放在用户目录.pai/agent/agent.md对所有项目生效优先级项目目录 全局目录还支持append-system.md追加系统提示十一、安全机制Pai本体几乎不设防启动后不做极高权限自动执行命令不中断设计理念不做沙箱保持极简。 安全方案容器/虚拟机隔离WSL、Docker、Hyper-V运行Pai隔离风险权限插件安装pai-permission-system敏感操作需要审批十二、让Pai自己写插件插件本质是TypeScript文件放项目目录.pai/extensions或全局配置目录。 示例插件方向天气插件从IP获取地理位置查询天气并展示在UI上文件保护禁止编辑.env文件自动拦截删除确认执行rm命令前弹窗询问十三、源码架构与SDK核心包组成pai-ai模型统一调用层适配几十家模型厂商pai-agent模型核心双循环实现Agent循环机制coding-agent编程功能4个基础工具、Skills、插件tui命令行界面SDK使用引入pai-ai的createModel接入任意模型引入pai-agent作为可嵌入Coding Agent。十四、行动建议上手步骤第一步安装Pai最小配置体验“大道至简”核心用法用steering实时纠偏用follow-up排队补充任务写agent.md让Agent记住项目背景复杂任务使用go模式 子代理并行成倍提速结语极简是一种力量。快速上手路线结合你Windows环境关闭当前终端新开PowerShell输入pai进入交互界面执行/login配置模型API Key在项目文件夹内启动写agent.md记录项目背景开始写代码