DSH(DeepSeek Harness)右侧栏的「任务进度」面板:只看你当前正在看的那个会话,用一段中文文字流水告诉你——它在想什么、执行到哪一步、这一阶段花了多久、要不要你出手。
- 只显示当前会话,不把别的会话堆进来;切换会话,面板跟着换。
- 中文动作流水:把会话日志里的工具调用归成「跑测试 / 跑脚本 / 搜代码 / 看文件 / 写文件 / 看目录 / 调接口…」,带
HH:MM:SS,最新在上。原始 shell 命令不显示(又长、还可能带密钥)。 - 近 N 步汇总:
近 6 步:跑测试 ×2 · 读文件 · 改文件 · 搜代码,一眼看出这段时间在干嘛。 - 阶段目标 + 本步耗时:任务书里有进行中项时显示
第 4/6 步「…」· 本步已 3 分 20 秒;没有任务书就退化成当前动作:跑脚本 · 本轮已 1 分 12 秒。 - 判断要不要干预:
暂时不用管/已 8 分钟没动静,建议看一眼/这一轮已结束。真需要你出手时,换成琥珀色的「需要你协助 · 具体做什么」。 - 思考态:最后一条不是工具调用时显示
正在思考…(已 N 秒),长时间静默会提示可能卡住。 - 明暗两套皮肤,颜色全部走 DSH 主题变量;图标一律内联 SVG,不用 emoji。
长会话里 agent 会连续跑很多工具、思考很久,而 DSH 主对话只给你最终的回复或英文推理。 你想知道「它现在到底在干嘛、这一步跑多久了、要不要我去处理」,只能翻会话日志。 这个插件把会话日志读成一句人话,贴在右侧栏。
当前 DSH Web 的插件加载方式是「包目录 + cordis.patch.yml 里一行 insert」:
# 1) 放到 web profile 的 node_modules
git clone https://github.com/<your-name>/dsh-task-progress.git
cd dsh-task-progress
ln -s "$PWD" ~/.dsh/profiles/web/node_modules/dsh-task-progress
# 2) 在 ~/.dsh/profiles/web/cordis.patch.yml 末尾追加
- insert:
- id: dsh-task-progress
name: 'dsh-task-progress'
# 3) 重启 DSH 宿主(插件没有热加载,重启方式按你的部署来)安装后:右侧栏 + → 「任务进度」。
目录名、profile 名、重启方式取决于你的 DSH 部署,按自己环境的实际路径替换。
全部来自 DSH 自己写在磁盘上的事实,只读:
| 面板上的东西 | 真源 |
|---|---|
| 标题 / cwd / 在跑证据 | ~/.dsh/storages/session_projcache/sessions/<uuid>.json |
| 当前任务书 | 会话日志 <DSH_HOME>/sessions/**/session.v3.jsonl.zstd 里最后一次 todo_write / todo/write(整表覆盖,取最后一条) |
| 中文动作流水 | 会话日志里的 tool/call(name + arguments),由 describeToolCall() 归成一类中文动作 |
| 思考态 / 阶段耗时 | turn/start、turn/end、todo/write 的时间戳 |
| 工作区归属 | ~/.dsh/storages/workspace.json |
- 不调用任何模型;不联网;不写会话。
- 日志解压用系统
zstd,单文件上限 64MB;解析结果按mtime+size缓存,整体快照 2 秒 TTL。 - 原始命令文本不会通过接口返回,也不会画到面板上。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /task-progress/api/list?only=current¤t=session-<uuid> |
快照 { ok, at, sessions[], stats, diag };only=current 只回当前会话 |
| POST | /task-progress/api/dismiss |
body { sessionId, fingerprint },记为「已确认」 |
| POST | /task-progress/api/undo |
body { sessionId },撤销确认 |
三个路由都校验 DSH 登录态(lib/auth.js,cookie dsh-auth-<base64url(sha256(authority))>)。
需要 Node 20+ 和系统 zstd:
npm install # 只装 react/react-dom 跑渲染冒烟
npm test # 语法检查 + selftest + host-smoke + render-smoketools/selftest.mjs:临时DSH_HOME里造样本,钉住「只取最后一条任务书 / 当前会话置顶 / 中文动作 / 阶段 / 思考态」等口径;tools/host-smoke.mjs:假 ctx 拉起 host 半区,验 3 条路由、401/405/400、only=current;tools/render-smoke.mjs:把lib/client.js喂真 react 服务端渲染,断言不是卡片、中文动作、需协助提示等。
- 会话日志是 zstd 整文件,没有增量读;按活跃度排队 + 缓存。
- 「阶段目标」优先取任务书里的进行中项;没写过
todo_write的会话只能显示「当前动作」,无法凭空知道目标。 - 面板只读当前会话;其它会话要看,切过去即可。
- 只在 DSH Web profile 下验证过;headless/CLI 会话不在工作区表里。
MIT
