DeepSeek Harness (DSH) 採用插件化架構，允許用戶根據需求擴展功能。在長期運行智能體時，缺乏即時的任務反饋和精細的成本控制是常見痛點。dsh-task-notice 旨在通過 Web 界面通知、系統級橫幅提示以及多維度的消耗統計，解決任務進度不可見和成本覈算分散的問題。
插件簡介¶
- 核心定位：代理任務完工通知 + 頂部提示橫幅 + 按 Provider(Key)的 Token 消耗統計 + 價格編輯 + 使用分析
- 維護者：Haoxiang-Fant
- 類別：客戶端
- 版本：0.3.10
核心功能¶
1. 任務通知與提醒¶
插件在代理完成頂層會話的任務或目標時觸發通知。
* 完工通知：每次任務完成後，Web 界面右上角彈出 toast，並通過瀏覽器 Web Notifications API 向 Windows 系統發送橫幅通知（桌面右下角 + 操作中心）。通知內容包含本次消耗的 tokens（緩存輸入/緩外輸入/輸出/合計）及金額。
* 操作提醒：代理發起權限請求或提問時，同樣會觸發頁內彈窗 + 系統通知，引導用戶處理。
* 窗口切換提醒：單輪任務緩存輸入超過閾值（默認 20 萬 tokens，可調）時，任務完成後會提醒切換新對話，並支持一鍵生成 HANDOFF.md 開發交接文檔。設置路徑位於：頂部導航 → 工具箱 → 窗口切換提醒。
2. 消耗統計與分析¶
在“設置 → 任務通知與消耗”頁面中，數據展示統一遵循 K/M/B/T 進制規則。
* Token 消耗統計：按 Provider (Key) 歸集。支持 1 年/6 個月/3 個月/1 個月/15 天/1 周/24 小時/自定義 時間範圍篩選。數據維度包括緩存輸入、緩外輸入、輸出及調用次數。
* 使用分析：
* 消耗金額：餅圖展示模型金額佔比，懸停查看詳細數據。
* Token Plan 回本：顯示回本進度條及 1 Credit 兌換的 Tokens。支持重置當前週期（需 4 位驗證碼 + 兩次點擊確認）及撤回重置。
* 性價比：計算 1 元可兌換的 tokens 數量。
* 每日費用：微型日曆展示每日用量，下方列出最近 6 天的詳細消耗表。
3. 價格管理與編輯¶
- 價格編輯：支持按模型編輯價格。未激活自定義的模型默認按內置官方價格目錄計費（基於 2026-09 數據，包含 DeepSeek 峯谷檔）。
- 峯谷計價 v2：
- 支持逐日生效日（工作日/自定義星期/每天）和自定義時區（默認 UTC+8）。
- 峯時價格方式支持倍率或自定義。
- 規則按條件格式自上而下匹配，首個命中生效。
- 自定義倍率：支持 Provider 級別和模型級別的價格倍率調整。
- 舊賬目處理：0.1/0.2 版本記錄的舊消耗默認按低谷價計算金額，不會按峯時價回溯。
4. 界面與機制優化¶
- 頂部提示橫幅：常駐頁面頂部。
- 權限橫幅：未授權瀏覽器通知時，點擊即可一鍵索權。
- 價格橫幅：當前使用的模型無價格時，點擊直接彈出價格編輯彈窗，點擊“保存並確定”立即生效。
- 保存機制優化：設置頁採用草稿模式。更改先落本地草稿，界面即時生效。點擊保存按鈕、切換選項卡或退出設置頁時自動保存。直接退出設置頁時會詢問是否保留更改，超時（10秒）默認保留。
- 顯示名稱：優先取全局模型設置中的自定義顯示名（Provider 顯示名 + 模型顯示名）。
安裝與啓用¶
推薦使用 tarball 方式安裝，以避免 Windows 下路徑解析問題。
# 1. 在插件源碼目錄執行，生成 tarball
pnpm pack
# 2. 安裝插件
dsh plugin add <tarball 路徑>
安裝完成後需重啓 DSH（如 dsh web）以使依賴生效。
典型用法¶
- 啓用通知：進入插件設置頁，點擊「授權並開啓」以啓用系統通知。
- 設置價格：如果當前使用的模型未規定價格，頂部橫幅會提示，點擊即可進入價格編輯頁。
- 查看統計：在設置頁頂部導航切換至「消耗統計」或「使用分析」，查看 Token 使用情況和成本分佈。
注意事項¶
- 權限要求：需瀏覽器 Web Notifications API 權限。
- 數據歸屬：統計與分析中的“Key”指全局模型設置中的 Provider 路由，顯示名取自 Provider 的
displayName。 - 價格生效：點「保存價格」後，彙總卡片、統計金額及完工通知金額立即按新價格重算。
- 數據遷移：升級後首次啓動會自動執行舊價格配置的遷移腳本。
