DeepSeek 的计费采用峰谷分时策略，高峰时段价格翻倍。对于使用 DeepSeek Harness (DSH) 开发智能体的开发者来说，若不加控制，在高峰期运行大量任务会迅速增加成本。dsh-peak-gate 插件旨在解决这一问题，它通过代码层面的 hook，在高峰时段自动限制任务执行、压缩输出预算，并提供一键放行口令。
插件定位与维护者¶
- 名称：dsh-peak-gate
- 定位：DSH 主机端插件，负责在宿主侧根据时间规则拦截或调整请求。
- 维护者：CNyaotian-Lunar
- 许可：MIT
- 性质：社区自研插件，与 DeepSeek / DeepSeek Harness 官方无关
核心功能¶
插件主要在以下五个层面进行控制：
- 峰时拦重活：在
agent/pre-step钩子中拦截高耗时的任务步骤。 - 峰时工具预算：限制单轮工具调用的最大步数。
- 峰时压缩输出：强制将
maxTokens压缩到上限。 - 峰时精简输出：修改
systemPrompt，要求模型在高峰期减少废话输出。 - 一键放行口令：提供特定口令，可在高峰期强制放行特定请求。
安装与启用¶
该插件不通过插件市场安装，而是通过 Web Profile 的依赖挂载方式集成。请确保你的 DSH 版本在 0.1.7 以上。
- 放置源码
将插件源码文件夹dsh-peak-gate-src放入 Profile 的 vendor 目录：
<DSH_HOME>/profiles/web/vendor/dsh-peak-gate-src
- 修改配置
编辑<DSH_HOME>/profiles/web/package.json，在dependencies中添加本地链接，并在dsh.profile.bundles列表中加上dsh-peak-gate：
{
"dependencies": {
"dsh-peak-gate": "link:vendor/dsh-peak-gate-src"
},
"dsh.profile.bundles": [
"dsh-peak-gate"
]
}
-
执行与重启
运行pnpm install安装依赖，然后重启dsh web。 -
配置命名空间
在profiles/web/cordis.patch.yml中添加peak-gate命名空间配置。DSH 0.1.7+ 版本支持热改，无需重启即可生效。
计费逻辑¶
插件判定逻辑基于北京时间，采用“UTC+8 位移后读 UTC 字段”的方式，不依赖本机时区，因此不受夏令时影响。
根据 DeepSeek 官方定价规则：
| 时段（北京时间） | 价格 |
|---|---|
| 周一至周五 09:00–12:00、14:00–18:00 | 高峰 ×2 |
| 其余时间、周末全天、中国法定节假日全天 | 空闲 ×1 |
法定节假日自动日历¶
插件内置了一套完整的 2026 年中国法定节假日日历，并支持联网更新和本地缓存。
多层缓存与校验¶
- 联网源：默认从
NateScarlet/holiday-cn获取，按序尝试 jsDelivr、raw.githubusercontent、gh-proxy，仅拉取当年数据。 - 磁盘缓存：默认缓存至
<DSH_HOME>/data/peak-gate/holidays-cn.json，30 天内不重复拉取。联网失败时使用旧缓存并告警。 - 内置兜底：代码中包含
DEFAULT_HOLIDAYS，支持离线使用。 - 数据校验：单年放假日数必须在 15 ~ 45 天之间。缓存时间戳在未来时会被判定为损坏并重新拉取。
调休规则¶
根据官方 2026-09-19 的补充说明：
* 调休上班日按空闲计费：国家标定的补班日（如周六）无条件按空闲价计算，不恢复高峰价。
* 缓存合并：缓存中的 workdays 与内置的 DEFAULT_MAKEUP_DAYS 会合并进日历。
配置项¶
holidays：追加自定义日历（默认即内置表）。useBuiltinHolidays：是否合并内置表（收窄时设为 false）。autoHolidayCalendar：关闭联网。holidayCalendarUrls、holidayCacheMaxAgeDays、holidayFetchTimeoutMs、holidayCachePath。
⚠️ 注意：若想仅使用自定义日历，需同时设置
holidays: []、useBuiltinHolidays: false、autoHolidayCalendar: false。
适用场景与注意¶
- 适用场景：需要严格控制 DeepSeek API Token 花费，希望避免在高峰时段执行非关键任务的开发者。
- 运行环境：以当前 DSH 进程权限运行，需确保
schemastery和@deepseek-ai/dsh-llm依赖可用。 - 生态说明：DSH 理念为“一切皆插件”，本插件来自社区目录 SkillHub，与 DeepSeek 官方无从属关系。
