dsh-agent-blackbox：在 DeepSeek Harness 侧栏里观测 agent 会话

它是做什么的？

黑匣子（agent-blackbox）是 DeepSeek Harness（DSH）的会话观测插件，把 agent-blackbox 的仪表盘直接装进 DSH 侧栏，点一下就能在应用内查看实时会话、时间轴回放与跨会话成本总览。它解决的是排查 agent 行为时要在终端和浏览器之间来回切换、还要额外起进程开端口的麻烦。插件把核心 HTTP 路由挂到 DSH 自己的 webServer 的 /blackbox 前缀下，与 DSH 同源，不额外起进程、不额外开端口。所有数据都在本机，插件只读本地会话文件，无网络请求、无遥测。

核心功能

• 实时监视：正在写入的会话自动增量刷新，LIVE 指示灯与事件、时钟随会话推进。
• 时间轴回放：支持缩放与框选、工具瀑布、事件检查器，事件与工具随播放逐步揭示。
• 归因分析：按 agent 展示工具调用、token 与成本，并呈现阻塞关系。
• 跨会话总览：按 runtime 或项目分组给出成本排行，点一行即切到对应会话。
• 同源嵌入：侧栏面板以嵌入模式打开，隐藏自身顶栏，也可在新窗口打开用于双屏场景。
• 内置构建产物：发布包自带编译后的核心与前端，无需另外安装 agent-blackbox，也不用本地构建。

怎么使用这个插件？

在 DSH 中启用并重启后，左侧栏会出现「黑匣子」▣ 入口，点开即用，面板默认打开最近活动的会话。总览页点击某一行会切换到对应会话；需要双屏或多显示器时，用面板内的「新窗口打开」。回放页可缩放、框选时间轴并逐步播放，配合工具瀑布和事件检查器定位问题。成本估算依赖本地价格表，未知模型不计入合计；超过 24 MB 的会话只加载尾部 8 MB 窗口，早期工具不会出现在回放里。升级插件后需重启 DSH，只改前端时刷新面板即可。该插件由 JasperPengC 维护，采用 MIT 协议。

报错怎么排查？

侧栏没有出现「黑匣子」入口时，通常是宿主代码未重新加载，重启 DSH 后即可恢复。升级插件后功能异常，同样先重启 DSH，因为宿主代码在启动时加载。面板内容不更新而只涉及前端改动时，刷新面板即可，无需重启。会话回放缺少早期工具，属于大会话只加载尾部窗口的已知限制，按官方说明处理即可。