零轮询零Token:dsh-worktable控制室如何实时监控所有项目的状态

原创2026-10-27 14:28:46210 阅读
文章标签:dsh-plugin前端开发工具AI 应用UI组件

零轮询零Token:dsh-worktable控制室如何实时监控所有项目的状态

如果你同时在跑多个 agent 项目,dsh-worktable 的控制室(Console)可以实时监控所有项目的状态——而且是零轮询、零 Token:它直接订阅宿主 DeepSeek Harness 的会话快照,模型全程不参与状态显示。这篇文章带你拆解这套机制的原理,以及三步打开控制室的完整用法。

dsh-worktable控制室实时监控所有项目状态的卡片网格

控制室是什么:一屏看清所有项目状态

控制室是 dsh-worktable 内置的固定默认项目——始终排在侧边栏第一位,不可删除。打开后你会看到一块卡片网格,每张卡片对应一个绑定了对话的项目,卡片上展示四个要素:

  • 状态:工作中(蓝框旋转描边)/ 待决(黄光,需要你回答)/ 已完成(绿光)/ 空闲
  • 运行时长:当前任务跑了多久
  • 子代理数:该项目派生出的子任务数量
  • 消息预览:最近一条对话文本(已清理代码块,纯文字)

它就像一座"控制塔":多个项目在后台各自干活,你不用逐个切对话去问"做完了吗",一眼扫过去就全知道。控制室支持深色/白色/跟随系统主题,列数 1–5 可调,卡片形状和背景(流光、纯色、照片)都能自定义,源码位于 split.tsx 的 ConsolePane 组件。

零轮询实现:订阅驱动的宿主快照镜像

传统"监控面板"通常靠定时轮询:每隔几秒请求一次接口,问"现在什么状态?"——请求多、还滞后。dsh-worktable 控制室的做法完全不同:不主动问,改为被动订阅。

在插件入口 index.tsx 中,它通过 ctx.sessions.list.subscribe(...) 挂上宿主会话列表的变更通知,宿主状态一变,syncSessionScope 立即触发,读取 getSnapshot() 拿到的内存快照,写入模块级 sessionsSnapshotStore,再推送给所有监听者——控制室面板(consoleListeners)收到推送后立即用最新数据重渲染。

整条链路是事件驱动的:状态不变就不刷新,状态变了就瞬时更新,没有一次多余的请求。快照的归一化逻辑(兼容不同宿主版本的 byId、retainedBy、subagentsByParent 等结构)集中在 sessionCompat.ts 的 createSessionSnapshotAdapter 中,它还会记录每个会话上一次的 running 值,用来准确识别"刚跑完"这一瞬间,避免把一直空闲的旧会话误标成已完成。

零 Token 原理:状态监控为什么不调用模型

很多人会想:"让 AI 告诉我项目状态呗?"——代价是每次监控都烧 Token,还可能引入幻觉。控制室把这条路彻底堵死了,所有数据只从宿主内存读取:

卡片要素 数据来源 是否经过模型
运行中/待决/完成 快照中的 running / pendingInteraction / completed 字段 ❌
运行时长 任务的 startedAt 或对话轮次 turnTimings ❌
子代理数 subagentsByParent 目录计数 ❌
消息预览 对话事件流中的最近文本块(本地只读) ❌

消息预览由 sessionDetails.ts 的 previewFromEvents 提取:从事件流尾部找到最近一条用户或助手消息,剥离代码块后截取前 220 个字符。对从未打开过的"冷会话",控制室会做一次只读预热(readSessionPreview),不激活 agent、不触发任何模型调用;快照变化后还会防抖 6 秒再合并刷新,进一步减少无谓计算。

一句话:模型只负责干活的对话本身,监控只是"旁观"内存快照——所以无论你在控制室盯着看多久,花费都是 0 Token。

光效提醒:如何一眼找到需要你处理的项目

控制室的卡片状态判定与侧边栏项目提醒完全一致,且待决优先于完成(宿主在等待用户判断时,pendingInteraction 与 running 会同时为真):

  • 🔵 工作中:蓝色描边光晕沿卡片顺时针旋转,带实时计时
  • 🟡 待决:整卡黄色泛光——agent 在等你回答,点卡片先确认熄光再进入
  • 🟢 已完成:整卡绿色发光;新一轮完成会重新点亮,防止旧提醒被"确认"后漏掉新任务
  • ⚪ 空闲:无绑定或会话结束后的默认态

发光确认记录只保存"交互身份"(pendingAckOf 注释明确:永不持久化问题的内容),隐私上也不留痕。

快速上手:三步打开 dsh-worktable 控制室

第 1 步 · 安装插件。参考 README.md 的 Quick start,本地源码方式可先克隆再执行:

git clone https://gitcode.com/gh_mirrors/ds/dsh-worktable
dsh plugin --profile web add "link:<你的绝对路径>/dsh-worktable/01_content"

安装后重启 DSH web 进程并刷新页面。

第 2 步 · 打开控制室并绑定对话。侧边栏「工作台」区块顶部就是固定的 🖥️ 控制室入口卡(见下图,选中态高亮)。

dsh-worktable工作台侧边栏与控制室入口卡片

首次打开会弹出强制绑定弹窗:左侧"加入现有对话",右侧"新建对话"。任选其一完成绑定后,控制室即刻呈现实时卡片网格——只有绑定了对话的项目才会被监控,未绑定的显示为空闲。

第 3 步 · 点卡片直达项目。点击任意项目卡片直接打开它的分栏工作区,点卡片上的 💬 则跳到该项目绑定的对话,继续指挥 agent。

dsh-worktable控制室点击卡片打开的项目分栏工作区

小结:把"监控"变成"旁观"

机制 效果
subscribe 订阅宿主快照 零轮询:状态不变不刷新,变了瞬时推送
只读内存快照(含冷会话只读预热) 零 Token:模型全程不参与状态显示
待决优先的状态判定 + 光效确认 一眼锁定需要你处理的项目
固定首位、不可删除的默认项目 随时可用的一屏总览面板

如果你希望了解项目注册协议与卡片规范等更多设计细节,可以延伸阅读 PRD.md 与 2026-08-16_worktable-v2.md 中的控制室实现记录。多项目并行的时代,让机器自己汇报状态,把 Token 留给真正需要思考的地方。

登录后查看全文
dsh-worktable