7-66 [process] Page AI opencode-native UI v1

状态补充（2026-07-03）：本稿冻结为 native UI fallback / debug receipt 参考；Page AI 产品主线为 OpenHub / native agent + LightRAG + Turso/libSQL。不得继续扩写 MNote 自研聊天框作为默认 Page AI UI。此前指向 7-68-openhub-weknora-mnote-deep-fusion-v1.md 的 WeKnora 默认 provider 口径已标记 stale。

创建时间：2026-06-24

当前状态：FROZEN / native UI fallback，仅保留为 debug receipt 与失败方向参考

Owner：07-ai / Page AI / opencode-native UI

1. 结论

本稿提出的 MNote-native opencode UI 方向已冻结为 fallback。当前主线不是在 MNote 内复刻 opencode 消息流、tool UI、permission UI，也不是回到官方 opencode WebUI iframe 默认路径，而是 MNote 薄宿主壳 + OpenHub AI 面板 + OpenHub FastAPI/Redis/opencode client + LightRAG。

因此 7-66 只作为反例和 fallback 保留：native message timeline / composer / permission cards 可以临时作为 debug receipt、故障诊断或 OpenHub 不可用时的降级参考，但不得成为 Page AI 主 UI，也不继续扩写自研聊天框。

主线 Page AI      = MNote host chrome + OpenHub AI 面板 + OpenHub FastAPI/Redis/opencode client + LightRAG
native fallback  = MNote debug receipt + opencode session/event/diff 摘要
iframe fallback  = 7-65 官方 opencode WebUI iframe

2. 参考结论

2.1 opencode 官方 VSCode 插件

官方 VSCode 插件 sst-dev.opencode 的公开说明更偏 IDE 集成而不是完整 WebUI 复刻：

快捷键启动/聚焦 opencode terminal session。
新建 opencode terminal session。
自动共享当前 selection/tab。
支持 @File#L37-42 文件引用。

这说明官方 IDE 路线不是“把 WebUI 完整 iframe 到 IDE”，而是让宿主 IDE 负责上下文、入口和文件引用，opencode runtime 负责 agent。

2.2 社区 VSCode WebUI 插件

社区方案集中在两类：

sidebar chat + diff viewer + multi-session tabs；自动启动 opencode serve，通过 HTTP/SSE 通信。
React webview 渲染 session、message parts、tool cards、permission、diff、provider/model。

对 MNote 的历史启发：直接重渲染 opencode API/SSE 会把 MNote 拉回自研聊天框路线。7-68 已覆盖该判断：优先嵌入 OpenHub AI 面板并保留 OpenHub 后端栈，native UI 只做 fallback / debug receipt。

3. 必须覆盖的 opencode 功能

Phase A：可用会话壳

session list / create / resume / current binding。
当前 session 状态：agent、model/provider、token/cost、idle/running/error。
composer：发送 prompt、排队/运行状态、abort。
context bar：当前页、真实 Markdown 路径、selection、allowed roots。

Phase B：消息与 parts

user / assistant / system / synthetic 区分展示。
隐藏 MNote context envelope 噪声，但保留“上下文已注入”状态。
text part 正文渲染。
reasoning part 折叠展示。
tool part 卡片：tool 名、状态、输入/输出摘要。
patch part / file part / shell part / agent/subtask part 以卡片展示。
message error、finish、tokens/cost 展示。

Phase C：权限、问题、diff

permission.asked 列表：allow once / always / reject。
question request：文本输入回复 / reject。
changed files chips：点击用 MNote 打开。
diff summary：新增/修改/删除数量；当前页命中后刷新编辑器。
abort / revert / unrevert 留出按钮，但 MVP 可先只接 abort。

Phase D：事件驱动刷新

订阅 /api/page-ai/opencode/events。
处理 message.updated、message.part.updated、message.part.delta、session.next.*、permission.v2.asked/replied、session.diff、session.error。
不高频轮询；事件只触发有界 refresh：messages / permissions / diff。

4. MNote 特有集成

changed file click：window.__mnoteDocumentPaneRuntime.openResourceInActiveTab()。
当前页被修改：refreshPrimaryDocument({ reason: 'page-ai-opencode-event' })。
selection/current page/allowed roots 由现有 Page AI target runtime 计算。
native UI 只保留 debug fallback；默认 UI 使用 7-68 的 OpenHub AI 面板嵌入路线。

5. 第一版验收

打开 Page AI 看到 MNote-native opencode 面板，不出现 iframe 空壳。
能创建/恢复 session。
能发送真实消息，看到 user message 和 assistant/text/tool/reasoning/patch 卡片之一。
能看到 session list、model/provider、changed files、permission 区域。
如 opencode/provider 出错，UI 显示真实错误，不伪装成功。
浏览器截图自检通过后再汇报。

4.7 KiB Raw Blame History Unescape Escape