可观测性
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 之外,该集成保持静止。