前言¶
在 DeepSeek Harness（DSH）里跑长回合、多工具、多队友协作时，对话界面主要呈现的是文本与工具调用，缺少一条和「当前回合实际做到哪一步」对齐的进度线索。单靠目测日志很难判断：主任务是否接近收尾、 delegated 队友是否在并行推进、某次中断算不算完成。社区插件 dsh-task-progress 面向 DSH Web 场景，在面板里展示当前回合的进度估计、工具活动与独立队友卡片，并可选启用 AI 观测来细化分项进度。
这是什么¶
dsh-task-progress 由维护者 HimLeoing 发布，分类为工作流类 DSH 社区插件。一句话定位：为 DeepSeek Harness Web 提供任务进度面板——本地执行证据、队友进度与可选 AI 观测（README 原文：Task progress for DeepSeek Harness. Local execution evidence, teammate progress, and optional AI observations.）。
当前包版本为 0.1.1-alpha3（见仓库 package.json）。插件在主机侧以当前 DSH 进程权限运行；安装前建议阅读仓库源码与 LICENSE，在 SkillHub 目录页 与 GitHub 仓库 核对说明。社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
环境与限制¶
README 列出的支持范围如下，其他配置不在本 alpha 版本支持范围内：
| 组件 | 支持版本 |
|---|---|
| DeepSeek Harness | 0.2.2-rc.1，Web profile |
| Node.js | >=24.9.0 |
package.json 中 engines.dsh 声明了主机版本。Desktop、TUI 及其他主机版本当前不支持。DSH 处于开发者预览阶段，升级主机前请自行核对兼容性。Probe 成本估算已内置，无需额外插件。
核心功能¶
进度面板与回合跟随¶
面板跟随你正在阅读的回合。可滚动或用会话回合导航器查看较早回合；回到底部即回到 live 回合。保留历史有上限，不可用回合会明确标识。
一步（step） 指一次已完成的智能体执行边界，并不表示已知占总工作量的比例。主回合包含负责人的整合、验证与交付；已完成的 delegated 清单或一组已完成的队友不能单独证明主请求已结束，主进度也不是队友百分比的平均值。
| 证据情况 | 展示方式 |
|---|---|
| 完整 checklist，AI 关闭 | 各活跃项的加权本地估计 |
| 无完整 checklist，AI 关闭 | 近似本地百分比，标 ≈ |
| AI 开启且证据充足 | 近似百分比，标 ≈ |
| 队友在跑 | 独立紧凑卡片；点开可看该队友进度 |
| 权威的成功回合结束 | 100% |
| 中断、失败或断连 | 显式状态，不按成功完成处理 |
本地估计在新装环境下即可工作：任务类型先验与已完成执行证据为主，可比历史仅作小幅度修正。无 checklist 的运行回合从保守近似值起步，不等待历史样本；等待与重复轮询后台输出不会推高总进度。变更、有效检查与交付证据会更新估计，返工可能降低估计。
有完整 checklist 时，当前范围内的权重冻结；显式权重或有效 AI 权重优先，否则本地估计难度。单项进度加权求和，例如 20% + 40% × 60% = 44%。未完成项不能占满其权重；返工与范围变化可降低或作废估计。验证、交付与队友完成在有执行证据时优先；没有 90% 封顶，不按时长自动爬升到九成或自动完成；仅成功回合结束才确立 100%。文本输出阶段，在满足条件时可出现可逆的 ≈99%「Writing response」状态。
面板可拖拽、可折叠。任务详情在有 checklist 时展示清单、probe 诊断，以及可横向滚动的趋势；悬停或聚焦数据点可查看进度与来源队友。
可选 AI 观测¶
AI 辅助默认关闭，在面板标题栏开启；开启后按钮有强调边框与文字。
观测使用当前会话所选模型提供商，并采用 Off reasoning。Off 仍会消耗 input、cached-input 与 output token；若提供商未声明 Off，则使用其公布的最低 reasoning 级别。
三种观测模式：
- Smart balanced：合并普通边界；优先失败、返工、checklist 变更、验证、队友生命周期等变化。
- Every other step：每两步合并普通边界，仍保留关键事件优先。
- Every step：每个符合条件的完成步都观测，反馈更细。
无新边界则不会自动发起新请求；阅读面板或等待不会触发定时 probe。请求串行化、队列有界；更细观测可能带来更高成本。关闭 AI 会丢弃未发送工作；已发送请求可能仍会计费。有完整 checklist 时关闭 AI 可冻结最后有效 AI 估计与剩余项权重；无完整 checklist 时保留灰色历史 AI 参考。Estimate once 在关闭自动 AI 时等待合格执行边界，提供一次诊断性观测，不替代本地进度。
预计剩余时间与命令进度¶
总剩余时间使用 (1 / progress - 1) × elapsed（progress 为分数）。进度或相关证据变化会重置计时锚点；普通轮询不会重置。返工可能增大估计。AI 开启时剩余时间按秒倒计时；AI 关闭时以整分钟显示，或低于一分钟时 ≈ <1m。成功完成或中断会隐藏计时器。
工具活动与总任务进度分离：单条命令在回合总工作量未知时仍可有剩余时间估计（README 中「Command progress」一节有进一步说明，资料截断处未包含全部细则）。
若浏览器 bundle 与后端版本不一致，任务详情会提示不匹配并建议重启主机。
安装与启用¶
仅 Web profile 安装。任选其一（命令摘自 GitHub README）：
安装 release 归档：
dsh plugin --profile web add "https://github.com/HimLeoing/dsh-task-progress/releases/download/v0.1.1-alpha3/dsh-task-progress-0.1.1-alpha3.tgz"
或安装带标签的源码引用：
dsh plugin --profile web add "github:HimLeoing/dsh-task-progress#v0.1.1-alpha3"
在 Plugins 中启用 bundle，重启主机，并重新加载 Web UI。包内已带运行时文件，无需 build、install script 或额外运行时依赖。仓库 topic 为 dsh-plugin；topic 与 release 本身不表示社区市场已审核上架，若走市场安装路径请先核对市场条目。
典型用法¶
- 按上文命令在 Web profile 安装并启用，重启 DSH 后打开 Web UI。
- 发起或继续一段多工具、多步骤的智能体任务；面板随当前回合更新总进度与趋势。
- 若有 delegated 队友并行执行，在面板中查看独立队友卡片并点开详情。
- 需要更细的分项反馈时，在面板标题栏开启 AI 观测并选择模式（注意 token 消耗）；默认关闭时仅依赖本地执行证据与 checklist 加权。
- 查看较早回合时通过滚动或回合导航器切换；回到对话底部跟踪 live 回合。
适用场景与注意¶
适合在 DSH Web 0.2.2-rc.1 上长时间跑 agent、需要一眼区分「主任务 vs 队友 vs 单条命令」进度、且能接受 alpha 行为与估计误差的开发者。冷启动或不熟悉任务类型时本地估计误差可能较大；中断与失败会以显式状态展示，不会被当成 100%。
插件与主机以当前进程权限执行，安装插件等同于信任其代码与网络行为（含可选 AI 观测对提供商的请求）。务必阅读 GitHub 仓库 源码与许可证后再安装。
结尾¶
dsh-task-progress 把回合级进度、队友卡片与可选 AI 观测收进可拖拽面板，补足 Web 对话里「做到哪了」这一维信息。核对环境与安装说明可参考 SkillHub 目录 与 GitHub：HimLeoing/dsh-task-progress。
