Pi Panel

一句话：把 pi coding agent 塞进 Obsidian 侧边栏 —— 边看笔记边提问，一键把当前笔记 / 选区 / 图片丢给 pi，让它在你的库里读、写、改。

项	值
仓库 / 下载	https://github.com/zzzzzllllllaaaa/obsidian-pi-panel
最新版本	0.5.6
平台	桌面端（本机跑 pi）；移动端需配「远程模式」连电脑上的桥。最低 Obsidian 1.7.2
装法	Obsidian 里搜 Pi Panel 直接装（也可以手动下 Release 三件套）
授权	MIT（随便用，商用也行）
作者	我（3zh）

它能干什么

侧边栏聊天面板：ribbon 图标或命令面板打开；流式输出，正文、thinking（可折叠）、工具调用卡片分开渲染（名称 + 参数摘要 + 耗时 + 输出，出错自动展开）
一键引用：笔记 按钮给当前打开的笔记（超长只给 @路径）、选区 按钮给选中段落（带文件:行号）、图片直接粘贴
扩展 UI 弹窗在面板内应答：pi 要 confirm / select / input 时不用切终端，agent 不会挂住
历史会话：可回放、可重命名、新会话 / 继续上次
模型：面板头点模型名即时切换（不重启进程）；设置页能直接增删改 models.json
工具权限白名单：--tools 传什么就是什么，默认不给 bash
工作目录与笔记目录分离：cwd 可以指向带 AGENTS.md 的项目目录，笔记照旧在 vault
远程模式：手机 Obsidian 走 WebSocket 连电脑上的桥（ws://<电脑IP>:8770，或放进自己的 TLS 中继用 wss://），出门也能用

在 Obsidian 里装（推荐）：设置 → 第三方插件 → 浏览 → 搜 Pi Panel → 安装 → 启用。

手动装：到 Releases 下载 main.js、manifest.json、styles.css，放进 <你的库>/.obsidian/plugins/pi-panel/，重启 Obsidian 启用。

前置条件：本机装了 pi CLI（终端 pi --help 能用）。如果 Obsidian 找不到 pi（GUI 进程的 PATH 常常没有 npm 全局 bin），设置里填绝对路径，比如 %APPDATA%\npm\pi.cmd。

移动端不完整：手机跑不了 pi，必须配远程桥；而且远程模式的工具白名单建议只给 read,grep,find,ls —— 给了 bash 等于手机能操作你整台电脑
桥要自己管：桥必须带 token，别把端口暴露公网
规则文件位置：pi 从 cwd 往上找 AGENTS.md；面板默认 cwd 是 vault 根，所以放在项目目录里的规则不会被读到——想用就在设置里指定「附加系统提示文件」或改「工作目录」
会话列表是扫文件：session_info 追加在 JSONL 末尾，长会话要读尾部才拿得到新名字（已处理，但读大文件有开销）
个人项目：不追功能、不承诺维护节奏，够自己用就行

两个都是 Obsidian 插件，但路子不同：

AI Chat Assistant —— 全能型：自带多模型接入、本地向量库、RAG、智能体、MCP，自己就是一个完整 AI 客户端
Pi Panel —— 薄壳：什么都不自己实现，就是把 pi coding agent 的进程嵌进侧边栏，能力全在 pi 那边（终端里的工具、规则、技能都能用）

简单说：想让 AI 自己管好笔记检索，用前者；想让终端里那套 agent 直接对着笔记干活，用后者。