会话状态条 290949841-gif/dsh-session-bar

会话状态条 · dsh-session-bar

让 DeepSeek Harness 侧栏里的每一个会话自己「说话」：跑着的带进度条，跑完的亮橙色。

它解决什么问题

官方侧栏的会话行只告诉你三件事：标题、一个转圈、一个相对时间（「5 分钟」）。

- 任务在后台跑的时候，你不知道它跑到哪儿了——转圈转了两分钟还是二十分钟，长得一模一样。
- 任务跑完的那一刻，界面什么都不会发生：转圈消失、时间变成「刚刚」，然后你就漏掉了它。官方只在「你不在主视图里看着」的会话上才标记完成，正在看的那个永远不亮。

这个插件只做一件事：把状态画出来。

30 秒安装

dsh plugin --profile web add dsh-session-bar

装完 ⌘Q 完全退出再打开（客户端插件在进程启动时装配，⌘R 刷新一般不够）。没有设置项，装上就工作。

效果

运行中 —— 绿色卡片 + 实时进度

- 整行转成绿色卡片（半透明绿底 + 1px 描边，和完成态是同一套骨架）。
- 行首显示估算进度百分比（81%），任务一开跑就出现。
- 底部一条 6px 高的圆头进度条，行内专门给它留了 6px 高度，不会压到标题文字；底下一条更淡的浅绿轨道，里面青绿渐变填充，长度就是估算进度；条身上散着一层白色小点，以很慢的速度横向漂移（3.2s 走一个循环，纯装饰，不闪不跳）；末端一颗 6px 白色圆钮压在条头上，圆心正好落在进度末端，跟小滑块一样滑。
- 行本身是浅绿描边 + 10% 透明底，标题转成淡绿。
- 除了小点的缓慢漂移，没有别的循环动画：不闪、不扫光、不呼吸、数字也不跳。安静但有生气。

已完成 —— 橙色卡片，一直在

- 任务跑完的瞬间，整行从绿色切成橙色：橙色描边 + 左侧橙条 + 半透明橙底 + 标题橙字，行首一颗橙色小圆点。
- 永久保留，直到你点开这一行为止。点开即恢复原样；点行尾的「…」菜单不算点开，不会误清。
- 想留几个"待办"在侧栏里反复提醒自己？就这么用。

超时了怎么办

估算总会有跑偏的时候。一旦实际耗时超过预估，行首不再硬撑一个假百分比，改显示真实已用时间：

6:12 对话框任务完成不显示颜色…

光带停在末端不再前进。这时候那个数字是真实信息，不是编的。

特性

| 特性 | 说明 |
| 状态可视化 | 运行中 = 绿色卡片 + 进度条 + 百分比；已完成 = 橙色卡片 + 圆点 |
| 完成标记不丢 | 永久保留，点开才清；标题被自动改名后标记会跟着迁移 |
| 自适应估时 | 每次跑完记录真实耗时，按会话标题留最近 6 次中位数；新会话借全局中位数；都没有按 3 分钟算 |
| 超时诚实 | 超过预估就换成已用时长，不给假的 99% |
| 零配置 | 没有设置项，装上就工作 |
| 轻量动效 | 整条只有一个 3.2s 的 background-position 漂移（小点），其余都是 width 过渡；不触发重排 |
| 不拦操作 | 只画样式，不接管点击；prefers-reduced-motion 下动画全关 |
| 两套行都兼容 | 官方 ui-workspace 的行和 dsh-session-keeper fork 出来的行都能画 |

和同类插件的区别

侧栏状态这块已经有好几个插件，各管一段。挑之前先把边界说清楚：

