An always-on attention pill in the session header. One glance shows how many sessions are waiting on you — approvals, questions, and failures — and what you already declined. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-attention-board
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:yingrui96/dsh-attention-board
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
一个常驻的数字,告诉你现在有几个会话在等你动手。
装在会话头部的图标排里,24×24,不占地方、不弹窗、不发光。有事时变成琥珀色或红色的胶囊带数字,没事时只剩一个灰蓝的小点。
和 dsh-attention 不是一回事
市场里有一个名字很像的插件 dsh-attention,做的是通知:审批、提问、会话结束时弹一张能直接操作的卡片,另带一个桌面宠物。
这个包做的是存量:
dsh-attention |
这个插件 | |
|---|---|---|
| 触发 | 事情发生的那一刻 | 任何时候,常驻 |
| 你不在屏幕前 | 叫你(系统通知 / 桌面宠物) | 不说话,等你看 |
| 你在屏幕前 | 刻意不打扰 | 就是这时候给你看 ● 3 |
| 能不能就地处理 | 能,卡片上直接答 | 不能(只显示;✓ 已读、✕ 拒绝并记账) |
| 数据形态 | 流(事件) | 存量(当前还欠着几件) |
| 拒了有没有账 | 没有这个概念 | 有,可撤销 |
一句话:它回答「刚刚有什么事」,这个回答「现在还欠着几件」。
两个可以同时装,互不干扰——它走自己的窗口和浮层,我们只占会话头部 header.utilities 里的一个位置。
方向更正:票不用谁写
M1 最早的设想是自己维护一张票表(state.json),靠外部写入方往里填票。查过同类(agentpulse 等)之后改掉了:这些事实本来就存在于会话里,不需要谁额外记账。
Waiting 是算出来的:
Waiting = (它跑完了一轮) × (你还没看过)
agent 永远不知道自己在「等你」里——它跑完就结束了。所以这个数字不依赖任何 agent 配合,这是设计上最要紧的一点。
四态
| state | 中文 | 判定 | 要不要你 |
|---|---|---|---|
error |
出错 | 最后一轮 turn/end 的原因是 error,或停下后留着未读的工具错误 |
要 |
waiting |
等你 | 跑完一轮且你没看过;或权限/提问挂着 | 要 |
working |
在跑 | 有未结束的 turn | 不用 |
idle |
空闲 | 剩下的一切(含用户自己喊停的 aborted) |
不用 |
固定优先级:error > waiting(权限) > working > error(工具) > waiting(跑完) > idle。
圆点上的数字只数前两种(needsYou)。
数据从哪来
只订阅一条:host 事件 session/event((session, event),post-commit 增量)。
| 事件 | 记账 |
|---|---|
turn/start |
开轮 → 在跑;顺手清掉上一轮的错 |
turn/end |
关轮;记 reason.kind,error 时存 message/code |
tool/result |
有 error 就记下来(还在跑时不计入 error) |
user/message |
人说话了 → 之前「等你」当场消解,不用谁去点已读 |
不落盘、不起定时器、不写 ~/.dsh。一个 Map 就是全部状态。
跨工作区(默认就是)
插件根部订阅 session/event,ctx 是根作用域,所以收的是全部会话——不分工作区、不分窗口、不分是不是你自己开的子 agent(子 agent 也是 session,会被数进去)。
probe 是一个 Map<sessionId, row>,snapshot() 把整张表汇总成一个数字。代码里没有任何 cwd / workspace 过滤,cwd 只是行上给你认人的标签。
所以你在工作区 A 的会话里,看到的数字包含工作区 B 的会话。这本来看板的意义就在这儿——你要看的是"我总共还欠几件事",不是"这个目录欠几件事"。
两个推论:
- 数字是全局的,位置是本地的。胶囊挂在
header.utilities,那是 session 作用域,所以每个会话头顶各有一颗;但它们显示的是同一个全局数字。多开几个窗口,每窗一颗,数字一致。 - 子 agent 也算。如果不想看它们,等阶段 3d 的按
origin/delegationDepth过滤——现在没做,因为"子 agent 卡住"往往正是你想知道的事。
文件
lib/derive.js 纯函数:四态归约 + 计数 + 排序(零依赖,单测裸跑)
lib/probe.js 采集器:吃 session/event,喂 derive 认的行
lib/index.js 插件入口:订阅事件 + provide('attention') + /attention 命令 + 可选 HTTP
lib/http.js GET /dsh-attention/state(读快照)· POST /dsh-attention/seen(唯一写动作)
lib/store.js 旧的票表实现,不参与运行;declined 的账本形状当初就是照它定的
lib/client.js 浏览器半边:胶囊挂进 header slot + 分组面板 + ✓/✕/↺ 三个写动作(1489 行,无依赖,手写 DOM)
命令
/attention # 全景:几件在等你 + 四态计数 + 点名到会话
/attention status # 同上
/attention seen <id> # 标记看过(水位只升不降)
/attention seen all # 全部标记看过
/attention raw # 核对:agents.list() 有几个活会话、采集到几行、各自内部状态
raw 是给调试用的:它把 agents.list() 和采集行摊开对比,用来确认"数字对不上"是漏事件还是漏会话。
测试
cd projects/dsh-attention
node --test test/*.test.mjs # 79/79
npm run doctor # 12/12,见最后一节
test/derive.test.mjs 21 例(归约、优先级、水位、清账、已拒、新事实顶掉拒绝)、test/store.test.mjs 10 例(旧票表,保留)、test/index.test.mjs 11 例(假宿主跑命令与 service 形状)、test/http.test.mjs 8 例(四条路由的真流桩:注册/鉴权/方法/体积上限)、test/client.test.mjs 17 例(浏览器半边:vm + 手写 DOM 桩,含 10 个变异体、3 条跨插件不变量、4 条交互链路)。
注意必须显式给 test/*.test.mjs——node --test test/ 会把目录当模块解析,直接 MODULE_NOT_FOUND。
胶囊(阶段 3,lib/client.js 1489 行)
它长在宿主的会话头里,不是浮在窗口上。 通过 conversation.session.header.utilities 槽注册一个 React ref 壳,把原有的 DOM 实现原样塞进去(useLayoutEffect 里 mount(host, { inline: true }))。所以它跟着宿主布局走——侧栏收起、窗口变窄,它自己会挪,不用谁去算坐标。
早先版本是 position: fixed; right: 16px; top: 56px,压住宿主自己的按钮,已废弃。
胶囊本身必须彻底无底:主题 token、宿主按钮继承、浏览器默认样式,全部用内联 !important 压掉(kill() 逐条 setProperty)。CSS 优先级在这里靠不住——实测女仆主题下 var(--attn-surface-hover) 解析失败会让整条 !important 一起失效,所以悬浮色改成不依赖任何 token 的中性格灰 rgba(140,140,140,0.18)。
六态
| 状态 | 长相 |
|---|---|
| 没事 | 一个灰点,透明底 |
| 悬浮 | 同上 + 浅灰方底 |
| 有人在等你 | 琥珀底 + 琥珀 ● 3 |
| 有东西坏了 | 红底 + 红 ● 2 |
| 只在跑 | 蓝点,透明底(不打扰) |
| 已拒 | 灰点,不进数字(你亲手拒的,不该再烦你) |
有事才上色,没事全透明——"没颜色"本身就是信息。数字超过 99 显示 99+,免得把旁边两个 header 按钮挤歪。
读不到的时候不装作没事,也不装作不知道:拿到过数字就继续显示那个数字(淡到 40%,标题写清"显示的还是上一次的"),只有从没拿到过才显示 —。闪成 — 会让人分不清"真没事"和"读不到"——这两种情况要的东西完全相反。
点一下 ✓
每行右侧那颗 ✓ 是「我知道了」。
只有 error / waiting 两态可点;working / idle 行是禁用的——它们没有等你消解的东西,给个能点的按钮只会骗你点。
点击 → POST /dsh-attention/seen {id} → 成功后立刻重拉快照,数字当场变。不做乐观更新:本地路由几毫秒就回来了,先改 UI 反而会让失败的账对不上。
失败时按钮恢复可点、那一行抖两下并变红。静默失败等于骗人。
水位只升不降:点过就是点过了,要等下一次 turn/end 才重新计时。
点一下 ✕:拒绝并记账
✓ 说「我知道了」,✕ 说「这件事我不办」。后者是唯一带理由的写动作。
点 ✕ 不会弹对话框——行内就地长出一个输入条问「为什么不要它?」,回车记账、Esc 取消。空着回车等于承认没写理由,那也算一条账(记账时写「没写理由」)。
POST /dsh-attention/dismiss { id, reason } → 这一行变成「已拒」
POST /dsh-attention/undismiss { id } → 回到事实本身
三条规矩,都有用例钉着:
- 已拒的不进
needsYou。你亲手拒掉的东西不该继续算在● N里,否则数字就失去了"要你处理"的含义。 - 拒绝 ≠ 静音。它又跑完一轮、又报了个新错、又开了个新 turn——任何一条都算新事实,那条「不管了」自动作废,它会重新冒出来。静音是永远听不见,拒绝是听见了不管;代价就是它必须能自己回来。
- 撤销之后回到原来的样子。所以
markDeclined不动水位——顺手推seenAt会把「跑完等你」这件事永久抹掉,撤销后只能落到idle,那是假的。
已拒的行整行退下去(名字变淡、理由变斜体),但理由留在原地:账本的意义就是事后还能看见为什么。
主题
[data-attn-root] 上有一层变量映射,只认宿主的 --dsw-alias-* token:
| 本插件变量 | 宿主 token | 用途 |
|---|---|---|
--attn-bg |
--dsw-alias-bg-overlay |
面板/胶囊底 |
--attn-surface |
--dsw-alias-bg-layer-1 |
行底 |
--attn-border / -strong |
--dsw-alias-border-l1 / -l2 |
描边 |
--attn-text / -sub |
--dsw-alias-label-primary / -secondary |
正文/次级 |
--attn-error |
--dsw-alias-state-error-primary |
出错 |
--attn-warn |
--dsw-alias-state-warn-primary |
等你 |
--attn-work |
--dsw-alias-brand-primary |
在跑 |
--attn-idle |
--dsw-alias-state-idle-primary |
空闲 |
宿主切浅色主题时整块跟着变;宿主没给变量则回落到深色值。
两处细节:错误行的错因允许折到第二行(-webkit-line-clamp: 2)——TypeError: Cannot read properties of undefined 这种最该读的话不该被一句省略号吞掉;行 title 是 cwd 加 why,悬停看全貌。
与其他插件共存
这个槽里已经站着别人了(grep 实测):
| 插件 | entry id | order |
|---|---|---|
dsh-better-sidebar |
dsh-better-sidebar:context-diagnostics |
20 |
dsh-better-sidebar |
dsh-better-sidebar:bottom-toggle |
— |
dsh-purge-community |
redteam-header-toggle |
50 |
| 本插件 | dsh-attention |
60 |
order 没撞值,稳定落在最右。为此守了三条硬规矩(test/client.test.mjs 的 11–13 号用例钉着):
- id 按实例派生。
session.header.utilities是 session 作用域,分屏两个会话就有两个实例。第一个保留#dsh-attention-dot,之后是-2、-3;CSS 全部挂[data-attn-root]属性,所以序号怎么长都不影响样式命中。 <style>按引用计数。复用已存在的那份,最后一个实例卸载才真摘掉——否则先卸的那个会把别人的样式表一起删了。- slot 的 disposer 必须交回。
slots.inject(...)有返回值,丢了就会在禁用/热重载后重复注册。
另一条边界来自 better-sidebar 源码注释(他们踩过):空白会话里宿主不渲染会话头,挂在 header.utilities 的入口跟着不可达。所以新建空会话时胶囊不在,这是已知缺口,兜底排阶段 3。
已知边界(阶段 1/2 故意留的)
- 加载前的历史不回放。只监听增量,所以插件刚装上那一刻
total = 0,第一个session/event到达后立刻变准。/attention raw能看出差多少。 total是"我观察到几个会话",不是"你有几个会话"。措辞已经在命令里区分开,不假装知道全部。- 权限/提问只看得见,点不了。宿主那两个 waterfall 是"抢占回答权"的通道(见下节),我只记账不代答,所以面板里那行没有动作按钮——真要批准,去宿主自己的弹窗。
- 空白会话里胶囊的位置会换:宿主不渲染会话头,槽入口跟着不可达,于是退回浮动件。浮动件不拍死在右上角——那儿站着宿主的「展开右侧栏」按钮,拍死就是又把别人盖住。它按那个按钮的
aria-label(中英文都认)认邻居,贴在它左边 8px;认不出来就往下让到top: 96px,怎么都不压。会话头一出现,浮动件立刻让位。判据是「DOM 里有没有一个可见的[data-attn-root].is-inline」,不是「我在哪个会话」——后者要轮询宿主状态,读失败还会按错的默认值降级(better-sidebar 的注释里记了这两个坑)。 而且浮动件只在"真缺"时才出现:必须这一版页面里亲眼见过 seat,之后它才消失,才挂浮标。冷启动时宿主主界面还没渲染出来,那种阶段宁可什么都没有——否则启动那一瞬间空白页上会凭空多一个孤立的小点,比不显示还难看。 - 面板里的行还差点"高级":行容器不可键盘聚焦(里面的
✓按钮可以);30 秒轮询、失败无退避(页面藏起来时会停表,不在没人看的时候白烧)。 lib/store.js不参与运行:它是旧的票表实现,declined的账本形状({reason, at})已落到derive.js的行上,这个文件留着当参照。
路线
- 阶段 1:数得准。纯逻辑 + 采集 + 命令。✅
- 阶段 2:看得清。胶囊挂进宿主 header + 分组面板 + 跟随主题 + 跨插件共存。✅
- 阶段 3a:动得了。面板里点
✓直接标记已读(POST /dsh-attention/seen→ 立刻重拉)。✅ - 阶段 3b:拒绝并记账(
✕→POST /dsh-attention/dismiss,带理由;↺撤销)。✅ - 阶段 3c:看得见"谁在卡住你"。权限与提问挂起时,那行变成
等你批准 · Bash/等你回答 · 选哪个方案,并且只显示不代答。✅ - 阶段 3d:空白会话兜底。slot 注册成功不等于组件会被渲染,所以拿 DOM 存在性当判据:看不见就退回浮动件,看见就让位。比 better-sidebar 那套轻——首拍 600ms + DOM 变化 300ms 防抖,没有 500ms 周期表、没有命中测试走查。✅
为什么权限只显示不代答
宿主有两个 waterfall 事件:approval/request 和 user-questions/request。它们的签名是
(this, request, next) => Promise<Outcome>
——不调 next() 直接返回一个值,就是把这条请求认领了,宿主自己的弹窗根本不会出现。
这条通道能拿到"一键批准",技术上没有门槛。但一个只读看板去接管权限闸,风险收益完全不匹配:
- 我在弹窗里替人点了"允许",人就真的没看见那条命令要干什么;
- 我要是卡住(网络、渲染、死循环),用户的审批流跟着断,而他不知道断在我这儿;
- 我要是猜错了 outcome 的取值,工具调用会拿到一个宿主没预期的答案。
所以实现上只有三件事:同步记一笔、立刻 return next()、请求落定或 abort 时清掉标记。三个兜底都写了——记录抛错 try/catch 吞掉、signal 一 abort 就清、next() 的 promise finally 里再清一次。测试里钉死了"返回值必须就是 next() 的答案"和"观察者出错不改变审批结果"。
装进 DSH
cordis.patch.yml 已经就绪:
- insert:
- id: dsh-attention-board
name: dsh-attention-board
config: {}
包名是 dsh-attention-board。dsh-attention 这个 npm 名字已经被别人占了(v0.4.1,一个通知/toast 形态的同类插件),所以这里加了 -board:它是常驻看板,不是弹窗。
装法两种:
# 市场里(需要先被 awesome-dsh-plugin 收录,见 PUBLISHING.md)
# 或直接给 npm 名
plugin_manager install_bundle target=dsh-attention-board
插件只读会话状态、只挂本地路由,不碰 .npmrc / PATH / git 全局配置。
跟进 DSH 升级
这个插件依赖宿主十二个契约点。其中一半变化时页面不会有任何报错——胶囊就是不出现。所以升级 DSH 之后先跑一次:
npm run doctor
dsh-attention-board doctor · v0.1.5
✅ 包名 = client 模块 id id: dsh-attention-board
✅ 包名 = client 模块 name name: dsh-attention-board
✅ 包名 = host 插件 name name: dsh-attention-board
✅ 已装进 desktop profile L:\dsh\projects\dsh-attention
✅ profile patch 已注册 ...\.dsh\profiles\desktop\cordis.patch.yml
✅ 找到宿主 app.asar ...\resources\app.asar
✅ 宿主: conversation.session.header.utilities 在
✅ 宿主: __ModuleLoader__ 在
✅ 宿主: --dsw-alias-bg-overlay 在
✅ 宿主: session/event 在
✅ 宿主: approval/request 在
✅ 宿主: user-questions/request 在
12/12 通过
它做的事很朴素:把"静默"变成一次打勾。前三条查自己(改名最容易漏的地方——dsh-attention 那个 id 对不上的晚上,页面上一个字都没报),后九条查宿主:直接在 app.asar 里搜那六个字符串,不启动、不联网、两秒出结果。全过退出码 0,有失败退出码 1,能挂进发布前。
变了怎么办
| 失败的检查 | 大概是什么变了 | 改哪里 |
|---|---|---|
宿主: conversation.session.header.utilities |
槽位改名 | lib/client.js 两处 slot key(slots.inject 和 slots.register 的 name) |
宿主: session/event |
事件改名 | lib/index.js 的 ctx.on('session/event', ...) |
宿主: approval/request / user-questions/request |
waterfall 改名 | lib/index.js 的 watchPending(...) 两处调用 |
宿主: --dsw-alias-bg-overlay |
主题 token 改名 | lib/client.js 的 --attn-* 映射表;有 fallback,不致命,只会退化成硬编码颜色 |
包名 = ... 三条 |
改了包名没同步三处 | package.json、lib/index.js 的 export const name、lib/client.js 的 id 与 name |
不依赖的东西也值得记一笔:不读 session jsonl、不读 board 存储、不碰 sqlite。所以 DSH 改会话存储、改 schema、改迁移逻辑,这个插件零影响——这是"票不用谁写"那个决定的额外红利。
版本号在哪看
胶囊的 title 尾巴上:hover 会显示 dsh-attention-board v0.1.5。版本经 /dsh-attention/state 的 version 字段从 package.json 带出来,不用去翻 node_modules。
Links
More in this category
zhu1090093659/dsh-web#packages/dsh-task-board★ 10458
Task board for the dsh web GUI: a sidebar multi-column kanban whose cards run in real DSH agent sessions and can also be scheduled with cron expressions, executed host-side even with the browser closed.
zhu1090093659/dsh-web#packages/dsh-web-all★ 10458
Plugin and skin collection for the DSH Web UI: task board, Git graph, right-side panel, remote mobile UI, pet, live token stats, and a skin center.
ccch1mneyyy/dsh-TUI★ 7797
Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7271
A fixed-corner whale widget for the DSH web GUI — balance, today's usage and per-turn cost with peak/off-peak pricing, editable balance-alert and daily-budget bubbles, a module-based custom bubble queue with A/B weighted choices and random lines or images, 30+ vendor templates (OpenAI, OpenRouter, Kimi, SiliconFlow, Ark, Zhipu, MiniMax and more) with per-model balance and subscription quota, plus task-end sound, imported audio, custom roles and a resource manager. Local-only, no telemetry.
omdsh-dev/DSH-better-sidebar★ 5191
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
omdsh-dev/dsh-genui★ 1007
Interactive UI components rendered inline in replies: layout, charts, forms, quizzes, mermaid, 3D scenes, and an action event loop back to the model.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.