v0.17.02026-11-14
pi-web v0.17.0 更新:新增 Agents 条,主聊天区显示子 Agent 或侧聊时,工具栏下方会列出主 Agent 与同家族成员,高亮当前、转圈显示运行中,点击即可切换,主 Agent 固定在最左,右端锁可让它在主 Agent 上也常驻(按浏览器记忆)。搜索现在覆盖侧聊自增内容,点开结果会打开父会话并切到对应侧聊;单个上传文件可用满 100MB,去掉 25MB 单文件上限,大文件改为异步写入不再拖慢其他请求。
修复方面:session_start 里弹对话框的扩展不再卡死新会话;扩展唤醒的回复不再被折叠进 Process details;MCP 测试连接成功后会重新注册失败状态的会话;完成提示音多页面只响一次。安全上,Windows PowerShell 工具与技能安装的 npx 不再继承 Pi Web 自身环境变量,子 Agent 配置与 enabledModels 仅在受信任项目加载;带 BOM 或空的 auth.json、settings.json 现可正常读取。另有一批文件预览、Git diff、Markdown 流式渲染等小修。
v0.16.02026-11-12
pi-web v0.16.0 更新
这版重点在模型接入、工具控制和搜索体验。Settings › Models 新增 pi 内置的 llama.cpp 提供商,默认指向 http://127.0.0.1:8080;工具菜单可在预设下逐个勾选内置工具,不必再改 settings.json,自定义组合会以 Custom 保留到新会话。会话搜索改为按空格分词匹配,双引号内仍按完整短语;结果会标出所属项目并自动展开定位。侧栏无论通过点击、搜索、Fork 还是链接打开,都会滚动到当前会话;已读状态跨浏览器同步。
交互上,! 命令执行时实时输出,不再作为引导消息发给模型;「New session」会预填被 Fork 的消息,与 pi 的 /fork 对齐。自定义提供商可单独设置显示名,模型列表额外读取 reasoning_levels、价格和输入模态。diff 视图新增语法高亮。
修复面较广:Stop 与 TUI 行为对齐并清空队列;压缩失败会显示重试等待与错误;工具卡片补上运行耗时、diff 预览和对象参数显示;子代理、MCP、Code mode、登录、文件统计与 Windows 路径解析、导出临时目录、终端关闭、剪贴板、输入法等均有改进。内部升级 pi 至 1.5.2,发布 npm 包与镜像 ghcr.io/agegr/pi-web:0.16.0。
v0.15.02026-11-03
pi-web v0.15.0 更新:运行中也能切换模型,切换从下一个请求起生效;侧聊标签随主会话保存恢复,右侧面板标签支持拖动重排,自定义提供商的模型可拖动或按名称排序并写回 models.json;模型选择器改用提供商显示名,扩展 UI 也拿到了系统主题配色。修复方面,HTML 导出在 pi 1.5.0 后报错的问题已解决,ChatGPT OAuth 登录可正常发起,已登出提供商的残留条目会被「清理无效条目」删除,完成通知不再重复提醒,听写工具粘贴丢失与流式回复 token 数抖动也一并修掉。
v0.14.22026-11-02
v0.14.2 到来。设置 enabledModels 后,聊天框的模型选择器顶部多出「scoped | all」一行,默认只列限定范围内的模型,点按或在筛选框按 Tab 可切到全部;范围外选中的模型仅用于当前会话,不会成为默认。Agents 列表的侧流行新增删除按钮,确认后只删这一条,删掉的若是主聊天中打开的侧聊则回到其主会话。
手机端改动集中在两处:Settings 改为逐级全屏,分区、子项依次推进,标题栏带返回按钮,系统返回键逐级回退,切换有滑动动画(开启减少动态效果时禁用);顶栏、侧栏工具栏、文件面板标签栏及输入框控件行统一 44px,文件树行高 36px,窄屏下 Agents 按钮不再收进「更多」菜单。
修复了 Windows 原生服务器新建终端总开 cmd.exe 的问题——现按 pi 的 powershell 工具顺序查找,先 PowerShell 7、再 Windows PowerShell,都没有才回落 cmd;归档视图折叠全部项目后不再误显示「没有已归档的会话」。
内部升级 pi 至 1.5.0,MCP 的 oauth.clientRegistration 支持新默认值 "auto",粘贴的 pi mcp add 命令会读取 --oauth-client-registration;Next.js 升到 16.4.4,npm audit --omit=dev 已无告警。发布流程合并为单一 Release 工作流。安装:npm install -g @agegr/pi-web@latest
v0.14.12026-11-02
中文
基于 v0.13.0..v0.14.1 的提交整理。v0.14.0 标签打出后发布被取消,没有发布到 npm,也没有 GitHub Release,所以本说明包含自 0.13.0 以来的全部改动。
``bash
npm install -g @agegr/pi-web@latest
`
新增
- 侧聊(side chat):从当前会话分出一个侧聊,在右侧面板标签页里提问,带着主会话的全部上下文,主会话不受影响,运行中也能用。侧聊只保留主会话已有的只读和 shell 类工具(read、bash、grep、find、ls,Windows 上还有 powershell),不能编辑、写文件;只读的主会话分出的侧聊也没有 shell。入口有四个:/side 或 /side <问题>、选中文字后的「在侧聊询问」、运行中输入框旁的侧聊按钮、Agents 面板里的「新建侧聊」。侧聊不出现在侧栏里,在 Agents 列表中和子代理一起显示,第一条提问自动成为它的名字。(#1469,感谢 dingxiaobo;#1502)
- 选中文字「引用」:选中回答里的文字后,原来的「在这里提问」改为「引用」,只插入 > 选中的文字,不再附带提问模板,提问、纠正、指示都可以接着写;多段引用各自成段。(#1502)
- Docker 镜像:每个版本会发布 ghcr.io/agegr/pi-web 镜像(linux/amd64、linux/arm64),标签为版本号、主.次 和 latest。仓库附带 Compose 示例,用法和要保留的卷见 docs/docker.md。(#1478,感谢 Misir)
- 标签页图标显示待处理数量:图标与侧栏的会话状态一致,有会话等待输入时显示琥珀色数字(等待加未读),只有未读时显示蓝色数字,都处理完恢复原图标;页面在后台时完成的会话也会计入。(#1484,感谢 Vlad Sirenko)
- Git 改动列表可切换树状视图:文件侧栏的改动文件可以按目录树显示,折叠的目录在刷新后保持折叠;默认仍是列表视图,选择会被记住。(#1490,感谢 betago)
- Markdown 和纯文本文件默认自动换行:文件查看器打开 md、mdx、rst、adoc、txt 等文件时自动换行,代码文件和 .log 仍不换行;手动切换过的选择优先。(#1471,感谢 Brynne Taylor)
改进
- 扩展消息保留排版:扩展为终端排好的状态(方框、对齐的进度条、缩进的行)以等宽字体显示,保留换行、缩进和空格,箭头和框线字符使用系统等宽字体,与 pi 的 TUI 一致;其中的 HTML 按原文显示。(b25fa0a)
- Settings › Models 首次打开更快:共享的扩展运行时保留一小时(原来是十分钟),闲置后再打开模型设置不再等所有扩展重新加载(11 个扩展时约 13 秒)。(#1500)
- 空项目的分组可以置顶:没有会话的项目在「暂无会话」旁显示「置顶以保留」,否则切换项目后它会从侧栏消失。(#1492)
- 子代理 id 写错时给出候选:getsubagentresult 和 Agent 的 resume 找不到 id 时,会列出本会话最近的最多十个子代理 id 和描述。(#1491)
- 窄屏手机上的消息操作按钮:宽度不足时只显示图标,不再有按钮被挤出屏幕左边。(#1487,感谢 maximilize)
- 更多界面文字有了中文翻译:模型选择器的标签和提示、提供商登录过程的提示和替换 API Key 的输入提示。(#1495, #1496,感谢 zs)
修复
- HTML 预览里的脚本可以使用 localStorage / sessionStorage:沙箱 iframe 访问它们会抛 SecurityError、让脚本停止,现在注入内存版本。(#1494,感谢 zhangdxchn)
- 设置了网页密码时 PWA 可以安装:manifest 请求带上 cookie,不再因鉴权失败而无法安装。(#1477,感谢 Denis Kazimirov)
- 工具顺序与 pi CLI 一致:会话启动、重载和切换工具时保留原有工具顺序,提示词与 CLI 相同,切换后的第一轮不再让缓存失效、重新计费。(#1481,感谢 Vlad Sirenko)
- 在子代理自己的聊天里继续它的运行:服务器重启打断的子代理,在它的聊天框里继续后会正常记录结果并通知父会话,不再一直显示运行中。(#1473,感谢 Brynne Taylor)
- 斜杠命令补全:搜索时技能的排序按匹配程度,不再被技能是否休眠打乱。(#1497,感谢 zs)
- 目录选择器:在路径输入框里拖选文字、松手在外面时不再关闭选择器 (#1462,感谢 记得开心一点);进入子目录加载期间不能选中上一个目录 (#1498,感谢 zs)。
- 添加提供商时,输入法组字中按 Esc 不再关闭提供商选择框。(#1499,感谢 zs)
内部调整
- 新增 container.yml 工作流,在发布标签上构建并推送 Docker 镜像。(#1478)
- 发布 npm 包 @agegr/pi-web@0.14.1。
English
Prepared from commits in v0.13.0..v0.14.1. The v0.14.0 tag was pushed but its release was cancelled before reaching npm, and it has no GitHub Release, so these notes cover everything since 0.13.0.
`bash
npm install -g @agegr/pi-web@latest
`
Added
- Side chats: fork the current session into a side chat in a right-panel tab and ask aside with its whole context, while the main chat stays as it is, mid-run too. A side chat keeps only the parent's read and shell tools (read, bash, grep, find, ls, and powershell on Windows), never edit or write; a Read-only parent's side chat gets no shell either. Start one with /side or /side <question>, "Ask in side chat" on selected text, the side chat button beside the composer during a run, or "New side chat" in the Agents panel. Side chats stay out of the sidebar, are listed with subagents in the Agents panel, and are named after their first prompt. (#1469, thanks dingxiaobo; #1502)
- "Quote" on selected text: the selection popover's "Ask here" becomes "Quote" and inserts just > selected text, with no question template, so it serves questions, corrections and instructions alike; several quotes each start their own paragraph. (#1502)
- Docker image: each release publishes ghcr.io/agegr/pi-web (linux/amd64, linux/arm64), tagged with the version, major.minor and latest. The repo ships a Compose example; see docs/docker.md for usage and which volumes to keep. (#1478, thanks Misir)
- Favicon badge: the tab icon mirrors the sidebar rows: an amber count (awaiting plus unread) while a session waits for input, a blue unread count otherwise, and the stock icon once clear. Sessions that finish while the tab is hidden count too. (#1484, thanks Vlad Sirenko)
- Git changes as a tree: the Files sidebar's changed files can be shown as a folder tree, and collapsed folders stay collapsed across refreshes. The flat list stays the default, and the choice is remembered. (#1490, thanks betago)
- Prose files wrap by default: the file viewer wraps md, mdx, rst, adoc, txt and similar files; code and .log stay unwrapped, and a toggle you pressed wins. (#1471, thanks Brynne Taylor)
Improved
- Extension messages keep their layout: a status an extension laid out for a terminal (a box, aligned bars, indented rows) renders in monospace with its line breaks, indents and spaces kept, with arrows and box drawing from a system mono font, as in pi's TUI; HTML in it shows as text. (b25fa0a)
- Settings › Models opens faster after idle: the shared extension runtime is kept for an hour instead of ten minutes, so the first read no longer waits for every extension to load again (about 13 s with 11 extensions). (#1500)
- Pin an empty project's group: a project with no sessions shows "Pin to keep" beside "No sessions yet"; otherwise it leaves the sidebar at the next project switch. (#1492)
- A mistyped subagent id lists candidates: getsubagentresult and Agent's resume add up to ten of the session's latest subagent ids and descriptions when an id finds nothing. (#1491)
- Message actions on narrow phones show icons only when their labels do not fit, so none sits past the screen edge. (#1487, thanks maximilize)
- More UI text translated: the model selector's labels and tooltips, provider sign-in feedback and the replace-API-key hint. (#1495, #1496, thanks zs)
Fixed
- Scripts in the HTML preview can use localStorage / sessionStorage: the sandboxed iframe threw SecurityError and stopped them; an in-memory version is injected now. (#1494, thanks zhangdxchn)
- The PWA installs behind the web password: the manifest request carries cookies, so it no longer fails auth. (#1477, thanks Denis Kazimirov)
- Tool order matches the pi CLI: session start, reload and tool changes keep the carried tool order, so the prompt is the CLI's and the first turn after a switch no longer misses the cache and re-bills it. (#1481, thanks Vlad Sirenko)
- Continuing a subagent from its own chat: a subagent cut off by a server restart and continued in its chat records its result and notifies the parent instead of showing as running forever. (#1473, thanks Brynne Taylor)
- Slash command completion keeps the search ranking of skills instead of reordering them by dormancy. (#1497, thanks zs)
- Directory picker: a text drag in the path field that ends outside no longer closes it (#1462, thanks 记得开心一点); the previous folder cannot be selected while a subfolder loads (#1498, thanks zs).
- Escape during IME composition no longer closes Add provider's picker. (#1499, thanks zs)
Internal
- New container.yml workflow builds and pushes the Docker image on release tags. (#1478)
- Published npm package @agegr/pi-web@0.14.1`.
v0.13.02026-10-29
pi-web 升级到 v0.13.0,改动集中在可读性、移动端和连接管理三块。工具卡片的参数改为逐行展示,shell 命令保留真实换行;回答下方的用量行对齐 pi 的 TUI,箭头与时钟改用 SVG,Windows 上不再变形;代码块长行自动换行,不再横向滚动。新增只读 Debug 面板,可查看页面与服务器的 SSE 连接、轮询、租约倒计时,以及服务器持有的会话、子代理、MCP 和终端数量,打开它不会触发任何状态变化。svg 代码块与 Markdown 音视频现在能直接预览播放,公式可一键复制 LaTeX。模型设置支持自定义 Base URL、图片大小上限和 Claude adaptive thinking 开关。手机端 diff 改单栏,输入区多项细节重排;后台标签页会释放空闲连接,不再挤占浏览器每个源 6 个连接的上限。修复方面:发送失败的消息退回输入框、二进制文件显示下载提示、Ctrl+Alt+N 在 macOS 生效、会话目录被删时给出明确说明,另有一批模型配置与子代理状态的边角问题。
v0.12.22026-10-15
v0.12.2 更新量不小。新增八个主题,设置里按色块挑选,高对比版文字达 WCAG AAA;终端可单独切换深浅色,不影响应用主题;每轮回答会显示耗时;Agents 切换器列出各子代理的时长、token 与费用;归档支持按项目折叠与批量恢复、删除;文件可拖进文件树上传;设置里可改模型上下文窗口;源码视图新增 30 多种语言高亮。
性能与修复同样实在:长篇思考分段渲染不再卡死页面,设置页几乎瞬开,大会话侧栏只读增量;回合结束时消息不再跳动,扩展注册的默认模型与 defaultTools 里的 bash 配置与 pi CLI 对齐,慢速网络连接更稳,子代理的查结果、工作树恢复与 input_files 限制也一并修复。
```bash
npm install -g @agegr/pi-web@latest
v0.12.12026-10-13
v0.12.1 修复了新装即崩的问题:此前依赖树里只锁定了四个 pi 包,pi 1.2.0 发布后新安装会把新旧版本混装,导致启动时报 MCPTYPESCRIPTPREAMBLE 导出缺失。现在所有 pi 包(含 pi-codemode、pi-mcp、pi-telemetry)均锁定精确版本,后续发版不再波及。同时,设置 › MCP 中对提供资源的服务器点「测试」会正常显示「提供资源。」,发送消息也不再白等 10 秒。pi 升级至 1.2.0。
v0.12.02026-10-11
中文
基于 v0.11.1..v0.12.0 的提交整理。
``bash
npm install -g @agegr/pi-web@latest
`
新增
- 一键删除项目的全部会话:项目分组的 ⋯ 菜单末尾新增「删除全部会话… · N」,先确认(默认聚焦「取消」,回车不会误删),再删除该项目的所有会话(含置顶和归档的),正在运行或等待输入的会保留。(#1182)
- 在新浏览器标签页打开会话:侧边栏会话标题现在是真正的链接,中键或 Ctrl/Cmd 点击即在新标签页打开;会话菜单新增「在新标签页打开」(T)。普通点击仍在当前页切换。(#1167, #1169,感谢 xcg)
- 子代理可连接 MCP 服务器:配置文件写 mcp: on(或在 Agents 面板打开「连接 MCP 服务器」)后,子代理按普通会话相同的信任规则连接 mcp.json 中的服务器;只读工具的子代理(Explore、Plan)只运行服务器标为只读的 MCP 工具。(#1053, #1187)
- 子代理模型支持 :level 后缀:provider/model:high 同时指定模型和思考级别,与 pi 的 --model 一致;Agent 工具说明里列出每个配置文件的思考级别。(#1188, #1189)
- 终端在竖屏触屏上提供 Termux 风格的额外按键:两行 ESC / - HOME ↑ END PGUP 与 TAB CTRL ALT ← ↓ → PGDN,点按时软键盘不收起;CTRL、ALT 为单次修饰,也作用于软键盘输入的下一个字符。(#1166,感谢 vill)
- 设置 › Skills 显示技能的完整说明。(#1158,感谢 tammelin)
- 超过 256 KB 的 HTML 文件也能完整预览。(#1155,感谢 Tiger)
修复
- 完成提示音:空闲时暂停音频上下文(Android Firefox 不再在两次提示音之间持有唤醒锁),运行期间保持运行,锁屏时结束的运行也会响;超过 3 秒才恢复的提示音直接丢弃,不在回来时迟到播放。(#1157, #1178, #1185)
- 打开指向已删除会话的链接,不再显示该项目上次打开的会话,而是新建会话页并提示「该会话已不存在」。(#1168, #1180)
- Windows 命令行:status、open、update、stop 在 Node 23–24.19 / 26.6 上不再以 0xC0000409(libuv 断言)退出。(#1174, #1179)
- 扩展在回答生成或压缩期间调用 ctx.reload() 会被拒绝并给出警告(与 pi 的 TUI 一致),不再让进行中的回合失效。(#1172, #1173,感谢 solidlime)
- 终端:手机软键盘弹出时面板短暂缩到一行,输入不再永久失效。(#1160,感谢 vill)
改进
- 流式回复更轻:长回复按 Markdown 块增量解析,不再每个片段重解析全文 (#1176);每个片段只重新渲染正在生成的回复,输入框和小地图不再跟着渲染 (#1191)。
- 代码高亮按需加载:约 300 种 Prism 语言不再随首屏加载,首次出现代码块时才单独加载 (#1183);长历史里的代码块在空闲时分批上色,打开会话更快 (#1181)。
- 工具结果图片由浏览器长期缓存,不再每次重新下载。(#1181)
- 会话列表:列表接口不再携带每个会话完整的首条消息(大目录下 3.2 MB → 385 KB)(#1176);每次运行结束只重建一次列表 (#1177);子代理关系只在文件变化时重新读取 (#1181);会话视图缓存的大小只计算一次 (#1181)。
- 完成推送的标题直接取自当前会话,不再解析所有会话文件;工具结果的图片不再在事件流中重复发送。(#1176)
- 设置 › MCP 服务器详情:状态与连接合为一行,工具列在 Tools 选项下,去掉重复的 Transport / Sign-in 行,字体与字号统一。(#1190)
内部调整
- 删除只复述实现源码文本的测试(2968 → 2589 个)。(f364bc3)
- 发布文档:按名称推送发布标签,补充前置检查与 npm 同步延迟说明。(30af3b4)
- 发布 npm 包 @agegr/pi-web@0.12.0。
English
Prepared from commits in v0.11.1..v0.12.0.
`bash
npm install -g @agegr/pi-web@latest
`
Added
- Delete all of a project's sessions: a project group's ⋯ menu ends with "Delete all sessions… · N". It asks first (Cancel is focused, so Enter deletes nothing), then deletes every session of the project, pinned and archived ones included, keeping those that are running or waiting for input. (#1182)
- Open a session in a new browser tab: a sidebar session title is now a real link, so middle-click and Ctrl/Cmd-click open it in a new tab; the row menu gets "Open in new tab" (T). A plain click still switches in place. (#1167, #1169, thanks xcg)
- Sub-agents can connect MCP servers: a profile with mcp: on (or the Agents panel's "Connect MCP servers" switch) connects the servers in mcp.json under the same trust rules as a normal session. With read-only tools (Explore, Plan), only MCP tools their server marks read-only run. (#1053, #1187)
- Sub-agent models accept a :level suffix: provider/model:high sets the model and its thinking level, as pi's --model does; the Agent tool's description lists each profile's thinking level. (#1188, #1189)
- Termux-style extra keys for the terminal on portrait touch screens: two rows, ESC / - HOME ↑ END PGUP and TAB CTRL ALT ← ↓ → PGDN; tapping keeps the soft keyboard open, and CTRL and ALT are one-shot, also applying to the next character typed on the soft keyboard. (#1166, thanks vill)
- Settings › Skills shows a skill's full instructions. (#1158, thanks tammelin)
- HTML files larger than 256 KB preview in full. (#1155, thanks Tiger)
Fixed
- Completion sound: the audio context is suspended while idle (no wake lock between chimes on Firefox for Android) and held running during a run, so a run that ends while the phone is locked still chimes; a chime whose resume takes over 3 s is dropped instead of playing late. (#1157, #1178, #1185)
- A link to a session that no longer exists opens a fresh composer with "This session no longer exists" instead of the project's last open session. (#1168, #1180)
- Windows CLI: status, open, update and stop no longer exit with 0xC0000409 (a libuv assertion) on Node 23–24.19 / 26.6. (#1174, #1179)
- An extension's ctx.reload() during a streaming turn or compaction is refused with a warning, as in pi's TUI, instead of invalidating the turn in flight. (#1172, #1173, thanks solidlime)
- Terminal: input keeps working after the phone keyboard briefly shrinks the panel to one row. (#1160, thanks vill)
Improved
- Lighter streaming: a long reply's markdown is parsed block by block instead of whole on every chunk (#1176); each chunk re-renders only the streaming reply, not the composer or the minimap (#1191).
- Code highlighting on demand: Prism's ~300 languages no longer load with the first page; they load as their own chunk when the first code block appears (#1183). Fences in a long history get their colors in idle slices, so sessions open faster (#1181).
- Tool-result images are cached by the browser for good instead of re-downloaded on every view. (#1181)
- Session list: rows no longer carry each session's whole first message (3.2 MB → 385 KB on a large folder) (#1176); the list is rebuilt once per finished run (#1177); sub-agent relations are read only when their file changes (#1181); cached session views are measured once (#1181).
- The completion push takes its title from the live session instead of parsing every session file, and a tool result's image no longer crosses the event stream twice. (#1176)
- Settings › MCP server details: Status and Connection are one row, listed tools sit under the Tools choice, redundant Transport and Sign-in rows are gone, and fonts and sizes are consistent. (#1190)
Internal
- Removed tests that only restated the implementation's source text (2968 → 2589 tests). (f364bc3)
- Release docs: push the release tag by name, check prerequisites, note npm propagation. (30af3b4)
- Published npm package @agegr/pi-web@0.12.0`.
v0.11.12026-10-10
v0.11.1 更新:桌面端文件浏览器改为会话列表下方的可拖动折叠区域,带独立搜索;新建会话页重排,新增 pi-web version、update、status、stop、open 五个命令行命令;子代理工作可在右侧面板只读查看,附件可选任意文件,CSV/TSV 在文件查看器中以表格呈现,压缩摘要默认折叠。修复集中在侧边栏与聊天:运行中的文件改动会自动刷新树、新会话首条消息不再丢失、重复加载历史与各类显示错位一并解决。