前言¶
在 DeepSeek Harness (DSH) 中开发智能体时，频繁调用 API 会导致成本上升。如果在 API 费用较高的时段（峰段）进行大量计算，成本会显著增加。dsh-peak-valley-queue 插件通过拦截输入，将消息放入任务队列，并在低费率时段（谷段）自动按序执行，从而帮助开发者压低 API 调用成本。
核心功能¶
该插件主要解决“按需执行”与“成本控制”的问题，具备以下能力：
- 输入拦截与队列化：输入框左侧提供开关，开启后聊天消息不再直接发送，而是进入任务队列；关闭后消息直发。
- 谷段自动调度：队列按序（FIFO）派发，仅在谷段（DeepSeek 官方定义的低费率时段）且距下一峰段超过配置分钟数时自动执行。
- 峰谷倒计时：面板实时显示距下一峰段（谷段显示）或距下一谷段（峰段显示）的时间。
- 灵活的峰段配置：默认支持工作日 09:00–12:00 / 14:00–18:00 为峰段。支持增删时段（支持重叠）、设置周末是否算峰段、指定时区。清空列表则全天为谷段。
- 队列管理：支持在面板中添加任务、编辑、删除、拖拽排序、合并相邻任务、手动“送出”以及执行中任务的“强制完成”。
- 精确的完成判定：采用冗余多信号机制（turn/end、agent/status、watchdog、客户端轮询），将任务状态精确划分为 4 种：已完成、被打断、失败、阻塞。
- 待确认任务集成：与
dsh-todo-enhancer配合，检测到<!-- dsh-todo:start -->标记时，任务转为“待确认”并暂停队列，等待用户决策。 - 失败暂停与恢复：任务失败或被打断时队列暂停，并通过浏览器通知提醒。点击“继续任务”可恢复队列并重排。
- 严格校验（可选）：派发时可注入约定，要求回复末尾输出
__TASK_DONE__，未检测到则视为未完成。 - 多会话独立：每个会话（含不同工作区）拥有独立的开关、队列与持久化数据，互不干扰。
- 本地持久化：队列与配置存储在 DSH 数据目录
~/.dsh/peak-valley-queue/（优先$DSH_HOME），绝不写入用户工作区文件。
安装与启用¶
必须通过一条命令同时安装两个插件：dsh-peak-valley-queue（核心排队逻辑）和 dsh-todo-enhancer（决策清单面板）。安装后必须重启 DSH 服务才能加载 bundle 层。
dsh plugin --profile web add github:EmptyCollin/dsh-peak-valley-queue github:EmptyCollin/dsh-todo-enhancer
安装完成后：
1. 重启 DSH 服务：这是加载 bundle 层的必要步骤。
2. 刷新浏览器：重新拉取插件清单。
3. 配置依赖：若需使用“待确认”功能，确保已安装 dsh-todo-enhancer 并正确加载。
离线或本地开发时，可使用本地路径安装，效果相同。
典型用法¶
- 谷段批量处理：将非紧急任务（如批量改写、巡检清单、报表生成）攒到谷段统一执行，享受低费率。
- 峰段自动排队：工作日上午/下午高峰时段开启排队，谷段一到自动按序执行，无需人工值守。
- 手动干预与兜底：在面板中手动添加任务、拖拽排序或强制完成处于异常状态的任务。
- 严格模式：开启严格校验，要求回复末尾输出
__TASK_DONE__，确保任务执行结果被正确捕获。
适用场景与注意¶
- 适用场景：适合批量处理任务、需要串行执行的任务、或对 API 成本敏感的场景。
- 不适用场景：不适合需要立即回复的实时对话、高峰期的紧急任务、强交互式调试流程。
- 重要提示：
- 消息入队后不会直接出现在聊天区，需等待执行。
- 仅支持从 GitHub 安装或本地路径安装。
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
总结¶
dsh-peak-valley-queue 为 DeepSeek Harness 提供了一套完整的峰谷定价时段任务管理方案。通过本地持久化、多会话隔离以及精细的完成判定，它帮助开发者在保证任务顺序和安全性的前提下，有效降低 API 调用成本。
