前言¶
DeepSeek Harness (DSH) 採用插件化架構。cost-ledger 插件負責記錄已經發生的支出，回答”已經花了多少”的問題。如果需要回答”照這個速度我這個月要花多少”或”預算什麼時候用完”，則需要額外的預測邏輯。dsh-plugin-spend-forecast 讀取 cost-ledger 的臺賬數據，提供日均速率、趨勢判斷、月末預測以及預算耗盡的具體日期。
核心功能¶
該插件主要提供以下能力：
* 雙窗日均與趨勢：對比短窗（默認 7 天）與長窗（默認 30 天）的日均花費，判斷趨勢（加速、減速或持平）。
* 本月月末預測：基於短窗速率預測本月剩餘天數的總花費。
* 預算耗盡日期：根據當前花費速率和剩餘預算，計算具體燒穿預算的日期。
* 按模型分解：分析短窗內主要模型（前 5 個）的花費佔比。
安裝與啓用¶
安裝步驟如下：
- 使用官方命令將插件添加到 profile：
dsh plugin --profile web add github:121212165/dsh-plugin-spend-forecast
該命令會通過 `pnpm` 自動下載並構建插件。
-
編輯配置文件
$DSH_HOME/profiles/web/cordis.patch.yml。將倉庫根目錄的cordis.patch.yml內容併入該文件。注意：不要直接追加，這會導致 YAML 解析錯誤（end of the stream or a document separator is expected）；應將條目放入同一個數組中。 -
重啓 dsh 客戶端與服務端。配置層與客戶端需要重啓才生效。
使用方法¶
在 DSH 界面或終端中輸入：
/forecast
該命令會輸出包含雙窗日均、趨勢判斷、月末預測、燒穿日期及模型分解的詳細信息。
注意事項與配置¶
- 前置依賴：需要
pnpm在系統 PATH 上。 - 數據源要求：必須在
cost-ledger中配置好價目，否則全月預測結果爲 0。 - 趨勢死區：當趨勢值在 0.8 到 1.25 之間時，系統不會判斷趨勢（避免將日常抖動誤判爲趨勢）。
- 幣種處理：幣種取自臺賬記錄，不進行跨幣種混算。
- 未驗證場景：跨月切換時的月末外推功能未經驗證（僅在本月內實測）。
配置項說明：
* windowDays：短窗回看天數（默認 7），用於計算日均和模型分解。
* longWindowDays：長窗回看天數（默認 30），用於計算趨勢基準線。
* budgetMajor：月度預算（整數單位），0 或負數視爲未設置。
生態關聯¶
該插件屬於 dsh-plugin-family，與 cost-ledger（記賬）和 price-aware（價目管理）協同工作。
