前言¶
在 DSH web GUI 中運行智能體時，常希望快速看到當前會話還剩多久、已經消耗多少 token、按模型大約花費多少。已有做法多依賴會話日誌或零散統計，缺少一個集中的標題欄入口。dsh-task-estimator 把預計剩餘時間、token 用量與按模型花費估算放到會話標題欄中，並支持 LLM 智能估算。下面介紹它的功能、安裝與用法。
這是什麼¶
dsh-task-estimator 是 DSH 插件，由 0x250-t 維護，許可爲 MIT。它面向 DeepSeek Harness 的 web GUI，在會話標題欄提供一個任務估算窗口，用於查看預計剩餘時間、token 用量、按模型花費估算（約 CNY），以及可選的 LLM 估算。
核心功能¶
啓發式估算¶
基於會話投影（sessionStats、tokenUsage、goal）即時計算：
- 已用輪次
- token 用量
- 耗時
- 平均每輪
- 預計剩餘，採用近 5 輪趨勢外推並附置信區間
- 預計完成時刻
花費估算¶
按會話日誌重放 token 用量，並按「模型 × 時段」增量計價。時段包括 legacy、peak、offPeak，使用北京時間。
輸出包含：
- 彙總花費
- 按模型明細：模型、token、花費
價格表是內置參考值，可在設置中修改。legacy 檔下，峯谷倍率會自動派生。
AI 估算¶
使用會話當前模型做輕量補全，輸出：
- PERT 三點估算：樂觀、最可能、悲觀剩餘分鐘，以及期望值
- 剩餘輪數
- 剩餘 token
- 任務複雜度分檔：
XS~XL - METR 可靠性警告
本輪預計¶
當 agent 思考中，即出現「Deep diving…」狀態行時，會在該行右側顯示「本輪預計 ≈ X」。
該預估基於近 5 輪 LLM 耗時趨勢；趨勢不可用時取全程平均，用來估計當前這一輪對話所需時長。
交互¶
窗口支持以下交互：
- 懸停顯示
- 移開 0.3s 後，0.5s 線性淡出
- 點擊固定面板
- 再次點擊任意位置關閉
Alt+E切換- 觸屏自動降級
- 面板內點擊不退出
- 內容超高時可滾動
設置¶
設置區包括：
- 價格表編輯
- 刷新間隔自定義，單位爲分鐘，支持小數
- 恢復默認
- 固定狀態管理
- 價格生效日程
關於固定狀態是否寫入本地存儲，已覈實資料中存在不同表述：設置項曾提到 localStorage，隱私說明又稱全部狀態爲進程內存、無持久化。使用前應以當前版本實現和說明爲準。
安裝與啓用¶
它是 bundle 插件，安裝後需要重啓 web。已覈實安裝命令爲：
dsh plugin --profile web add github:0x250-t/dsh-task-estimator#v1.1.0
如果從本地目錄安裝，需要先構建，再添加：
cd dsh-task-estimator
npm run build
dsh plugin --profile web add .
已覈實資料中，安裝命令使用 #v1.1.0，而 package.json 版本爲 1.1.1。安裝前請以倉庫當前 README 和可用標籤爲準。
典型用法¶
1、懸停會話標題欄右側的估算按鈕，查看剩餘時間、token 與約花費明細。
2、點擊按鈕固定面板；再次點擊任意位置關閉。
3、展開「AI 估算」區塊，點擊「開始估算」；也可以設置自動刷新間隔。
4、展開「設置」區塊，編輯價格或刷新間隔後保存；需要還原時點擊「恢復默認」。
5、agent 思考中，即「Deep diving…」狀態行出現時，右側會顯示「本輪預計 ≈ X」，用於預估當前輪耗時。
適用場景與注意¶
- 適合使用 DSH web GUI 的開發者和用戶，尤其是希望快速查看會話 ETA、token 用量與模型花費估算的場景。
- 插件以當前 dsh 進程權限運行。安裝前檢查源碼、依賴、許可證和更新說明；本項目許可爲 MIT。
- 隱私說明稱：全部狀態爲進程內存，無 API key、密鑰、密碼硬編碼，無網絡外發；AI 估算除外，AI 估算會對已配置模型做一次調用。
- 花費估算基於價格表與時段規則，是估算值，不是賬單。價格表爲內置參考值，可按設置修改。
- AI 估算會調用當前會話模型，可能產生模型用量。
結尾¶
dsh-task-estimator 將剩餘時間、token 用量和按模型花費估算集中到 DSH 會話標題欄中，適合需要快速判斷任務進度與成本的用戶。
GitHub 地址：https://github.com/0x250-t/dsh-task-estimator
已覈實資料未提供目錄頁 URL。如通過社區目錄安裝，請以目錄頁給出的命令爲準。