| 插件 | 它管什么 | 和本插件的区别 |
| dsh-session-bar（本插件） | 侧栏每一行：跑着的显示估算百分比 + 进度条，跑完转橙并一直亮 | —— |
| dsh-session-turn-eta ⭐2 | 输入框下方，当前这一轮的进度条 + 剩余时间 | 只管你正看着的那个会话；你在别的对话里工作时它看不见。本插件画在侧栏上，不切过去也能看到所有会话 |
| dsh-pinned-sessions ⭐1 | 把运行中 / 未读会话置顶到工作区上方 | 解决「排在哪」，不解决「跑了多久、跑完没」。本插件不改变任何排序 |
| dsh-unread-dot ⭐3 | macOS Dock 角标 + 提示音 | 在应用外面提醒你。本插件在侧栏就地显示，且完成态会一直亮到你点开那一行为止 |
| 官方状态点 | 只在「你不在主视图里看着」的会话上标完成 | 你正看着的那个会话跑完，官方什么都不会显示——本插件补的正是这个洞 |

一句话：那些插件回答「哪个会话在动」，这个插件回答「这条跑到哪了、跑完了没」，而且是整列一起回答。

它不做什么

刻意留白，免得装上才发现不是想要的：

- 不做通知：没有音效、没有 Dock 角标、没有系统通知（那是 dsh-unread-dot 的活）。
- 不改变排序：不置顶、不分组、不归档（那是 dsh-pinned-sessions / dsh-session-keeper 的活）。
- 不接管点击：只往行上画样式和属性，菜单、拖拽、重命名全部保持官方行为。
- 不写服务端：所有状态在浏览器 localStorage 里，删掉就等于恢复出厂。
- 不给真实进度：拿不到总步数，百分比是估的——所以超时会老实切换成已用时长，不装成 99%。

安装

方式一：npm（一条命令）

dsh plugin --profile web add dsh-session-bar

方式二：GitHub Release 包（不依赖 npm）

dsh plugin --profile web add "https://github.com/290949841-gif/dsh-session-bar/releases/download/v0.1.2/dsh-session-bar-0.1.2.tgz"

方式三：手动挂载到配置档

git clone https://github.com/290949841-gif/dsh-session-bar.git \
~/.dsh/profiles/desktop/plugins/dsh-session-bar

1. 在 ~/.dsh/profiles/desktop/package.json 的 dependencies 里加一行：

"dsh-session-bar": "file:./plugins/dsh-session-bar"

2. 在 ~/.dsh/profiles/desktop/cordis.patch.yml 里加一段：

- insert:
- id: dsh-session-bar
name: 'dsh-session-bar'

3. ⌘Q 完全退出应用再打开（客户端插件在进程启动时装配，⌘R 刷新不一定够）。

配置与重置

没有设置界面，状态都存在浏览器 localStorage 里：

| 键 | 内容 |
| dsh-session-bar:read | 已点开的会话标题（橙色标记表） |
| dsh-session-bar:durations | 每个会话标题的耗时样本（最近 6 次） |
| dsh-session-bar:durations:global | 全局耗时样本（最近 24 次） |
| dsh-session-bar:running | 正在跑的会话的开始时间戳 |

清空这几个键就等于恢复出厂设置（估时重新学习）。

工作原理

纯客户端插件，不用 React、不碰服务端：

- 以 window.__ModuleLoader__.load({ id, factory }) 的形式注入，宿主半端（index.js）故意留空。
- 每 500 ms 扫一遍侧栏行：div[data-row-key^="session:"]（官方）或 div[role="treeitem"][class="_sessionRow"]（keeper fork）。
- 判断行里有没有 [data-state="ongoing"] 这个 spinner 锚点，就知道它在不在跑。
- 状态全靠两个 data- 属性和一个 CSS 变量驱动：data-running-mark / data-done-mark / --dsh-run-progress。
- React 重渲染会把插件插进去的节点冲掉，所以每帧都会补回；MutationObserver 监听 data-state 变化做即时响应。

已知限制

- 百分比是估算的。 侧栏每行能拿到的只有 running 和 updatedAt 两个字段，后台会话的步数 / 总步数 / token 进度客户端一律拿不到。所以进度是按「这个会话以前一般跑多久」推出来的，不是真实完成度。
- 会话标题是标记的 key。如果两个会话标题完全一样，它们的标记会互相干扰。
- 只支持 Web 平台（桌面端和 Web GUI 都是 Web 渲染）。

兼容性

