feat(web): improve workspace continuity and startup diagnostics

README.md

@@ -462,8 +462,12 @@ Web 模型配置先填写提供商连接，再选择“获取可用模型”。
 
 Web 侧栏宽度默认 280px（220–420px），工具面板宽度默认 520px（360–720px）。拖动或键盘调整后保存到同一份配置，刷新后恢复；小窗口按当前视口临时限制显示宽度，不覆盖已保存值。也可用 `/openpi-setup` 修改 `ui.webSidebarWidth` 和 `ui.webAuxiliaryWidth`。
 
+Web 常规设置提供 Subagent、Bash 和 Write/Edit 的完整／紧凑显示控件，直接保存已有 `ui.subagentResultDisplay`、`ui.bashToolDisplay`、`ui.fileMutationDisplay`，并用于 Web 的结果与执行过程默认展开。Pi 终端页脚开关和样式保存已有 `ui.customFooter` / `ui.footerStyle`，仅影响 Pi 终端页脚。能力发现、工作流上限、下一步建议及编辑后命令的控件通过 `/openpi-setup` 修改，以实际写入回执为准。
+
 <!-- config-contract: capabilities.discovery suggestions.enabled suggestions.model workflows.concurrency workflows.maxAgentCalls childExecutions childExecutions.maxActive ui.webTheme ui.webChatWidth ui.webSidebarWidth ui.webAuxiliaryWidth ui.webChatFontSize ui.webExpandThinking ui.webPinnedSort ui.showHeader ui.customFooter ui.footerStyle ui.footerLines ui.subagentResultDisplay ui.bashToolDisplay ui.fileMutationDisplay postEdit.command subagents.roleModels -->
 
