可观测性

omdsh 展示的一切都读自 Harness 的 projection 和持久会话日志;下面的视图只是这些数据的呈现,而不是 TUI 自造的计数器。

会话账本:/trajectory

/trajectory 为活动会话打开键盘驱动的事件账本。事件按 Turn 与 Step 分组,回合运行期间账本会跟随实时尾端。在账本中可以:

  • 用 / 搜索整个账本,再用 n/N 或 Ctrl+N/Ctrl+P 在匹配间跳转;Enter 会定位到匹配处,并展开藏着它的折叠回合或工具调用;
  • 用 t 折叠或展开回合,用 c 折叠或展开工具调用;
  • 用 Enter 打开记录详情,包括工具载荷、结果、schema、耗时与 Token 用量;
  • 用 Tab 与方向键在详情分区之间切换。

匹配会扫描整个账本,因此折叠的回合和隐藏的子工具调用同样会被计入。/trajectory 需要交互式终端。

上下文:/context 与状态栏

/context 会在转录中打印基于 projection 的上下文用量分解。它读取与状态栏相同的、客户端可见的 Harness projection,并区分 provider 记账的占用与启发式的提示组成。状态栏的 Ctx 组以百分比加已用/窗口 Token 数显示压力,压力升高时会转为警告色与错误色。可配置的状态项见调整工作环境。

会话详情:/session

/session 在转录中报告活动会话的详细信息,包括其身份与当前配置。需要精确的会话 id 用于 omdsh --resume 时可以查看它。

工作区差异:/diff

/diff 以按文件表格汇总工作区改动,列出新增与删除行数,并列出未跟踪文件;/diff <path> 打印单个文件的 patch。它只读 git 状态,不会暂存或提交。

每轮改动的文件

每个完成的回合结束时会附一条记录,列出该回合改动的文件、该回合的增删总行数,以及每个路径各自的新增与删除行数。改动归属于产生它的那一回合,因此长会话里能看出哪次改动来自哪次请求,而不是只有一个累计总数。文件列表超过八个会折叠,Ctrl+O 展开;没有改动的回合会明确说明,binary 或超大的文件只做标记而不给行数。由于这条记录来自该回合自己的快照,之后再打开的会话会显示该回合,但没有它的文件列表。

/diff 与这条记录回答的是不同问题:/diff 报告当前工作区的状态,而每轮记录报告某一个回合改了什么。

工具与集成:/tools 与 /mcp

/tools 按注册表暴露的方式分组列出 agent 可见的工具。/mcp 按 MCP 服务器分组显示已连接的工具;MCP 重连后工具列表变化时,两个视图都会自动更新。超过上下文预算的工具结果会溢写到私有文件,转录中只保留有界预览;原始内容仍可用 read 或 grep 读取。

Herdr 面板集成

在 Herdr 面板中运行时,omdsh 会注册为一个一等 agent:侧边栏跟随它的 working、idle 与 blocked 状态(blocked 时会指出待处理的审批或问题),可恢复的会话 id 会被上报,omdsh 退出时面板会被释放。在 Herdr 之外,该集成保持静止。

相关

  • 命令 —— /trajectory、/context、/session、/diff 及其余命令目录
  • 键盘与快捷键 —— 账本与浮层按键
  • 性能 —— 长会话下转录与账本保持快速的方式