- DeepSeek Harness 0.2.x（DOM 锚点按 0.2.1-rc.3 核对）。
- 不依赖任何其它插件；和 dsh-session-keeper 共存（会识别它 fork 的行结构）。

更新日志

0.1.2

- 修复「整列误亮」：侧栏会话行没有 React key，列表按时间重排时 DOM 元素会被复用给别的会话；旧逻辑把"标题变了"当成"会话被自动改名"，把橙标和计时一起搬走，标记于是顺着列表扩散。现在只有占位名（新会话 / New chat）才允许迁移，其余一律判定为元素复用并清空该行状态。
- 不再信任行上的残留属性：本地标记表是唯一真相。
- 新增最短运行门槛 2 秒：必须亲眼看着这一行跑了 2 秒以上才算完成，启动抖动和恢复会话时的瞬时状态不再变橙。
- 存储结构升级，首次启动自动清掉旧版被污染的标记。
- 排障接口：window.dshSessionBar.log() / .marks() / .clearMarks()。

0.1.1

- 文档打磨：安装前置到开头、新增「和同类插件的区别」对比表、「它不做什么」、常见问题、star 引导。
- 代码无改动。

0.1.0

- 运行中：绿色卡片 + 行首百分比 + 底部 6px 轨道式进度条（浅绿轨道 + 渐变填充 + 白色圆钮，静态，只有长度在变）。
- 已完成：橙色卡片 + 圆点，永久保留到点开。
- 自适应估时与超时切换已用时长显示。

常见问题

装完没反应？ 客户端插件在进程启动时装配，⌘R 刷新一般不够，要 ⌘Q 完全退出再打开。

百分比怎么算的？ 侧栏每行只暴露 running 和 updatedAt，拿不到总步数，所以进度是按「这个会话以前跑多久」推的：每个标题记最近 6 次真实耗时取中位数，新会话用全局中位数（最多 24 次），都没有就按 3 分钟。跑得越多越准。

为什么跑完要等点开才消？ 就是故意的。一次跑十几分钟的活，希望你切回来时一眼看见「哪几个跑完了」，点开确认过才清。点行尾「…」菜单不算点开，不会误清。

颜色/粗细能改吗？ 能，改 client.js 里的 CSS 常量即可（绿色 #34d399 系、橙色 #fb923c 系、条高 6px）。改完同样要 ⌘Q 重启。

会和别的侧栏插件冲突吗？ 目前只往行上加属性和样式，不接管点击。已针对官方的行和 dsh-session-keeper fork 的行分别适配。已知：和置顶/分组类插件（dsh-pinned-sessions、dsh-session-keeper）可以共存。

dsh-session-bar 是 DeepSeek Harness 的客户端插件，让侧边栏的会话行自己说明状态：

- 运行中 —— 整行变成绿色卡片，行首显示估算百分比，还有一条 6px 的轨道式进度条（浅绿轨道、青绿渐变填充、头部白色圆点，外加细小白点缓慢漂移）。
- 已完成 —— 整行翻成橙色（边框、左侧竖条、圆点、标题染色），一直保持到你点击这一行，完成的任务再也不会悄悄溜过去。
- 超时 —— 超过估算时间后不再假装，直接显示真实已用时间（6:12），而不是假的 99%。

无需配置，没有服务端，也没有循环动画。

dsh plugin --profile web add dsh-session-bar

同类插件回答的是「哪个会话正忙」：dsh-session-turn-eta 只显示你正在看的那一轮，dsh-unread-dot 在 Dock 上打标记，dsh-pinned-sessions 重排行序。这个插件回答的是「每一行进行到哪了、有没有完成」—— 侧边栏里所有行一次看全，不用切换会话。它不加通知，不重排顺序，也从不拦截点击。

如果它省了你几次切换

那就点个 ⭐ —— 这是唯一能让别的 DSH 用户看见它的方式。

想要别的颜色、条高、或者「完成后播一声」，直接开 issue 说，这个插件现在的样子就是照着真实反馈一路改出来的：

- 仓库：<https://github.com/290949841-gif/dsh-session-bar>
- 问题/建议：<https://github.com/290949841-gif/dsh-session-bar/issues>

License

MIT