前言¶

在 DSH Web 裏跑長會話時，任務清單、目標、已提交計劃、變更文件、子智能體和後臺任務往往分散在不同面板或右欄裏；本輪時間花在模型、工具還是等待審批，也需要對照日誌才能估出來。下面介紹的 dsh-status-card（維護者 liuhusk，包名 @liuhusk/dsh-status-card）把這些信息收攏到內容區右上角一張可摺疊的浮動卡片裏，多數操作仍走 DSH 官方投影與 Remote，客戶端以只讀聚合和少量 Host 路由補充爲主。

這是什麼¶

該插件屬於 DSH 客戶端（Web） 擴展：在有主會話的會話頁常駐渲染，不新增會話事件、不寫官方狀態。卡片跟隨內容區寬度與右欄開合重定位；查看插件、定時任務等全局面板時整卡隱藏，避免壓住其他界面。社區目錄頁：skillhub.cn/plugins/liuhusk/dsh-status-card；源碼與說明：github.com/liuhusk/dsh-status-card（MIT，當前資料版本 v0.23.3）。

核心功能¶

卡片按區塊展示，有內容才渲染對應塊；若除耗時外皆空，正文區會顯示「暫無任務與變更」，卡片本身仍在。

標題欄與摺疊¶

頂欄顯示項目名（會話 cwd 目錄名，懸停可見完整路徑）和副標題（會話標題，缺省爲 Agent 工作區語義下的默認文案）。兩個 28px 圓形按鈕：⟳ 立即重取變更列表，⌄ 收起卡片。摺疊後收成 34px 圓鈕（內含 <），再點展開；寬度不足時自動收成圓鈕，窗口變寬後自動展開。內容區變窄時，卡片可通過給內容區增加 padding-right 把正文列向左推讓，推到極限則只保留圓鈕佔位。

本輪耗時¶

頂欄下爲一行只讀文字：總計如 本輪 25m32s，再接 模型 · 工具 · 等你 細分（並行工具按重疊區間只計一次；重疊歸屬順序爲等你 → 工具 → 模型）。宿主約每 2 秒採樣，未結束的段每秒遞增；turn/end 後定格，輪次間空閒不計入。

任務、目標與計劃¶

• 任務：官方當前 todos 投影，帶勾選環、進度 pill 與 2px 進度條，可摺疊，硬上限 200 條。另有一組只讀歷史任務（最近一個有清單的歷史輪次），默認收起，從會話日誌還原，已清空的清單不會復活。
• 目標：展示官方目標文本、階段、輪次與受阻原因，並讀宿主 activation；可在卡片內 編輯（Enter 保存 / Esc 取消）、暫停、繼續、清除，走 ctx.remote.goals 與 CAS。active 但 disarmed 時顯示待繼續並提供繼續。
• 計劃：本會話經 exit_plan_mode 提交的計劃標題（新的在前，最多 20 條），點行用官方 plan 預覽類型在右欄打開正文。

變更文件、子智能體與後臺任務¶

• 變更文件：整會話按路徑去重的變更列表，圖標與分類與 DSH「工作區文件」一致，附 +added / -deleted；多輪時分爲「本輪」與「更早改動」。點行打開官方變更審查右欄。
• 子智能體：parentId 指向本會話的子會話，行結構與官方目錄一致，按委派輪次分組（當前輪展開，早前輪折成彙總行）。點行通過 ctx.uiWorkspace.openSession 切換到該子會話。
• 後臺任務：通過 @deepseek-ai/dsh-api-job-controller 的 ctx.jobs 鏡像宿主面板；運行中常顯，已結束默認折成「已結束 N」並可 清空（僅本頁隱藏，不改宿主記錄）。運行行提供兩段確認的 停止，與宿主行爲一致。

主題與其它行爲¶

在 插件詳情頁（插件 → 本包）的「高亮色」中可在綠 / 藍 / 琥珀 / 紅四檔預設間切換，選擇存在瀏覽器 local storage。卡片啓用後，會通過 CSS 隱藏輸入框上方僅展示、無操作的官方任務面板（HIDE_OFFICIAL_TODO_DOCK）；官方目標條仍保留。數據主要來自 SessionSummary.projectionValues、座位 useSessions，以及 Host 路由 GET /api/status-card.changes?sessionId=…（變更、計劃索引、歷史任務等）。

安裝與啓用¶

要求 DSH 0.2.1-rc.3 及以上（卡片依賴該線的 shell.overlay 座位與會話控制器）。本包不發 npm，從 GitHub 安裝：

# 跟最新 main
dsh plugin --profile web add github:liuhusk/dsh-status-card

# 或釘住某個 Release 標籤
dsh plugin --profile web add github:liuhusk/dsh-status-card#v0.23.3

通過插件管理器升級後：若狀態爲 applied，刷新頁面即可；若爲 restart-required，需先重啓 dsh web 再刷新。僅刷新網頁不能替換運行中的 Host 模塊；新 Host 生效前，Client 可能仍用舊耗時邏輯，缺少歷史字段時不顯示歷史任務組。

典型用法¶

安裝並進入任意主會話頁後，卡片默認出現在內容區右上角，無需額外配置文件。

1. 看本輪時間：直接讀頂欄下的耗時行；輪次結束後數字凍結，便於對照本輪產出。
2. 管目標與任務：在卡片內編輯或暫停目標；任務列表可摺疊，需要時可展開歷史輪次的只讀清單。
3. 打開計劃或變更：點計劃行在右欄讀完整計劃；點變更文件行進入變更審查。
4. 跟進子智能體與後臺命令：點子智能體行切到子會話；對仍在運行的 bash 後臺任務使用停止（需二次確認）。
5. 換強調色：打開插件詳情頁，在「高亮色」點選色點，卡片內勾選環、進度條、計劃燈泡等會當場換色。

標題欄的 ⟳ 用於在長時間工具調用後手動刷新變更列表；空間不足時先依賴自動推讓與圓鈕摺疊，需要時再手動點圓鈕展開。

適用場景與注意¶

適合在 DSH Web 中長期使用 Agent 工作區、需要一眼看到任務進度、目標狀態、計劃入口、變更與子會話跳轉的開發者。卡片聚合的是官方投影與 Host 掃描結果，不替代宿主自帶的「後臺任務」實時輸出面板——詳細日誌仍應到宿主面板查看。

安裝前建議瀏覽 GitHub 倉庫 源碼與 MIT 許可證。DSH 插件隨 當前 dsh 進程權限 運行；Client 會注入樣式、臨時修改內容區 padding-right 並在卸載時回收，Host 路由會讀取會話日誌。SkillHub 等社區目錄獨立於 DeepSeek / 幻方，並非官方應用商店。

結尾¶

dsh-status-card 把耗時、任務、目標、計劃、變更、子智能體和後臺任務固定到內容區右上角，減少在多個面板間來回切換。目錄與安裝入口：https://www.skillhub.cn/plugins/liuhusk/dsh-status-card；完整行爲表與實現說明見 https://github.com/liuhusk/dsh-status-card。