Skip to content

About

DSH 右侧栏「任务进度」:当前会话的中文进度流水、阶段目标与卡点提醒

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dsh-task-progress

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 profile)

当前 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。
  • 原始命令文本不会通过接口返回,也不会画到面板上。

HTTP 接口

方法 路径 说明
GET /task-progress/api/list?only=current&current=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-smoke
  • tools/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 会话不在工作区表里。

License

MIT

About

DSH 右侧栏「任务进度」:当前会话的中文进度流水、阶段目标与卡点提醒

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages