前言¶

在 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 倉庫。