【rpi 更新】 0.1.13 后续开发：让本地扩展和 package 更新更可控
内容提要
rpi 是用 Rust 构建的可组合 LLM Agent SDK 和终端编码 Agent。近期更新：新增本地扩展开发模式，仅加载项目内资源以便调试；将更新命令拆分为 Rust 扩展、Pi 包和 CLI 三类；项目包默认加载，可用 --no-approve 关闭；修复 TUI 工具面板空状态显示问题。稳定能力包括异步流式 Agent loop、多 provider、对齐 Pi 的工具、JSONL 会话与稳定 ABI。
延伸解读
本地扩展开发模式：隔离调试环境
新增的 rpi dev-local 和 rpi dev --local-only 命令，让开发者只加载当前项目的 .rpi/skills、.pi/skills、项目配置资源以及正在开发的扩展资源。这避免了全局 package 和其他扩展的干扰，使调试更专注。同时，/reload 也沿用相同的本地资源范围，适合编写和调试项目内的 skill 或 Rust 原生扩展。
更新命令拆分：更细粒度控制
更新命令被拆分为三类：rpi update 只更新 Rust 原生扩展，rpi pi-update 只更新 Pi npm/Git package，rpi self-update 更新 rpi CLI 自身。旧的 rpi package update 仍保留以兼容同时更新两类 package 的工作流。这种拆分避免了单次更新触发所有类型，也更容易在出现问题时定位是哪一类依赖造成的。
项目 package 默认加载：便利与风险
项目资源现在默认直接加载，不再每次交互启动时询问确认。对于不希望加载当前项目 package 的场景，可以显式使用 rpi --no-approve。由于项目资源可能包含扩展代码和命令，建议只在可信项目中启用；需要隔离范围时可以使用 rpi dev-local 或 --no-approve。
TUI 工具面板修复：提升交互体验
交互式 TUI 现在会延迟空的工具进度回调，等到工具真正开始执行后再创建面板，因此首次调用工具时不会先出现没有参数和内容的空面板。同时，工具选择器会把“空列表代表全部内置工具”的内部状态正确展开为当前启用的工具，首次打开 /tools 时不会误显示为全部关闭，也不会因为切换一个工具而意外丢失其他默认工具。
Q&A
rpi 是什么？
rpi 是用 Rust 构建的可组合 LLM Agent SDK 和终端编码 Agent。
rpi 的本地扩展开发模式怎么用？
可以使用 rpi dev-local 或 rpi dev --local-only 命令。该模式只加载当前项目的 .rpi/skills、.pi/skills、项目配置资源以及当前正在开发的扩展资源，避免全局 package 和其他扩展干扰调试。
rpi 的更新命令拆成了哪几类？
拆分为三类：rpi update 只更新 Rust 原生扩展；rpi pi-update 只更新 Pi npm/Git package；rpi self-update 更新 rpi CLI 自身。旧的 rpi package update 仍然保留，用于兼容同时更新两类 package 的工作流。
如何关闭 rpi 项目 package 的默认加载？
可以使用 rpi --no-approve 显式关闭。项目资源现在默认直接加载，不再在每次交互启动时询问确认。
rpi 的 TUI 工具面板有什么改进？
TUI 现在会延迟空的工具进度回调，等到工具真正开始执行后再创建面板，因此首次调用工具时不会先出现空面板。同时，工具选择器会把“空列表代表全部内置工具”的内部状态正确展开为当前启用的工具，首次打开 /tools 时不会误显示为全部关闭，也不会因为切换一个工具而意外丢失其他默认工具。
rpi 有哪些稳定能力？
稳定能力包括：Rust 原生的异步、流式 Agent loop；Anthropic、OpenAI-compatible 和 faux provider；与 Pi 对齐的 read、write、edit、bash 工具；JSONL session、上下文压缩和 AgentHarness；rpi-plugin-sdk 稳定 ABI；可嵌入的多 crate SDK 和 rpi 终端 CLI。
rpi 的哪些功能还处于 Beta 阶段？
Node/TypeScript 扩展桥接和 TUI 原生技能调用渲染目前仍属于 Beta，建议仅用于本地评估和兼容性测试，暂不建议用于生产环境。
如何快速开始使用 rpi？
安装稳定版 CLI：cargo install rpi-cli --version 0.1.13。然后可以运行 rpi -p "检查当前项目结构并列出最值得优先修复的问题"。不需要 API Key 的本地示例：git clone https://github.com/bigfish1913/pi-rust.git，cd pi-rust，cargo run -p minimal。
