会话状态条 · 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.1/dsh-session-bar-0.1.1.tgz"
方式三：手动挂载到 profile
git clone https://github.com/290949841-gif/dsh-session-bar.git \
~/.dsh/profiles/desktop/plugins/dsh-session-bar
在
~/.dsh/profiles/desktop/package.json的dependencies里加一行："dsh-session-bar": "file:./plugins/dsh-session-bar"在
~/.dsh/profiles/desktop/cordis.patch.yml里加一段：- insert: - id: dsh-session-bar name: 'dsh-session-bar'⌘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.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）可以共存。
English
dsh-session-bar is a client-side plugin for DeepSeek Harness that makes sidebar session rows self-describing:
- Running — the row turns into a green card with an estimated percentage at the leading edge and a 6px track-style progress bar (soft green track, teal gradient fill, white knob at the head, and a slow drift of tiny white dots).
- Done — the row flips to orange (border, left bar, dot, tinted title) and stays that way until you click the row, so finished tasks never slip by unnoticed.
- Overtime — past the estimate it stops pretending and shows real elapsed time (
6:12) instead of a fake 99%.
No configuration, no server side, no looping animations.
dsh plugin --profile web add dsh-session-bar
Other plugins in this space answer "which conversation is busy": dsh-session-turn-eta only shows the turn you are looking at, dsh-unread-dot badges the Dock, dsh-pinned-sessions reorders rows. This one answers "how far along is each one, and did it finish" — for every row in the sidebar at once, without switching conversations. It adds no notifications, reorders nothing, and never intercepts clicks.
如果它省了你几次切换
那就点个 ⭐ —— 这是唯一能让别的 DSH 用户看见它的方式。
想要别的颜色、条高、或者「完成后播一声」，直接开 issue 说，这个插件现在的样子就是照着真实反馈一路改出来的：
- 仓库：https://github.com/290949841-gif/dsh-session-bar
- 问题/建议：https://github.com/290949841-gif/dsh-session-bar/issues
No comments yet. Be the first to write one.