DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-work-status

d

dsh-work-status

Identified

DeepSeek Harness 插件：把 Agent 的工作状态收进标题栏一行——在做什么、做到哪、失败过没有；点开是目标、当前步、最近记录与上一轮。不调模型、不写提示词，只读已发生的事件。

dsh-work-status

简体中文 · English

一行状态看清 Agent 在做什么；点开是目标、当前步、最近的记录与上一轮。

ci license: MIT DSH Market DeepSeek Harness plugin

一个 DeepSeek Harness 插件，用尽量少的注意力回答一个问题：

它现在在做什么、已经做完了什么、有没有卡住？

默认只在输入框上方占一行，点开是工作状态，再点收起。

● 本轮 29 步                                            6m49s  ⌃

点开之后：

本轮 29 步                                              6m49s  ×
目标  按你定的方案改：固定右下浮窗、行内展开、圆环状态点…
推理 6m35s · 工具 13s · 压缩 16 次 失败 3
确定 3/4 · 75%（按当前清单）
○ 运行测试  tests/client-render.test.mjs                    362ms
● 修改文件  lib/client.js                                    1.2s
✗ 压缩上下文 m00301–m00356 · 省 ~…                  未恢复  27ms
  没压成：范围已失效，本次没有新增压缩块
展开本轮历史 · 37 步 ⌄
上一轮 · 第 20 轮                                          2m14s ⌄
                                   日志 · 复制 · 收起

面板动图：思考中 → 运行测试进行中 → 运行测试失败（未恢复）→ 同一目标重试成功（旧行划掉转灰），进度条随清单推进

面板 · 深色

动图（浅色）：进行中、失败、失败被后来的同类成功救回（划掉转灰）、进度随清单推进——状态会变，静态图看不出来。 都用插件自己的样式表和文案、套主题令牌渲染；运行中的应用是同一套结构，只是填真实数据。

显示什么

  • 默认一行：干活时显示当前动作与已用时，结束后显示本轮完成步数；不往对话区上浮任何卡片。
  • 目标与当前问题：你提的要求、它正在处理的小问题，各自截断并可展开。
  • 三个分开的时钟：模型推理、工具调用、上下文压缩各自计时，不合并成一个“已用时”；单步耗时按类别（本地 / 网络 / 后台）拆开，不是一笔糊账。
  • 只在有真实数据时给进度：agent 维护 todo 清单时才显示百分比（确定 3/4 · 75%，并注明“按当前清单”）；没有清单就不画那一行，不对整轮外推 ETA。
  • 每个动作都说人话：运行测试、修改文件、压缩上下文，带目标与耗时。失败标 未恢复 或 已恢复（同一目标后来成功），能识别时直接给一句人话，不甩栈。
  • 上下文维护按普通记录排：压缩 / 恢复 / 检索与工具行按时间排在一起，能看出它插在哪一步，又不虚增步数。
  • 上一轮：上一轮折叠成一行放在分割线下，轮次结束后卡片仍能回答“刚做了什么”。
  • 会话日志：轮次、步数、调用次数、每轮推理/工具用时、压缩次数与失败、最近 24 轮，可一键复制成纯文本。
  • 下载进度（可选）：本机若装了写状态的下载器（状态在 ~/.agent-downloads/jobs/），卡片会多一块「下载」——文件名、百分比、速度、剩余时间、当前阶段，最多列 4 条；进程已经不在却还写着「下载中」的标成中断，不假装在跑。没有那个目录就什么都不画。读写契约见 docs/DOWNLOAD-STATUS-SPEC.md：任何按这份约定写 status.json 的下载器都能接上，卡片本身不下载、不取消。
  • 看不懂的步骤点开有大白话：把一步展开，下面多一行解释这步在干什么（「运行测试 = 验证改动没弄坏别的」）。按动作类型给解释，词典里没有的工具就不加这行。

刻意不做的事

  • 不调模型、不注提示词、不对外发网络请求，数据不出本机（下载进度只读本机自己的接口）。
  • 不还原“思考内容”，只报告可观察事件；事实与推断分开，不知道就写不知道。
  • 没有 todo 数据就不画进度条，不做 0% / 100% 的装饰。
  • 不评价 agent 想得对不对。

安装

插件是一个 DeepSeek Harness bundle，用插件管家安装。从 npm 装（插件中心的「安装」按钮走同一条路）：

dsh plugin --profile web add dsh-work-status

其它来源：

来源命令
本地目录install link:E:/path/to/dsh-work-status
打包文件npm pack → install file:./dsh-work-status-<version>.tgz
GitHubdsh plugin --profile web add github:xsllo425/dsh-work-status
（插件内命令可简写为 install github:xsllo425/dsh-work-status）

桌面端也可以走 插件 → 添加插件，直接填仓库地址。

  • 改动宿主侧（lib/activity.js、stateVersion）需要重启 Harness；只改客户端会随页面刷新加载。
  • 卸载即移除这一行；插件不写自己的会话数据。
  • 没有需要配置的项。

