突然不显示了

[zhanglf1982]

[wenliang-xiao]

复现环境

• OS: macOS
• opencode: 1.18.10
• opencode-cache-hit: 0.6.3（通过 Ctrl+P → install plugin 安装）
• 配置: ~/.config/opencode/tui.json 中 "opencode-cache-hit@latest"

症状

每次启动 opencode 之后，侧边栏 cache-hit 面板是空白的，不显示任何数据。

必须手动操作：

1. Ctrl+P → 搜索 opencode-cache-hit 插件
2. 先点 Disable，再点 Enable
3. 面板就正常显示了，数据也完全正确

下次重新启动 opencode，问题重现，又需要手动 toggle。

根因分析

排查后发现是初始化时机问题：

1. src/widget.tsx 中的门控逻辑：

   <Show when={props.sessionId().length > 0}>
     <TuiPanel ... />
   </Show>

   整个面板被 sessionId().length > 0 门控。

2. 启动时序：opencode 启动时先注册所有 TUI 插件的 slot，再创建/恢复 session。所以 sidebar_content slot 首次渲染时 props.session_id 为空，面板直接不渲染。toggle 重新挂载时 session 已存在，session_id 正常传入，面板就显示了。

3. timeline 数据正常产出的佐证：即使面板空白，~/.local/share/opencode/logs/cache-hit/timeline-*.jsonl 每天都有数据写入，说明插件核心逻辑在运行，只是 UI 层渲染时机不对。

相关 issue

• opencode 上游 #33884：TUI plugin slots 在启动时静默加载失败是已知问题
• opencode 上游 #34050：sidebar_content slot 首次渲染不可靠

建议

是否可以在 sidebar-host.tsx 中监听 session 创建事件，当检测到 session 就绪后触发重新加载？或者在门控逻辑改为 Show + Suspense 模式，等待 sessionId 变为非空后自动渲染。

[zhumengzhu]

感谢反馈和 wenliang-xiao 的详细分析。这个问题的根因已经定位并修复，0.6.4 版本已包含（PR #7）。

根因（与 issue #5 同源，不是简单的时序门控问题）：

1. npm 安装的插件位于 node_modules 下，而 opencode/opentui 的 Solid 编译插件（@opentui/solid 0.4.x）的 transform filter 硬编码排除了 node_modules 路径（上游跟踪：opencode#39986）
2. 因此插件的 raw TSX 被 Bun 用通用 JSX（jsxDEV）编译——<Show> 的 children 会在 when 判断之前被急切求值
3. 启动 opencode 时 session 数据还在异步同步，hasTrend 为 false → trend 为 undefined → children 里 props.trend!.color 直接抛 TypeError → per-slot ErrorBoundary 静默卸载面板 → 你看到的"空白"
4. 手动 Disable/Enable 后 session 数据已就绪，hasTrend 为 true，不再崩溃，所以面板恢复正常

关于评论里的两个建议：

• "监听 session 创建事件 / Suspense 等数据就绪再渲染"——只能缓解，不能根治：即使等数据就绪，恢复的 session 若只有 0-1 条有 token 的 assistant 轮次，hasTrend 仍为 false，照样崩
• 真正的修复是让代码在 eager 求值下也不抛错（可选链 ?.），这正是本次改动

修复内容（0.6.4）：

• TuiHitRow：props.trend!.color → props.trend?.color
• 同类加固：cache-ttl-view 的 elapsed()!、main-session-view 的 messages! → 可选 props + 运行时防护
• 新增回归测试：tests/eager-render.test.ts（在 eager 加载路径下渲染，已验证回退到 ! 会失败）+ tests/eager-safe-jsx.test.ts（静态扫描防新增）

另外提醒：如果安装的是 @latest，opencode 会把版本钉死在首次解析的版本（opencode#6774），0.6.4 发布后需要清缓存重装（rm -rf ~/.cache/opencode/packages/opencode-cache-hit@latest）才能拿到修复。感谢反馈！