配置（插件 Config）

字段	默认	说明
`apiBaseUrl`	`https://api.deepseek.com`	余额接口基址（不用于模型调用）
`balanceCacheMs`	`60000`	余额缓存时长
`holidays`	`[]`	节假日北京日期名单（YYYY-MM-DD）；`holidays.json` 优先
`dataDir`	`$DSH_HOME/dsh-tidecost`	数据目录（旧 dsh-balance 自动迁移）

数据文件（均在 dataDir）：

文件	内容
`budget.json`	全局：`defaultSessionBudgetCny` / `monthlyBudgetCny` / `balanceWarnCny` / `warnThreshold`
`session-budgets.json`	`{ [sessionId]: 会话预算 }`（仅显式自定义过的会话）
`holidays.json`	节假日名单（优先于 Config，热更）
`usage-log.jsonl`	逐步用量流水（月结按调用时刻价格纪年重算）

旧版把会话预算写在全局 budget.json：首次加载会自动迁移为「默认会话预算」，老数据不丢。

HTTP API（同源，供面板使用）

端点	说明
`GET /dsh-tidecost/api/overview?session=`	面板快照：余额、会话逐步用量、预算、峰谷相位、节假日、预警
`GET /dsh-tidecost/api/balance?refresh=1`	余额（强制刷新）
`GET /dsh-tidecost/api/budget?session=`	该会话生效预算 + 全局项
`POST /dsh-tidecost/api/budget?session=`	保存：`sessionBudgetCny` 仅写该会话；`{resetSession:true}` 恢复默认；不带 `session` 则更新默认会话预算
`GET /dsh-tidecost/api/session//usage`	单会话逐步用量