bug: K and J don’t work when traversing Observations

在 Langfuse Cloud(Tracing 功能)中,用户进入 Tracing 页面,点击 Observations 子标签页,过滤观察项(例如只显示 Spans),用鼠标点击某条 Observation 正常加载,但使用键盘快捷键 J(下一个)或 K(上一个)导航时,观察详情未加载。

bug: K and J don't work when traversing Observations

bug: K and J don’t work when traversing Observations

快速结论:该问题出现在 Langfuse Cloud 的 Tracing 页面下,当用户在 Observations 子标签页中使用键盘快捷键 K 和 J 进行导航时,观察详情没有加载。优先检查键盘事件是否成功触发了与鼠标点击相同的详情加载逻辑。

问题场景

在 Langfuse Cloud(Tracing 功能)中,用户进入 Tracing 页面,点击 Observations 子标签页,过滤观察项(例如只显示 Spans),用鼠标点击某条 Observation 正常加载,但使用键盘快捷键 J(下一个)或 K(上一个)导航时,观察详情未加载。

报错原文

When viewing Observations under the Tracing tab, using K and J as shortcuts to navigate different observations doesn't work. The observation doesn't load.
Using my mouse to click on them manually makes the observation load.

原因分析

Langfuse 官方文档中,K 和 J 键盘快捷键是为 Traces Table Peek View(Trace 表格预览视图)下的导航设计的,并未明确声明支持 Observations 子标签页的导航。代码分析表明,键盘导航通过可重用的钩子(hooks)处理,可能原因是在 Observations 视图中,K/J 键仅更新了选中状态,但未正确触发加载观察详情的请求,导致详情不会加载。这与鼠标点击(会触发完整加载逻辑)的行为不同。

环境排查

  • 确认使用的是 Langfuse Cloud(自托管版本是否受影响未经确认)。
  • 确认在 Traces 页面的主表视图(非 Observations 子标签)中 K/J 是否正常工作,以排除快捷键本身失效的问题。
  • 确认浏览器是否拦截或修改了键盘事件(例如浏览器扩展或快捷键冲突)。

解决步骤

  1. 目前无官方补丁或 workaround。Issue 报告于 2026-06-19 关闭,但未提供代码修复;可优先尝试:在 Observations 子标签页中,先使用鼠标点击任一 Observation 确保详情加载,然后按 J/K 键尝试导航——虽然目前确认此法无效。
  2. 如需键盘导航功能,建议使用鼠标手动点击 Observations 列表中的条目作为替代。
  3. 如果该功能对工作流至关重要,可关注 Langfuse 后续版本是否更新,或自行提交代码补丁,确保键盘事件在 Observations 上下文中触发与鼠标点击相同的详情加载逻辑。

验证方法

进入 Tracing → Observations 子标签页 → 用鼠标点选一条 Observation(确认加载)→ 按 J 键期望跳转到下一条 Observation 并加载详情。如果详情仍不加载,则问题依旧。

参考来源

langfuse/langfuse #8568

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

celebrityanime
celebrityanime
文章: 8972

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注