把 Vibecoding 随身携带：升级新的 rpi 的 web 扩展作区

bigfish — Sat, 24 Oct 2026 10:55:00 +0800

你可能已经有一个能工作的 rpi 项目：代码在自己的电脑上，模型凭据也不想交给第三方平台，但每次启动 Agent 都要守着终端。rpi-web 解决的不是“再造一个聊天框”，而是把这个本地工作区搬到浏览器里。

浏览器负责看见会话、文件、工具卡片和 Git diff；真正读写项目、调用模型、保存 transcript 的进程，仍然运行在你的电脑或服务器上。这个边界很重要：它既是 rpi-web 的吸引力，也是你部署远程访问时必须理解的安全边界。

下面这张图先把整条链路摆出来。看懂它，再执行安装命令，你就不会把“浏览器密码”“模型 API key”“项目目录”和“会话历史”混成一件事。

图 1：rpi-web 的关键边界。桌面端直接阅读，手机端可横向拖动查看细节，也可以点击图片打开支持缩放和拖动的交互版；图中关系依据 rpi-web 项目 README 和源码整理，不代表性能测试。

先理解三个原则：为什么它不只是一个网页壳

rpi-web 的前端会显示流式对话、工具调用、文件预览和 Git 变更，但项目 README 描述的运行链是 browser → Web server → rpi --mode rpc。浏览器断开时，服务端的会话和项目文件并不会因此变成浏览器本地数据。

Web 服务负责把浏览器请求接到会话运行时。每个打开的会话都有独立的 native host，因此“新建会话”不是换一个网页标签，而是建立一条独立的 Agent 上下文。工具真正执行在哪里？在运行 Web 服务的那台机器上。

项目源文件、会话 transcript、registry 索引和 projects.json 不是同一个文件。registry 负责会话的标题、置顶和归档等组织信息；native host 保存真正的 transcript；源码仍在项目目录。重启后要恢复历史，不能只备份一个索引文件。

因此，rpi-web 最适合三类人：想在浏览器里操作本地 Agent 的个人开发者；把项目放在家用服务器或开发机上的用户；需要查看文件和 Git 变更、又不想把执行权交给 SaaS 的团队。它不是多租户在线 IDE，也不是完整的浏览器自动化工具。

这篇文章按项目当前的 rpi-web 0.1.7 资料来写，主线是从安装到完成第一次会话。先不讨论性能，也不把 rpi-web 写成一个完整的 Web IDE：它目前最重要的价值，是让你用浏览器操作 rpi 的项目、会话、工具和 Git 变更。