第 28 章：pi-web-ui — 浏览器里的复用

来源：《pi 的设计艺术》第 27 章：pi-web-ui — 浏览器里的复用

阅读日期：2026-09-14。书中版本基线：章首限定 v0.66.1 历史快照 c779c14e；称包于 2026-05-20 移出主仓库。 本条为原创阅读笔记，未独立核验 pi 源码。

编号说明：本条按在线目录第 28 章编号；原文标题仍为第 27 章，文件名沿用旧编号。

设计问题与机制

历史 pi-web-ui 使用 Lit 组件直接消费 Agent 事件，把聊天、模型选择、会话及附件预览组合为浏览器入口。它与 CLI 是共享底层能力的并列消费者。会话持久化使用 IndexedDB，文档预览依赖浏览器解析组件。

前端独自承担附件、存储、凭证及网络条件。浏览器中预览文档不等于随后的模型请求不会上传内容；较少的框架依赖也不等于较小的文档处理依赖。

取舍与版本边界

章首明确包已移出且无官方继任仓库；章尾仍称 v0.66.0、近期快速演进，是旧叙述。本条以章首历史限定为准。凭证“加密存储”的说法未在本章展示完整实现，本笔记不据此给出安全保证。

工程应用检查（独立推导）

博客可借鉴“事件契约共享、展示独立”，无需为复用而换成 Lit。附件预览与送入模型应是两个可观察动作；大文档库按需加载。浏览器直连前单独验证提供方跨域行为及凭证方案。草稿存储、公开发布和对话上下文也应有不同状态，避免一次预览意外变成公开或发送。