dsh-opencode-go-eta：OpenCode Go 配額消耗與續費決策插件

前言¶

DeepSeek Harness（DSH）的插件生態採用「一切皆插件」的理念，讓開發者通過配置和擴展來定製工作流。在智能體開發中，資源配額管理是高頻場景，尤其是訂閱型產品往往只展示已用百分比和重置時間，但開發者更關心：按當前消耗速度，配額會在本月結束前耗盡嗎？耗盡後是續訂訂閱更划算，還是改用按量計費 API 更省錢？

hugoou/dsh-opencode-go-eta 就是爲了回答這個問題。它在 DSH 的 composer dock 中提供一個膠囊，展示配額消耗歷史、預測耗盡時間（ETA）、與續費日期的對比，以及續訂與溢出計費的成本建議。它不讀取會話日誌，而是通過官方接口採樣，只保留配額讀數與定價緩存，遵循 DSH 的隱私與權限設計。

是什麼¶

這是一個爲 DeepSeek Harness 設計的 OpenCode Go 配額預測組件。它維護本地歷史採樣記錄，使用 Theil–Sen 迴歸計算當前週期的預測耗盡時間，並與訂閱的 endsAt 對比，給出三種結論：耗盡在續費前、耗盡在續費後、當前週期內安全。當預測耗盡發生在續費日期之前，它會對比續訂 OpenCode Go 與使用官方 API 支付溢出部分的費用，推薦更經濟的方案。該插件運行在 DSH 進程內，不直接暴露 API 密鑰，通過 Harness 的憑證服務解析。

插件由 HugoOu 維護，歸類爲「聯網工具」。它依賴 DeepSeek Harness 0.2.x（桌面或 Web profile）以及 Node.js ≥ 22。

核心功能¶

1. 預測耗盡時間（ETA）¶

插件每天在固定時間錨點（本地 03:00、09:00、15:00、21:00）、任務結束、啓動時以及按需採樣官方配額接口，獲取已用百分比與重置時間。採樣記錄保留 45 天，用於計算當前週期的趨勢。它使用重置感知的 Theil–Sen 迴歸擬合當前週期的斜率，給出預測耗盡時間與置信層級。如果當前週期有效樣本少於 3 個或跨度不足 6 小時，會報告樣本不足，不給出預測。

2. 續費日期對比¶

插件將預測的耗盡時間與訂閱的 endsAt 對齊，輸出三種狀態：耗盡在續費前、耗盡在續費後、當前週期內安全。這幫助開發者決定是否需要提前續費、切換到按量計費，或繼續使用訂閱。

3. 成本建議¶

當預測耗盡在續費日期之前時，插件會計算溢出量：(預測在續費時的百分比 − 100%) × 模型的月度配額金額。它對比兩種方案的成本：續訂 OpenCode Go 的費用（planPriceUsd）與使用官方 API 支付溢出部分的費用（基於當前模型的公開價格）。插件會推薦更經濟的選項，並說明兩種路徑的費用差異。

4. 合併圖表與膠囊¶

在 composer dock 中，膠囊採用 14px 直徑與 2px 環的視覺規格，與 DSH 原生的上下文環保持一致，作爲文本觸發器。點擊膠囊會展開卡片，其中包含歷史採樣、當前點、預測線、ETA 標記與續費標記，並以 0–100% 爲軸繪製。卡片在深色模式下會自動調整高亮層的透明度，適配不同主題。

5. 按模型配額與貨幣單位¶

OpenCode Go 的月度配額是按模型區分的（例如 DeepSeek V4.1 Flash 在 Go 計劃中爲 $80，在 Go Plus 中爲 $160；Kimi K3 爲 $15）。插件在卡片上顯示模型與該模型的配額金額，而百分比始終以官方控制台的數值爲準。貨幣單位與配額金額基於用戶配置，用於成本建議計算。

6. 無輪詢風暴¶

插件通過時間錨點與任務結束、啓動等事件觸發採樣，避免高頻輪詢。默認錨點爲本地 03:00、09:00、15:00、21:00，可通過配置禁用定時採樣。採樣間隔與數據新鮮度閾值（staleAfterMs）可調，保證數據時效性與系統負載的平衡。

安裝與啓用¶

插件需要 DeepSeek Harness 0.2.x（桌面或 Web profile）以及 Node.js ≥ 22。安裝後需完全重啓 DSH 才能生效。

