DeepSeek Harness Plugin

yingrui96/dsh-attention-board

Stars ★ 0 Downloads (30d) 1,373 Category UI Enhancements Added 2026-11-16 npm dsh-attention-board

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 }         →  回到事实本身

三条规矩,都有用例钉着:

  1. 已拒的不进 needsYou。你亲手拒掉的东西不该继续算在 ● N 里,否则数字就失去了"要你处理"的含义。
  2. 拒绝 ≠ 静音。它又跑完一轮、又报了个新错、又开了个新 turn——任何一条都算新事实,那条「不管了」自动作废,它会重新冒出来。静音是永远听不见,拒绝是听见了不管;代价就是它必须能自己回来。
  3. 撤销之后回到原来的样子。所以 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 号用例钉着):

  1. id 按实例派生。session.header.utilities 是 session 作用域,分屏两个会话就有两个实例。第一个保留 #dsh-attention-dot,之后是 -2、-3;CSS 全部挂 [data-attn-root] 属性,所以序号怎么长都不影响样式命中。
  2. <style> 按引用计数。复用已存在的那份,最后一个实例卸载才真摘掉——否则先卸的那个会把别人的样式表一起删了。
  3. slot 的 disposer 必须交回。slots.inject(...) 有返回值,丢了就会在禁用/热重载后重复注册。

另一条边界来自 better-sidebar 源码注释(他们踩过):空白会话里宿主不渲染会话头,挂在 header.utilities 的入口跟着不可达。所以新建空会话时胶囊不在,这是已知缺口,兜底排阶段 3。

已知边界(阶段 1/2 故意留的)

  1. 加载前的历史不回放。只监听增量,所以插件刚装上那一刻 total = 0,第一个 session/event 到达后立刻变准。/attention raw 能看出差多少。
  2. total 是"我观察到几个会话",不是"你有几个会话"。措辞已经在命令里区分开,不假装知道全部。
  3. 权限/提问只看得见,点不了。宿主那两个 waterfall 是"抢占回答权"的通道(见下节),我只记账不代答,所以面板里那行没有动作按钮——真要批准,去宿主自己的弹窗。
  4. 空白会话里胶囊的位置会换:宿主不渲染会话头,槽入口跟着不可达,于是退回浮动件。浮动件不拍死在右上角——那儿站着宿主的「展开右侧栏」按钮,拍死就是又把别人盖住。它按那个按钮的 aria-label(中英文都认)认邻居,贴在它左边 8px;认不出来就往下让到 top: 96px,怎么都不压。会话头一出现,浮动件立刻让位。判据是「DOM 里有没有一个可见的 [data-attn-root].is-inline」,不是「我在哪个会话」——后者要轮询宿主状态,读失败还会按错的默认值降级(better-sidebar 的注释里记了这两个坑)。 而且浮动件只在"真缺"时才出现:必须这一版页面里亲眼见过 seat,之后它才消失,才挂浮标。冷启动时宿主主界面还没渲染出来,那种阶段宁可什么都没有——否则启动那一瞬间空白页上会凭空多一个孤立的小点,比不显示还难看。
  5. 面板里的行还差点"高级":行容器不可键盘聚焦(里面的 ✓ 按钮可以);30 秒轮询、失败无退避(页面藏起来时会停表,不在没人看的时候白烧)。
  6. 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。

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.