前言¶

在 DeepSeek Harness（DSH）里跑多步智能体时，任务清单、当前做到哪一步、模型与工具耗时、上下文占用往往分散在会话内部或调试视图里。想在不打断输入的前提下扫一眼「完成了几项、正在干什么」，通常要展开面板或翻日志。下面介绍的 dsh-work-progress 是社区维护的客户端插件，在输入框上方的 dock 带区常驻一行工作进度，折叠即可看完成度与当前任务，展开可看完整清单与统计；数据直接订阅宿主已有投影，不另建 RPC、不轮询。

这是什么¶

dsh-work-progress（GitHub：ardesp0630/dsh-work-progress）由 ardesp0630 维护，分类为客户端插件（dsh.client.platform: web）。当前 package 版本为 0.1.1，许可证 MIT，Node 引擎要求 >=22。

一句话定位：在 DSH 对话界面输入框上方常驻一行工作进度——折叠态显示任务完成度、进度条与当前进行中的任务；展开态显示完整任务清单，以及轮次、步骤、模型/工具耗时与上下文占用。

核心功能¶

折叠行显示什么¶

插件根据会话是否在跑、是否有任务清单，切换不同展示（不占位时整块不渲染）：

展开后额外信息¶

每条任务的状态：✓ 完成 / ▸ 进行中 / ○ 待办；以及运行状态、轮次、步骤、模型耗时、工具耗时、上下文占用百分比。

数据来源（与宿主同步）¶

面板不建立自己的 RPC，也不轮询。它订阅主机已通过 wire 对浏览器可见的会话投影：

• todos — 任务清单
• sessionStats — 轮次、步骤、耗时
• contextPressure — 上下文占用
• 会话快照的 running — 运行状态

因此数据始终与宿主同步；主机侧说明见仓库 lib/index.js。

与内置任务条的关系¶

DSH 自带任务条（conversation.input.dock 中 id 为 todo、order 0）。本插件使用 id work-progress、order 5，与内置条目并排共存，不替换内置 UI。若只想保留一个，把本插件的 id 改成 todo 即可顶替内置条目。

安装与启用¶

安装方式以仓库 README 为准：先把插件目录放进 DSH 的 plugins 目录，再在 profile 里登记依赖与 bundle，最后安装依赖并重启。

1、复制插件到 plugins 目录（PowerShell 示例，路径按你的环境调整）：

# 1. 把本目录放到 DSH 的 plugins 目录
$dsh = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $env:USERPROFILE ".dsh" }
Copy-Item . (Join-Path $dsh "plugins\dsh-work-progress") -Recurse -Force

2、登记到 profile（以 desktop 为例，编辑 %DSH_HOME%\profiles\desktop\package.json）：

{
  "dependencies": {
    "dsh-work-progress": "link:C:/Users/ardesp0630/.dsh/plugins/dsh-work-progress"
  },
  "dsh": {
    "profile": {
      "bundles": [
        // ...已有的 bundles...
        "dsh-work-progress"
      ]
    }
  }
}

link: 路径需改成你本机 plugins 目录的实际位置。

3、安装依赖并重启

在 profile 目录执行：

pnpm install

然后重启 DSH 并刷新浏览器。

也可以用官方 CLI 完成登记（README 原文）：

dsh plugin --profile desktop add <路径或包名>

典型用法¶

启用后无需单独配置字段：只要当前会话通过宿主投影暴露了 todos、sessionStats、contextPressure 与 running，折叠行会自动反映进度；点击展开即可查看任务明细与耗时、上下文占用。

开发与校验时，仓库提供：

node --test test/
node scripts/verify.mjs

（对应 package.json 中的 test 与 verify 脚本。）

适用场景与注意¶

适合谁：经常在 DSH Web 客户端里跑多步任务、依赖 Todo 清单推进、又希望在输入框附近一眼看到「几项完成、正在做什么、上下文是否吃紧」的开发者。

权限与安全：插件以当前 DSH 进程及其 Web 客户端注入的权限运行；安装前请自行阅读仓库源码与 MIT 许可证，确认 bundle 与 cordis.patch.yml 符合你的环境策略。社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系，不宜当作官方应用商店条目理解。

卸载：从 dsh.profile.bundles 移除 dsh-work-progress，删除 dependencies 中对应项，重新 pnpm install 并重启 DSH。

结尾¶

dsh-work-progress 把任务完成度、运行态与统计信息收到输入框上方一行 UI 里，并靠宿主已有 wire 投影保持同步，适合作为 DSH「一切皆插件」生态里的轻量客户端增强。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。