更新

插件不联网、不会自己更新，装法决定更新方式：

装法更新
npm重跑安装命令就是更新：dsh plugin --profile web add dsh-work-status（装到最新版）
GitHub重跑安装命令就是更新：dsh plugin --profile web add github:xsllo425/dsh-work-status。想固定在某个版本，在仓库地址后面加 tag（形如 #v0.9.1，版本号见 Releases 页）
本地目录在那个目录 git pull；用 link: 装的话改完重启就生效
打包文件重新 npm pack，再按 file: 装一遍

想确认装的是哪一版，看 ~/.dsh/profiles/<profile>/node_modules/dsh-work-status/package.json 里的 version。只改客户端的版本刷新页面就够，动过宿主侧的版本要重启 Harness。每一版改了什么见 CHANGELOG.md。

本地步耗时统计

新会话的前几步想显示「同类通常 3–8 秒」，就得知道以前同类步用了多久，插件为此在本机记一份小统计。

  • 位置：~/.dsh/work-status/step-stats.json（Windows：%USERPROFILE%/.dsh/work-status/step-stats.json）。
  • 内容：工具归类键（model|read、tool|local|edit 等）+ 整数毫秒。不含路径、命令、提示词、会话 id、时间戳。
  • 有上限：每类最多 30 个样本、最多 48 类，文件长期只有几 KB。
  • 随时可以直接删掉这个文件，等于回到冷启动；下一轮结束后会自动重建，插件不会因此报错。
  • 想彻底关闭，设 DSH_WORK_STATUS_NO_HISTORY=1。
  • 来自历史会话的参照在面板上标「据历史」；本会话同类样本攒够 5 个后会自动改用本会话数据。

兼容性

  • DeepSeek Harness >= 0.2.1-rc.2，Web UI。
  • 可选：装了 dsh-claude-style 并把桌宠放在输入框上方时，插件隐藏自己的徽标，改为右键桌宠打开面板。
  • 不含对方的美术资产：只读它的 CSS 类名（.dsh-claude-deepy / .dsh-claude-crab），不复制、不内联任何桌宠图片；螃蟹「Clawd」是 Anthropic 的角色，版权不在本项目。
  • 不绑定主题：颜色、描边、字体都取宿主 CSS 变量（--dsw-alias-*），浅色/深色/第三方主题自动跟随。

开发

node --check lib/client.js && node --check lib/activity.js && node --check lib/index.js
node --test tests/*.test.mjs          # 132 项，无任何依赖
node scripts/check-manifest.mjs       # 清单、导出、补丁行、图标、语言包

无运行时依赖，也无开发依赖，Node 24 直接跑。

lib/index.js        宿主入口，注册会话投影
lib/activity.js     纯事件折叠（stateVersion 19，投影键 "workStatus"）
lib/client.js       Web UI：徽标、面板、时间轨、日志、双语文案、样式
locale/*.json       插件列表里的名称与简介（中/英）
icon.svg            插件图标
cordis.patch.yml    bundle 补丁行
docs/               HANDOFF.md、RESEARCH-COMMUNITY.md、STATS.md

客户端不折叠事件，只渲染投影。投影状态形状变化时必须递增 stateVersion——旧 checkpoint 会被丢弃，从日志重放。

文档

想立刻清掉它：npm run reset-stats（先看路径可加 -- --dry）。

介绍用的 7 页 PPT：docs/dsh-work-status-intro.pptx（封面、界面、口径、边界、安装）。

边界

  • 显示的一切都来自会话事件流；工具结果没回来时，那一行写「结果未知」，不猜。
  • 数字都是本会话单轮或单步的；跨会话历史只存在本机，有上限，可随时删除（见下面「本地数据」）。
  • 桌宠联动是 best-effort：它盯的是 dsh-claude-style 的吉祥物，属于主题内部实现。主题一改就可能失效；给 <html data-dws-pet="off"> 就能停掉联动，徽标会自动回来。
  • 只有计划有真实总数（n/m 待办）时才画百分比；没有就不画进度行，绝不编进度条。

致谢

这个插件是在多个 AI 助手的协助下写成的。名单按本机会话记录整理（DSH、Claude Code、Codex 的会话里，实际改过本仓库文件的模型），按参与多少排列：

  • DeepSeek Flash
  • DeepSeek V4.1 Flash
  • Claude Opus 5.5
  • GPT-6.1 Terra
  • GPT-6 Astra
  • SCNet-Max
  • GLM-5.3 Flash
  • Kimi K3.1 Pro
  • StepFun Step-5 Preview

许可

MIT，见 LICENSE。最初分叉自 oxygenforce 的 dsh-agent-activity 0.9.0，"把会话日志折叠成输入框上方一条状态"的思路来自它；0.13.0 起代码已全部改写，不再包含它的代码，见 NOTICE。

Comments

Loading…