+Web 保存终端页脚偏好不会重新配置另一份已打开的 Pi 界面；该界面在下次 Session 启动或原生 setup 应用时更新页脚。
+
 ```text
 /openpi-setup 开启下一步预测，选择 Registry 里的轻量模型，minimal 推理
 /openpi-setup 让模型在合适时自主发现并采用 OpenPI 能力

SETUP.md

@@ -88,6 +88,10 @@ Capability discovery defaults to `explicit`, preserving the zero-resident OpenPI
 
 OpenPI Web appearance defaults to the `system` theme, 820px chat width, 14px chat font size, and collapsed thinking blocks. `light`, `dark`, `mist`, `rose`, and `pine` are explicit theme choices. The browser consumes every appearance value from each authoritative snapshot without writing a competing local preference.
 
+Web General settings directly save the existing `ui.subagentResultDisplay`, `ui.bashToolDisplay`, and `ui.fileMutationDisplay` choices (`compact` by default, or `full`) through the shared appearance writer. They also control the Web result disclosures and their enclosing execution groups. Footer controls save `ui.customFooter` / `ui.footerStyle` for the Pi terminal footer. Discovery, workflow limits, suggestions, and post-edit controls submit natural-language requests through the canonical `/openpi-setup` episode; only a native configuration receipt confirms a change.
+
+Direct Web footer saves update the configuration for Pi's command-line interface. A separate already-running Pi interface refreshes its footer at the next session start or native setup apply; a Web settings event does not itself reconfigure another live Pi session.
+
 On Windows, OpenPI enables Pi's `clearOnShrink` compatibility behavior for
 the regular TUI so shrinking slash-command autocomplete lists do not leave
 stale rows on screen. Fullscreen TUI keeps its configured behavior. The

THIRD_PARTY_NOTICES.md

@@ -44,6 +44,11 @@ The follow-up Git, file-preview and settings investigation also consulted
 `jmfederico/pi-web` revision `60a29acbfc710908e73b0df9857cb63b53b672d3` (MIT),
 and `apache/maka` revision `0dc1142aa90000e45627017e846b6d57d1e165e0`
 (Apache License 2.0). These are architectural references, not embedded packages.
+The General settings follow-up consulted `agegr/pi-web` revision
+`4a5081a3d9a993fa77553c62196cc0a2b48ed810` (MIT, Copyright (c) 2026 agegr)
+for inline switches, sliders, and immediate-save interactions. OpenPI keeps
+its existing canonical configuration fields and setup episode.
+
 The screencast sizing approach was informed by Chromium DevTools'
 [`ScreencastView.ts`](https://github.com/ChromeDevTools/devtools-frontend/blob/main/front_end/panels/screencast/ScreencastView.ts)
 (BSD-3-Clause). OpenPI retains its own bounded transport and Session authority.

docs/research/README.md

@@ -8,6 +8,8 @@ Research records preserve sourced investigation and distinguish observations, in
 
 ## Draft investigations
 
+- [`WEB_CONTINUOUS_USE_2026-10-02.md`](WEB_CONTINUOUS_USE_2026-10-02.md) — 旧消息原生重跑、刷新阅读恢复、文件整理、多终端与可操作常规设置的所有者、验证和平台边界（[#641](https://github.com/openpi-dev/openpi/issues/641)，后续于 [#639](https://github.com/openpi-dev/openpi/issues/639) 与已合并 [PR #640](https://github.com/openpi-dev/openpi/pull/640)）。
+
 - [`WEB_INTERACTION_COMPARISON_2026-09-30.md`](WEB_INTERACTION_COMPARISON_2026-09-30.md) — PR #598 竞品截图对照与后续 Web 迭代：基础交互、普通附件、原始子代理结果、第三栏、真实 Luna 文件读取；追加现场演示、工具菜单焦点、Codex / Maka 历史分页与导航、两小时阅读连续性、发布整合及浏览器输入/滚动边界/Windows 定位，保留独立冻结、失败、消融和未验证边界（[#639](https://github.com/openpi-dev/openpi/issues/639)、[PR #640](https://github.com/openpi-dev/openpi/pull/640)、[#597](https://github.com/openpi-dev/openpi/issues/597)、[PR #598](https://github.com/openpi-dev/openpi/pull/598)）。
 
 ## Validated investigations

docs/research/WEB_CONTINUOUS_USE_2026-10-02.md

@@ -0,0 +1,86 @@
+# OpenPI Web 连续使用：重跑、刷新、文件与多终端
+
+- Status: draft
+- Created: 2026-10-02
+- Issue: [#641](https://github.com/openpi-dev/openpi/issues/641)，后续于 [#639](https://github.com/openpi-dev/openpi/issues/639)
+- Base: `c230909`，已合并 [#640](https://github.com/openpi-dev/openpi/pull/640) 与 Pi 0.99.1 兼容更新 [#636](https://github.com/openpi-dev/openpi/pull/636)
+- Scope: OpenPI Web 的连续使用；不是新原生 App、跨产品性能 Benchmark 或已接受的项目 Decision。
+- Related record: [之前的交互比较与失败记录](WEB_INTERACTION_COMPARISON_2026-09-30.md)
+
+## 参考与实现边界
+
+用户指定以 Codex 的使用方式为主要参考。官方 [Remote engineering guidance](https://developers.openai.com/blog/mastering-codex-remote-for-engineering) 支持历史分叉与编辑请求的产品流程；不据此宣称本机 Codex 的每项细节或像素布局已实测。Pi Web 的 `components/SettingsPanel.tsx`，冻结于 `4a5081a3d9a993fa77553c62196cc0a2b48ed810`，提供 General 页的即时保存开关、滑条和重置交互；OpenPI 包独有的 Subagent/Bash/Write/Edit 与终端 Footer 配置沿用自己的已有规范，不伪称 Pi Web 同名功能。
+
+| 行为 | 所有者与边界 |
+| --- | --- |
+| 修改旧请求并重跑、重新生成 | Pi 原生 `AgentSession.fork` 选择请求之前的分支；模型调用仍由既有 Web prompt admission ledger 接收。源 Session 文件不改写；完整原生内容和图片进入新请求，拒绝时可恢复输入。 |
+| 刷新后的阅读位置 | 浏览器保存精确 Session id/path、原生 entry 和偏移；历史窗口重新向 Pi 查询。工具只保存有界视图元数据，文件版本与终端进程均由其 owner 重新校验；不把资源 ID 当作运行事实。 |
+| 文件整理 | 既有 trusted workspace、精确 Session、Pi 单文件写队列和 filesystem identity。移动不覆盖；回收站为工作区内私有、ignored、可恢复的文件操作证据，不是另一份 Session 存储。目录导入沿用已有导入验证。 |
+| 多终端与完整 launcher | 同一 Session 可有独立 PTY、命名、输入/输出和关闭。创建 key 只保证每个页签幂等，不推断旧进程仍活着；刷新后查询 owner，Session 切换仍遵守已有清理边界。 |
+| 常规设置可操作 | 结果显示与 Pi 终端 Footer 直接保存已有 presentation fields；能力发现、工作流上限、建议与 post-edit 通过 `/openpi-setup`。界面不把模型声称成功替代实际写入回执。 |
+| 会话行操作显示 | hover、focus 与已打开的菜单显示操作；普通行保持紧凑，触屏保留当前选中行入口，关闭再打开侧栏仍可操作。 |
+
+## 验证与限制
+
+实现先在旧 Pi 0.85.1 基线完成专项，再安全提交并迁移至上述最新 main / Pi 0.99.1。旧专项是 checkpoint，不代替新基线完整验收。真实 Host、native fixture、store/component 与浏览器模拟 admission 分别记录，不混淆真实模型结果和合成测试。
+
+私有原始证据稳定身份为 `openpi-web-audit-598-2026-09-30/continuous-use-20261002`，由操作者保留；公开回归位于 `tests/web/`。原始 Session、凭据、竞品源码与截图不发布到仓库。该归档身份不构成公开可获取的独立证据。
+
+前轮第六浏览器页签的输入边界已定位并用原始扩展重复验证；Chromium 内部原因仍未知。本轮不以完整 Chromium 套件的绿色结果扩张为 Safari、真实移动软键盘或跨浏览器兼容保证。
+
+首次整套本地门禁冻结于 `656df98c50b9d9896ebe4789bafacb876141b907`，隔离 `pi list` 唯一 OpenPI source 与该 checkout 匹配。Node 24.19.0 / Bun 1.3.14 / Pi 0.99.1 下，945 个 tracked inputs 在完整门禁前后 hash 一致：
+
+| 层级 | 结果与证据 |
+| --- | --- |
+| `bun run check` | 完整通过：config/docs/discipline contract、Web production build、format/lint、Web 与仓库 TypeScript；`full-check-04.log`。现有大 chunk 提示仍为构建 advisory。 |
+| `bun run test` / Node | 2136 passed，8 平台条件 skips，0 failed；`full-test-03.log`。 |
+| `bun run test` / Vitest | 82 files / 1154 passed，0 failed；同一日志。 |
+| Production Chrome | 104/104 passed，0 failed；`full-browser-02.log` 和独立 `full-browser-02-results`。包含真实 Host 文件/PTY、native history/fork 及明确分开的 mock admission 场景。 |
+| 真实模型 smoke | 下述原生 runtime checkpoint 的两次短 turn 完成；私有 `native-rerun-reading/real-provider/receipt.json`。后续 Windows 引用识别修正另由 native tests 与 CI 核验，未追加模型调用。 |
+
+首次结果补记 `5316a9a` 仅修改文档，另跑 docs contract 与 diff whitespace 检查；不把补记后的 commit 伪称为之前已运行的模型 smoke revision。远端 CI 与发布链接见 [PR #643](https://github.com/openpi-dev/openpi/pull/643)。
+
+### 远端发现与修正
+
+首轮远端 Node 22/24 完整通过；Node 26、Windows 和 Linux Chrome 揭示本地平台没有暴露的三处边界。保存首轮 CI run `36897127803` 与各 job 原始失败日志，不用本地绿色替代远端结果：
+
+- Node 26.10.0 内置 Web Storage 在未启用时为 undefined；Vitest 4 同时把 `window` / `document.defaultView` 映射到 Node global。三份 DOM tests 直接使用 global localStorage，因此 15 项失败。最小修正使用 Vitest 已有 `jsdom.window.localStorage` 绑定 fixture，保留正常、禁用、配额和内容排除断言；只换 window 或 defaultView 的消融仍失败。Node 26 专项 15/15 通过，不添加第二个 DOM/store。
+- Windows 原生重跑实测丢失自己 formatter 生成的 `C:%5C...` 链接，也绕过了保留引用后的请求长度限制。`isLocalArtifactLink` 仅增加 `%5c` 驱动器绝对路径例外；引用字符串不重写，Host 仍负责实际解码与访问边界。来源/native fork 专项 17/17 通过。整份 href 解码的中间设计被消融删除，避免改变 `%23notes.md` 等合法文件的分类。
+- Linux Chrome 103/104 通过；文件 case 在 reload 后立即检查 isVisible，误走重复打开工具的分支。测试改为真实 reload 后等待文件工具恢复并检查精确 Session 的保存状态；不合成 pagehide、不重试点击、不修改产品来迎合测试，专项 1/1 通过。
+
+这些修正冻结于 `509d88d` 后，Node 26 本地完整 `check` 通过，原生测试 2137 passed / 8 skips、Vitest 1154 passed、production Chrome 104/104 passed，945 个 tracked inputs 前后 hash 一致。第二轮 CI run `36900258025` 的 Node 22/24/26 与 Windows 均通过；Linux Chrome 103/104 通过，另暴露已有 pane 键盘重置与保存回执交叠的问题。
+
+该失败的 trace 确认 Enter 发送给正确的 sidebar separator，未发生焦点误投；296px 的保存回执与 Enter 重置交叠，随后再次提交了 296px。具体 React commit / passive effect 的微任务顺序仍未直接观测，不据此伪称确定完整内部原因。新增确定性回归模拟 ArrowRight 保存 296px、Enter 保存 280px，随后到达旧宽度 snapshot；旧实现再次显示 296px，说明保存后重新放开 hydration 会覆盖操作者选择。移除重复 ref 和 save-ack→hydrate 支路后，该页由最后一次用户调整持有宽度，刷新仍读 native settings；不需要新队列、重试或延迟。该回归与既有宽度/刷新专项 9/9 通过，原浏览器键盘、指针、折叠阈值断言保持不变。跨客户端改变 pane 宽度在本页已有调整后需刷新才生效；主题与字号的即时更新不受影响。
+
+进一步冻结对照分别使用 `509d88d` 与 `e5411db` 的 App 源字节，只替换私有 probe 的 import。让已注册的保存回调更新 296px snapshot 并发送一次真实 Enter，再执行原 ack：旧版显示 296px、新版显示并保存 280px。两次均验证 Enter 恰好送达一次；未插入 getter 或改写 handler，确认 ack 顺序能丢失新输入，但不代替原 CI 未记录的内部调度证据。
+
+`e5411db` 的完整 Node 26 check/test 通过（2137 原生、1155 UI、8 skips），Chrome 重跑 102/104 通过，原侧栏 Enter 案例已恢复；新失败另保留为 `full-browser-04-pane`：
+
+- 新工具页签的延迟 focus 只有关闭路径才尊重外部焦点，打开路径会抢走 separator 的 End 输入。原 End 断言未更改；新增确定性 rAF 回归在旧版将外部按钮焦点转移到 Files tab，删除 closing 条件与冗余标记后 18/18 菜单专项通过，正常选工具、关闭工具、Review 初始阅读和 Escape 聚焦仍覆盖。
+- 阅读刷新 fixture 的固定书签在 wheel 生效前便满足原匹配断言；trace 中书签读取后，原生 scrollTop 才从 2399 变为 2039，随后 pagehide 正确保存新锚点。测试先等待实际 -360px 滚动完成，再冻结书签，保留全部 entry/path/offset、失败重试和人工滚动取消断言；产品不改。
+
+这两项真实 Chrome 专项 2/2 通过，最新完整门禁与远端结果继续记录于 [PR #643](https://github.com/openpi-dev/openpi/pull/643)，不抹去此前失败。
+
+### 消融与失败证据
+
+- 删除终端创建的第二份 key→id 映射和重复查找后，原生有界 records 与 pending receipt 仍通过幂等、容量和取消回归，因此保留更小的实现。
+- 删除文件移动的嵌套目标写队列；源对象的 Pi 原生队列与独占目标提交足以覆盖普通重名冲突，且避免 canonical alias 共用队列的死锁。目录独占 reservation 的独立消融允许竞争方抢占目标，回归失败，因此恢复该机制。
+- 移除历史窗口的有限后续上下文，刷新原生 anchor 在末端被夹限，实测偏移 425.75px；恢复同一有界 native message-window 后，案例偏移不超过 2px。未增加伪占位高度或第二份历史存储。
+- 移除 full 结果的外层 execution group 自动展开后，Bash/file 的完整结果验收失败，因此保留让既有显示配置实际可见的行为。
+- 触屏完全隐藏行操作时，关闭再打开侧栏会失去入口；最小修正仅保留当前选中行。菜单截图等待真实 opacity 并禁用截图动画，不用重试点击替代交互验收。
+- 移除 pane 保存后的确认 ref 与重新 hydration，仍满足初次设置读取、视口夹限不保存、键盘/拖动保存和刷新恢复；旧 snapshot 覆盖新选择的确定性回归由失败变为通过，因此保留删除后的更小实现。
+- 工具页签聚焦复用已有外部焦点守卫，移除仅区分关闭的条件和标记后，18 项既有与新增焦点验收通过，无需新的焦点调度器。
+
+真实 `audit-local/gpt-6-luna` 隔离 smoke 于 `fd5d597d447500c1af479374b6d65df16d9cf15c` 完成编辑与重新生成两次短 turn，同模型、原生 completed、排除旧未来回答，原 Session 与被重新生成的版本字节均不变，普通 read/bash/edit/write 工具保持开启。首次 preflight 因私有模型环境未继承而停在模型调用之前；仅复用已授权审计 profile 所需变量后成功，没有再试其他模型。凭据及 Session 原始文件不公开。
+
+首次全量 Node 测试揭示旧 asset 断言禁止所有 localStorage，与新增有界视图书签冲突；保留禁止浏览器 archive 状态的断言，明确允许两种已验证 metadata key。其后 Node 全绿，Vitest 和首轮完整 Chrome 揭示旧编辑入口断言及 fixture 状态隔离问题；更新至原生分叉交互仍保留完整文本、附件、源分支不变、尺寸、阅读位置和取消验收，未修改产品来迎合旧测试。失败日志与修正后的结果分别保存。
+
+## 本轮之后的基础功能缺口
+
+以下是当前源码检查支持的后续候选，不是本轮新增回归或已接受的功能 Decision：
+
+1. 聊天正文的完整阅读：`web/ui/src/components/Markdown.tsx` 尚未接入数学排版，Mermaid fenced block 仍为代码，普通代码块缺少语言标题和语法高亮。代码复制和横向滚动已经存在；文件预览已有 Mermaid/高亮，可作为复用入口。
+2. 会话导出与批量整理：`SessionSidebar.tsx` 提供重命名、归档/恢复、置顶和排序，但没有导出或多选归档的 Web 入口。后续应复用 Pi 原生导出完整分支，不能只导出当前页面已加载的历史窗口。
+3. 后台系统提醒：页面内已有未读、失败、待输入投影，但未接入浏览器系统通知及主动启用入口。后续仍应消费原生终态与待输入事实，不从文字推断完成。
+
+Safari、实体手机软键盘和 Windows 原生操作属于验证不确定项，不能据此写成这些平台的功能缺失。上述三项不阻止按当前 Chrome/macOS 验证范围发布连续使用修复。