Pi Bot 使用指南
16 章使用手册,从安装和模型配置开始,逐步介绍 Bot 团队、权限、审查、例行任务、连接、手机与执行端,以及自建中继和 ACP。界面截图来自运行中的客户端,使用独立测试数据或示例数据。
安装与入门
-
安装与第一次使用
了解如何在 macOS、Windows 和 Linux 安装 Pi Bot,完成首次模型配置,并在指定文件夹中运行第一个 Bot 任务。附安装、欢迎流程与首次使用截图。
-
配置 Ollama、本地模型和 API Key
学习为 Pi Bot 配置 Ollama 本地模型、OpenRouter 和自带 API Key,选择主模型与辅助模型,并排查模型连接和认证问题。
-
创建 Bot、设置角色和记忆
学习创建 Pi Bot、设置名字与角色、选择模型,并管理技能、权限和记忆。按界面入口逐步配置,让不同 Bot 分工处理任务。
-
聊天、话题、浏览器和工作收据
学习在 Pi Bot 中发消息、管理话题与附件、切换执行或只规划模式,并查看后台命令、Bot 浏览器和工作收据。附对应界面与操作步骤。
任务、协作与审批
-
多 Bot 群聊、执行计划与上下文交接
学习创建多 Bot 群聊、选择成员与统筹、确认执行计划,并跟进任务分派和上下文交接。了解成员能看到哪些群消息、输入与交付物。
-
工作文件夹、代码审查和改动管理
学习在 Pi Bot 中选择工作文件夹、检查文件差异、请求另一位 Bot 审查代码,并核对独立工作区与合入审批。附操作步骤和界面截图。
-
权限、审批和操作记录
了解 Pi Bot 的工具权限、审批卡、YOLO 模式和操作记录。学习允许或拒绝操作、检查授权范围,并了解仍需人工确认的安全边界。
-
定时任务、文件夹触发和待办
学习在 Pi Bot 中创建定时任务、文件夹触发和连接事件任务,配置产出目录、试运行与待办,并查看运行记录和任务结果。
连接与多设备
-
连接应用、MCP、技能和知识库
学习从 Pi Bot 连接页添加应用、MCP 工具、技能和知识库,管理访问令牌,并按连接状态排查配置问题。附各入口的操作说明与截图。
-
Android 配对、远程审批和离线用法
学习安装并配对 Pi Bot Android 手机 App,查看对话与任务、处理远程审批、配置离线回复,以及撤销设备或解除配对。
-
在另一台电脑或服务器上使用执行端
学习在另一台电脑或服务器上安装并配对 Pi Bot 执行端,选择工作目录、运行命令,并核对连接状态、任务输出和权限范围。
-
进阶:在编辑器中使用 Pi Bot(ACP)
学习通过 ACP 将支持该协议的编辑器(如 Zed)连接到 Pi Bot,选择 Bot 并处理命令审批。了解桌面应用、连接配置与权限要求。
维护与问题排查
-
Pi Bot 常见问题
查找 Pi Bot 安装、模型与 API Key、Ollama、工具审批、定时任务和 Android 配对的常见问题,按故障现象找到检查步骤与对应教程。
-
更新、数据存储和问题反馈
了解如何检查 Pi Bot 更新、查找本地数据目录、导出日志和反馈问题。按步骤核对版本、数据存储位置与反馈前的隐私检查。
-
数据留在哪里:隐私与安全
了解 Pi Bot 聊天、文件、记忆和密钥分别存放在哪里,以及在线模型、手机、中继与外部连接会接收什么数据。按功能核对隐私和安全边界。
-
进阶:自建中继
了解 Pi Bot 自建中继的用途、Cloudflare 部署配置、设备配对与排查步骤。部署需要获取 Pi Bot 源代码,请先核对文档中的可用性说明。