前言¶

在 DeepSeek Harness（DSH）里跑智能体会话时，工具调用、审批、后台任务和 token 消耗往往交错进行。内置的 Trajectory 账本适合事后回放整条轨迹，但当你需要知道「这一会话此刻在干什么、有没有在等我点批准、这轮已经烧了多少 token」时，右侧栏缺少一块面向「现在」的视图。dsh-live 是社区维护者 123caiji 发布的客户端类插件，在 DSH 右侧栏增加「现场驾驶舱」面板，用会话投影把当前轮次、步骤、阶段和花费同步到 UI。

这是什么¶

dsh-live（GitHub：123caiji/dsh-live）的定位是：Live cockpit for DeepSeek Harness——展示本会话此刻在做什么、哪些事项需要你处理、本轮 token 成本（host 投影 + 右侧栏面板）。分类属于客户端插件；维护者为 123caiji。社区目录页见 skillhub.cn/plugins/123caiji/dsh-live，与 DeepSeek / 幻方无官方从属关系，安装前请自行查阅源码与 MIT 许可证。

面板里有什么¶

下面介绍右侧栏面板各区块（资料中的表格摘要）。

耗时每秒自刷一次；没有事件时面板不重渲染。

工作原理（简述）¶

host 半通过 DSH 的 ctx.sessionProjections 注册 key 为 live 的会话投影，对事件日志做纯同步折叠，只处理 turn/start|end、step/start、tool/call|result、approval/asked|decided、job/registered|settled、assistant/message（usage）、llm/retry、llm/retry-started 等事件；无关事件原样返回同一 state 引用，减少下游发布。

client 半依赖右侧栏席位 @deepseek-ai/dsh-client-ui-sidebar-right，用 useProjection('live') 读取投影，注册 tab（id: "dsh-live", kind: "live"）并在 Guide 中提供「现场驾驶舱」入口。运行时 host 半零第三方依赖；缺右侧栏包时 client 半不会挂载。

投影字段包括：turn、step、phase（idle|llm|tool|waiting）、当前工具、待审批列表、后台任务、本轮 tokensIn / tokensOut、错误计数与最近 5 条工具结果等。

安装与启用¶

已安装 DSH Desktop 时，用打包运行时的 CLI 装进 desktop profile。先把 $dsh 换成本机 DSH 安装路径：

$dsh = 'C:\Program Files\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'  # 换成你的安装路径
& $dsh plugin --profile desktop add dsh-live

本地开发（不改桌面 profile，家目录重定向到工作区）时：

$env:DSH_HOME = '<你的开发家目录>'
& $dsh --profile dev --from-default-profile web --dump-config
& $dsh plugin --profile dev add '<本包绝对路径>' --store-dir '<pnpm store 绝对路径>'
& $dsh --profile dev --no-open --port 3181

然后打开 CLI 打印的 http://127.0.0.1:3181/?token=...，点右侧栏的 +（Guide）→「现场驾驶舱」。

典型用法¶

日常使用路径：安装插件 → 启动 DSH Web/桌面 → 在 Guide 里打开「现场驾驶舱」→ 在同一会话里观察状态行与 Token 区块随事件更新。开发自测可在插件目录执行：

npm test          # host 折叠 / client 模块结构 / 迷你 React 渲染
npm i             # test:react 需要 react + jsdom（devDependencies）
npm run test:react   # React 19 + jsdom 挂载、1 秒自刷

适用场景与注意¶

适合需要在 DSH 里实时盯会话进度、审批队列、后台 shell 任务和本轮 token 的开发者；不适合跨会话汇总或按货币计价——DSH usage 无价格字段，插件也不提供金额。

务必知晓：插件与当前 DSH 进程同权限运行，安装前应阅读 GitHub 仓库 源码。已知限制包括：面板仅本会话维度；工具结果需与 tool/call 配对才进入「刚完成的」；后台任务仅覆盖走 job/registered / job/settled 的任务。

结尾¶

dsh-live 用轻量会话投影补上了 Trajectory 之外的「现在」视图。目录页：https://www.skillhub.cn/plugins/123caiji/dsh-live；源码与说明：https://github.com/123caiji/dsh-live。