前言¶

DSH 的理念是「一切皆插件」。當一個工作區裏同時開着多個會話、每個會話下面還掛着若干子代理時，靠反覆翻列表很難快速判定：哪些會話在等我處理，哪些還在跑，哪些剛結束，這段時間 Token 花了多少。dsh-plugin-task-radar（維護者 hualidan42-beep）把這件事做成一個可拖動、可摺疊的浮窗，外加一塊主區工作面板。下面介紹它的定位、功能、安裝與使用方式。

這是什麼¶

一句話定位：面向 DSH Web 的客戶端插件，按工作區歸堆展示會話狀態、子代理、待辦與 Token 用量，點一下直達對應會話。

維護者：hualidan42-beep。分類：客戶端。星標：0。當前包版本以 package.json 爲準，爲 0.10.0。它解決的問題是：DSH 原生界面沒有專門面向「多會話並行 + 子代理 + Token 觀察」的狀態面板，開發者需要自己在會話之間來回切換，才能拼出進度和用量。

核心功能¶

先列出插件已經實現的能力：

• 按工作區查看會話，狀態分爲四類：等你處理、正在運行、剛完成、空閒。
• 展示待辦清單、子代理、模型標籤和 Token 用量，點擊條目直達會話。
• 本地記錄今天、本週、本月的 Token 增量；首次觀察只建立基線，不回補歷史用量。
• 可選系統通知、浮窗外觀與主題插畫，首次安裝默認「桂花月兔」。
• 邊框粗細（0–3px）與顏色可調，默認跟隨主題，可一鍵恢復默認。
• 框體尺寸拖右下角把手即可調整，範圍 240–560 × 160–760，雙擊復位。
• 干擾控制：對單條會話靜音 1 小時、「我認這活做完了」一鍵收工、今天不再彈系統通知。
• 可選聯動 dsh-plugin-skin；未安裝該皮膚插件時，任務監控和浮窗外觀仍可獨立使用。

安裝與啓用¶

安裝分兩步：先加索引源，再從市場點安裝。

1、打開 DSH 的「插件 → 實驗性插件 → 更多」，啓用「自定義插件市場」。

2、進入「發現 → 管理索引源」，添加下面這個作者自己的索引地址：

https://raw.githubusercontent.com/hualidan42-beep/dsh-plugin-task-radar/main/market-index.json

需要說明的是：這只是作者的自定義索引，不是 DSH 官方市場。索引裏的每個版本都指向 npm 上的精確版本號，並記錄真實發布時間。

3、在市場裏找到「工作小管家」點擊安裝。也可以直接裝 npm 包：

dsh plugin --profile <你的-profile> add "dsh-plugin-task-radar@0.10.0"

安裝 bundle 後默認選中啓用，是否需要刷新或重啓以宿主提示爲準。不需要手工建立 junction，也不需要覆蓋 profile 文件。

啓用之後怎麼用¶

安裝完成後，浮窗默認出現在界面上。常用的操作集中在三件事上。

第一是看狀態和改外觀。會話按工作區歸堆，點開可以看到子代理、模型標籤與 Token 用量。拖右下角把手可改框體大小，雙擊復位；邊框顏色與粗細在外觀設置裏調整。

第二是加干擾控制。某條會話暫時不需要提醒，就對它靜音 1 小時；某個任務已確認完成，用「我認這活做完了」收工；今天不想再彈系統通知，就開啓免打擾。

第三是看 Token 流水。主區面板提供今天/本週/本月的增量視圖。插件只記錄開始觀察之後的變化，不做歷史回算，所以首次使用時數字會從零基線起步，需要觀察一段時間纔有參考價值。

數據與權限¶

插件讀取的都是宿主已經下發的數據：工作區、會話狀態、待辦、子代理和 Token 投影。它不註冊 Host 路由，不寫業務目錄，不調用模型，也不主動把會話數據上傳到外部服務。

本地側的設置和記錄存放在瀏覽器 localStorage 的 dsh-plugin-task-radar/v1 鍵下，包括浮窗位置、外觀、已讀與計時記錄、用量流水。系統通知需要用戶手動授權，通知內容裏可能出現會話標題。

需要注意兩點：清除當前瀏覽器的站點數據會一併清掉插件記錄，卸載插件不會自動刪除這些瀏覽器數據。Token 流水只是觀察記錄，不是賬單。

適用場景與注意¶

適合的對象：主要面向使用 DSH Web、同時維護多個會話與子代理的開發者，希望有一個常駐浮窗做進度與用量觀察。倉庫的驗證命令 npm run verify 和 npm pack --dry-run --ignore-scripts 需要 Node.js >= 18，但用戶側安裝不要求本機裝 Node。

已知限制按 README 列示如下：

• 僅中文界面，面向 DSH Web，需要現代瀏覽器支持 relative color、color-mix 等 CSS。
• 尚未宣稱對特定 DSH 版本範圍的兼容保證，也未在乾淨 profile 中完成安裝驗收。
• 父會話計時從插件開始觀察時算起；待辦內容由代理維護，不保證結束時全部勾選。
• Token 明細保留最多 400 天，採用本地時區；清除緩存或更換瀏覽器不繼承。
• 缺少宿主投影時，相關明細可能不顯示。

安裝前建議：插件以當前 dsh 進程的權限運行，安裝前應檢查源碼與許可證。包配置裏聲明 MIT，但該聲明針對作者有權授權的代碼，第三方素材或角色的權利仍屬於各自權利人。倉庫不包含開發機工作區和業務數據，圖片已內嵌在 client.js 中。

小結¶

這個插件的價值在於把散落的會話進度和用量信息收進一個可拖動、可摺疊的浮窗，減少在多個會話之間來回切換的成本。它不替代 DSH 原生列表，更像一個常駐在手邊的觀察面板。

目錄頁：https://www.skillhub.cn/plugins/hualidan42-beep/dsh-plugin-task-radar

倉庫：https://github.com/hualidan42-beep/dsh-plugin-task-radar