dsh-progress-lens

Progress Lens · 进度透镜

长任务跑到一半，你不知道它干到哪了。 不想开一堆思考链翻，也不想打断它问一句。

进度透镜在右侧栏开一个小窗口。它隔一会儿用一句人话说：做完了什么、现在手头是什么、接下来大概做什么。你可以随时在里面问一句——问进度，或者随便聊两句。

只读。不改会话，不另开模型跑任务，不打断正在跑的东西。

---

它解决什么

跑长任务的时候，最难忍的不是等，是不知道在等什么。你看见一堆工具名、文件路径、轮次步数、报错码，得自己翻译成「哦它在改那个文件」。或者干脆停下来问一句——但停下来，任务就断了。

进度透镜干两件事：

1. 翻译。 后台收 agent/assistant-stream、session/event、agent/status 的原始动静，攒着，隔一段时间（或攒够十次工具调用、或一轮结束）才交给模型压成两三句人话推到你眼前。你看到的永远是摘要，不是刷屏。
2. 能搭话。 底部输入框随时问。走的是独立的一次模型调用——不带会话 ID、不带工具、不写会话记录，所以它答话不会污染你的主对话，也不会打断正在跑的任务。

工具名、路径、报错码全部翻成人话：ops_bash → 「在命令行里敲命令」，EPERM → 「有个文件被别的程序占着，改不动」，FS_EDIT_NOT_FOUND → 「要改的那段文字没对上，得重新找一遍」。

---

装

前提两件事：

• DeepSeek Harness 桌面版，0.2.x
• 装了 dsh-better-sidebar（进度透镜借它的右栏）

在 dsh 里说一句就行：

装一下 dsh-progress-lens，从 github:ralcer-he/dsh-progress-lens

或者直接在 插件市场 里搜 进度透镜。装完重启一次 dsh。

命令行：

dsh plugin --profile desktop add github:ralcer-he/dsh-progress-lens

---

用

会话标题栏右上角多一个脉冲折线图标。点一下，右侧栏展开——主界面被挤窄，不是浮在上面盖住。再点一下收起。悬停有底色，展开时底色常亮，一眼看得出开没开。

面板里长这样：

进展 已经把右边栏从浮层改成了正经的侧边栏，现在点一下就能开合。正在核对图标的悬停底色跟旁边那些是不是一致，还没报错。接下来大概会跑一遍冒烟，再让你刷新看看。

底部可以问：

• 现在到哪了
• 大概还要多久
• 累不累啊
• 你是谁

它会答：「这会儿在命令行里核对刚才跑出来的结果，暂时没卡住。剩下就是看结果对不对、再定下一步，具体多久不好说准。」

只在当前对话窗口里出现，切换会话就换内容，不会串。

---

配置

没有配置项。装上就用。

它不会替你决定什么时候该说话——默认 75 秒一次、每十次工具调用一次、每轮结束一次。觉得吵就把它收起来，收起来它就不推了（还在后台记，展开时补齐）。

---

它不做什么

• 不写你的会话。 一个字节都不写。
• 不跑任务。 你问它话走的是旁路调用，不带工具，改不了任何文件。
• 不猜。 只报已经发生的。问「还要多久」，它不会编一个数字。
• 不常驻。 面板收起时不占资源，图标还在。

---

出问题

现象	怎么办
图标没出现	重启 dsh；确认插件在「插件 → 已安装」里是启用状态
图标有，点开没反应	没装 dsh-better-sidebar，先装它
面板一直「暂时还没动静」	当前没有任务在跑，发一个试试
一直「断线了，正在重连…」	宿主版本不对，需要 0.2.x

---

开发

node _smoke.mjs     # 前端半截的冒烟测试：假 ctx + 假 React，断言 tab 与图标注册

两个半边：

• index.js — 宿主。订阅事件、按 sessionId 分桶、攒痕迹、调 ctx.llm.stream 压摘要、开两个 HTTP 路由（/__progress_lens/stream SSE、/__progress_lens/ask POST）。
• client.js — 浏览器。ctx.betterSidebar.registerTab 注册右栏 tab，conversation.session.header.utilities 注册标题栏图标。

MIT.