前言¶
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（价目管理）协同工作。
