https://blog.bigfisharc.cn 记录技术和生活 Zola zh Thu, 15 Oct 2026 09:00:00 +0800 Thu, 15 Oct 2026 09:00:00 +0800 bigfish https://blog.bigfisharc.cn/blog/20261015-0900-rpicha-jian-abijia-zai-ji-zhi/ https://blog.bigfisharc.cn/blog/20261015-0900-rpicha-jian-abijia-zai-ji-zhi/ <p>很多人第一次看到 rpi 的 Rust 插件，会把它理解成“编译出一个动态库，然后让 rpi 找到它”。这句话方向没错，但省略了最关键的部分：动态库如何证明自己是一个 rpi 插件？注册的工具如何跨过 Rust 边界？一次调用结束后，插件里的内存由谁释放？源码目录里的 crate 又是怎样变成项目里的 package 的？</p> <p>这篇文章从 <code>examples/plugin-stub</code> 这样的最小 demo 开始。我们可以先从这个简单例子入手，再沿着 <code>rpi-plugin-sdk</code>、<code>rpi-extensions</code> 和 <code>rpi-cli</code> 的实现，解释这条链路：</p> <pre class="giallo z-l-code z-d-code" ><code data-lang="mermaid"><span class="giallo-l"><span class="z-l-13 z-d-8">flowchart</span><span class="z-l-9 z-d-6"> LR</span></span> <span class="giallo-l"><span class="z-l-3 z-d-10"> A</span><span class="z-l-13 z-d-8">[</span><span class="z-l-12 z-d-5">插件源码\nRust crate</span><span class="z-l-13 z-d-8">]</span><span class="z-l-13 z-d-8"> --&gt;</span><span class="z-l-3 z-d-10"> B</span><span class="z-l-13 z-d-8">[</span><span class="z-l-12 z-d-5">cdylib\n.dll / .so / .dylib</span><span class="z-l-13 z-d-8">]</span></span> <span class="giallo-l"><span class="z-l-3 z-d-10"> B </span><span class="z-l-13 z-d-8">--&gt;</span><span class="z-l-3 z-d-10"> C</span><span class="z-l-13 z-d-8">[</span><span class="z-l-12 z-d-5">rpi 加载器\nlibloading</span><span class="z-l-13 z-d-8">]</span></span> <span class="giallo-l"><span class="z-l-3 z-d-10"> C </span><span class="z-l-13 z-d-8">--&gt;</span><span class="z-l-3 z-d-10"> D</span><span class="z-l-13 z-d-8">[</span><span class="z-l-12 z-d-5">rpi_plugin_register</span><span class="z-l-13 z-d-8">]</span></span> <span class="giallo-l"><span class="z-l-3 z-d-10"> D </span><span class="z-l-13 z-d-8">--&gt;</span><span class="z-l-3 z-d-10"> E</span><span class="z-l-13 z-d-8">[</span><span class="z-l-12 z-d-5">HostApi + ExtensionRegistry</span><span class="z-l-13 z-d-8">]</span></span> <span class="giallo-l"><span class="z-l-3 z-d-10"> E </span><span class="z-l-13 z-d-8">--&gt;</span><span class="z-l-3 z-d-10"> F</span><span class="z-l-13 z-d-8">[</span><span class="z-l-12 z-d-5">RegistrySnapshot</span><span class="z-l-13 z-d-8">]</span></span> <span class="giallo-l"><span class="z-l-3 z-d-10"> F </span><span class="z-l-13 z-d-8">--&gt;</span><span class="z-l-3 z-d-10"> G</span><span class="z-l-13 z-d-8">[</span><span class="z-l-12 z-d-5">Agent 会话中的工具\n事件与其他扩展能力</span><span class="z-l-13 z-d-8">]</span></span></code></pre> <p>这里的“插件”指 rpi 的 Rust 原生 ABI 扩展，不是 MCP Server，也不是一个通过 HTTP 或 stdio 运行的外部进程。我们可以先把它看成宿主进程里的一段本机可信代码：它和宿主运行在同一个进程里，因此能力强、开销低，但也意味着 ABI、内存所有权和生命周期必须非常明确。</p> <p>本文讨论的是 rpi 的原生 ABI 插件机制。由于 ABI、loader 和 package 命令会随仓库版本变化，下面的文件名、符号名和命令都应与所读源码版本一起核对；代码块中明确标注为“示意”的部分，不等于可直接复制运行的最小插件。文章关注一条主线：插件如何从动态库进入注册表，再被会话驱动；不把它扩展成完整的 Rust FFI 教程。</p> Sun, 11 Oct 2026 09:03:00 +0800 bigfish https://blog.bigfisharc.cn/blog/20261011-0903-rpigong-ju-di-tu/ https://blog.bigfisharc.cn/blog/20261011-0903-rpigong-ju-di-tu/ <p>rpi 已经有一批常见的原生 Rust 插件。数量上还没有成熟生态那么多，但任务规划、代码分析、网络访问、运行观测、消息渠道和语音交互等日常场景，基本都已经有对应能力可以使用。</p> <p>如果只看包名，<code>rpi-packages</code> 很容易变成一张“功能名词表”：<code>todo</code>、<code>goal</code>、<code>lens</code>、<code>MCP</code>、<code>Langfuse</code>、<code>voice</code>……每个词都认识，真正要装哪个却不容易判断。</p> <p>这篇文章先把目前已有的扩展整体展示出来，再按使用场景说明它们分别解决什么问题。你可以把它当成一张选型地图：先从任务找到需要的能力，再决定安装哪些包，而不是把整个扩展目录全部装上。后续如果你正在使用其他原生 Rust 插件，也欢迎补充。</p>