Obsibrain AI Alpha
设置可选的桌面仓库聊天，选择服务提供商，并了解只读访问和数据传输。
本页内容
Obsibrain AI Alpha 是可选的桌面只读仓库聊天功能。它可以搜索和读取当前仓库，并引用源笔记。它不能创建、编辑、移动或删除笔记。
Obsibrain 核心工作流程不需要 AI。
Obsibrain 为什么使用 Pi
Pi 是本地聊天运行环境，不是 AI 模型提供商。Obsibrain 通过 Pi 的 RPC 接口运行聊天面板。Pi 负责提供商登录、模型选择和会话历史。你通过 Pi 选择提供商和模型；Obsibrain 不保存提供商凭据。
Pi 独立运行时可以调用其他工具。Obsibrain 启动 Pi 时只提供受保护的 Obsidian CLI 工具，并将其限制为读取当前仓库。此面板是可选功能，核心流程不依赖 Pi。
安装并连接 Pi
此面板需要 Obsidian CLI 和 Pi CLI 0.84.2 或更高版本。使用 Node.js 22.19 或更高版本及 npm 安装 Pi：
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi --version确认 pi --version 显示的版本不低于 0.84.2。Windows 用户可按需查看 Pi 的 Windows 安装指南。
- 在终端运行
pi，再在 Pi 中使用/login连接 AI 提供商。你需要受支持的提供商账户或 API 密钥。 - 按照 Obsidian 指南安装并启用 Obsidian CLI。
- 打开 Settings → Obsibrain，找到 AI 设置。
- 如果自动发现失败，请设置 Pi CLI 或 Obsidian CLI 的可执行文件路径。
- 在命令面板中运行
Open Obsibrain AI (Alpha)，或使用机器人图标。
在面板中选择可用模型。思考控制选项取决于模型和 Pi 配置。
聊天前检查授权
在仓库中发送第一条消息前，面板会请求同意，将仓库摘录发送给你的 AI 服务提供商。聊天提示、指令和获准读取工具返回的内容都可能传给该提供商。
提供商的数据保留和账户政策适用。这不代表 AI 始终在本地运行。如果不希望发送这些内容，请拒绝该告知请求。
提问并验证
针对当前仓库提问，例如哪些笔记描述了项目成果。打开引用的笔记链接，对照来源检查答案。
受保护的工具仅允许白名单中的 Obsidian CLI 读取操作和当前仓库导航。它拒绝写入、其他程序、其他仓库、.obsidian 和隐藏技术路径。
同一个 Pi 会话会跨 Obsidian 启动会话保留。New Chat 创建新会话，之前的会话仍保留在 Pi 历史中。Pi 在 Obsibrain 之外保存服务提供商凭据和会话历史。
在 Obsibrain 设置中编辑 AI 指令，以指导新聊天。如果前置工具不可用，请参阅故障排查，并继续使用核心工作流程。