# 從 GitHub 安裝
dsh plugin --profile desktop add github:HugoOu/dsh-opencode-go-eta

# 或從本地檢出安裝
dsh plugin --profile desktop add link:C:\path\to\dsh-opencode-go-eta

安裝後，膠囊會出現在 composer dock 下方。點擊膠囊可查看卡片。

配置說明¶

插件默認配置存儲在 cordis.patch.yml 中，可通過在用戶 profile 中添加配置來覆蓋默認值：

- id: opencode-go-eta
  name: dsh-opencode-go-eta
  config:
    apiKeyRef: OPENCODE_GO_API_KEY   # 憑證引用，而非密鑰本身
    anchors: [3, 9, 15, 21]          # 本地小時數；[] 禁用定時採樣
    sampleIntervalMs: 1200000        # 兩次隱式採樣之間的最小間隔
    staleAfterMs: 2700000            # 超過此時間未採樣的讀取會觸發新採樣
    retentionDays: 45                # 採樣記錄保留天數
    planName: Go                     # 卡片上顯示的計劃名稱
    planPriceUsd: 10                 # 單期價格，用於成本建議
    modelLabel: DeepSeek V4.1 Flash
    modelAllowancesUsd:
      deepseek-v4.1-flash: 80        # Go 表格中的月度配額；Go Plus 用 160
    pricingModel: deepseek-v4.1-flash
    pricingUrl: https://models.dev/api.json
    pricingTtlMs: 43200000

API 密鑰通過 Harness 憑證服務解析（OPENCODE_GO_API_KEY），不會直接傳遞到瀏覽器。

工作原理¶

插件按階段處理採樣、歷史、預測、判定與建議：

階段	行爲
採樣	在 03/09/15/21 本地時間、任務結束、啓動時，按需調用 `GET /zen/go/v1/usage`（獲取百分比與重置）和 `GET /console/api/go/status`（獲取計費週期起止、計費器等）。
歷史	採樣記錄保存在 `$DSH_HOME/opencode-go-eta/samples.json`，採用原子寫入，保留 45 天。
預測	只使用當前週期內的採樣點，計算 Theil–Sen 斜率作爲耗盡趨勢。若有效樣本少於 3 個或跨度不足 6 小時，報告樣本不足。
判定	將預測耗盡時間與窗口重置時間及訂閱的 `endsAt` 對比，給出「耗盡在續費前」「耗盡在續費後」「當前週期內安全」三種結論。
建議	計算溢出金額（`(預測在續費時的百分比 − 100%) × 模型月度配額`），對比續訂成本（`planPriceUsd`）與按量計費成本（溢出量 × 官方價格），推薦更經濟的路徑。

注意：官方控制台的計費器爲計劃信用上限（觀察到 $60），而官方 Go 表格列出了按模型的月度配額（如 DeepSeek V4.1 Flash 爲 $80）。插件中百分比始終以控制台數值爲準，貨幣與配額金額基於模型配額，兩者互不矛盾。

適用場景與注意¶

該插件適合在以下場景中使用：需要持續監控訂閱型配額消耗、希望提前規劃續費或切換計費方式、關注不同模型的配額差異與成本結構。它特別適合有多模型使用習慣的開發者，因爲配額是按模型區分的，插件可以針對每個模型展示不同的配額與建議。

使用時需注意：插件運行在 DSH 進程內，需確保 DSH 有權訪問官方配額接口；如果官方接口變更（例如 /console/api/go/status 改變），卡片將降級爲僅顯示百分比；預測是線性外推，不代表廠商的官方預測；成本建議假設配額計費器與官方價格在同一量綱上，且 token 估算爲近似值；插件不存儲提示或會話數據，僅保留配額讀數與定價緩存。

短結尾¶

dsh-opencode-go-eta 在 DSH composer dock 中提供了一個輕量、隱私友好的配額監控入口，幫助開發者從被動查看百分比轉變爲主動規劃資源消耗與成本。它通過本地採樣與 Theil–Sen 迴歸，給出基於歷史數據的耗盡預測與續費建議，適合需要精細管理訂閱型配額的開發者。

目錄頁：https://www.skillhub.cn/plugins/HugoOu/dsh-opencode-go-eta
GitHub：https://github.com/HugoOu/dsh-opencode-go-eta