Zum Hauptinhalt springen
Q

dsh-night-shift

qinghuidaqzp/dsh-night-shift

Queue non-urgent tasks during the day in a right-sidebar tab, run them automatically in fresh sessions during DeepSeek's off-peak half-price window (configurable Beijing start time outside weekday peak hours, serial or bounded concurrency), and read a morning report with per-task status, changed files, commands run, token cost, savings versus peak hours, and steps skipped because they required user approval.

Installation

dsh plugin --profile web add github:qinghuidaqzp/dsh-night-shift

README

dsh-night-shift · 夜班鲸

English | 中文

DeepSeek Harness(dsh)右侧栏插件:白天派活,夜里半价干,早上看汇报。

白天把不急的任务(补单测、整理文档、排查日志、跑脚本检查……)随手丢进「夜班鲸」清单;到了 DeepSeek 空闲半价时段(默认北京时间 00:30,避开高峰双倍价),插件自动为每个任务开一个独立新会话按顺序执行;第二天早上打开右侧栏的晨报,一眼看清哪些做完了、改了哪些文件、跑了哪些命令、花了多少钱、比白天高峰省了多少,以及哪一步因为需要人工确认而跳过。

夜班鲸在 dsh 右侧栏里

截图来自测试环境:使用本地 DeepSeek 替身(test/mockseek.mjs)和模拟审批拦截插件(test/fixtures/approval-gate.mjs),在真实 dsh --profile web 中通过右侧栏加入并执行两个任务,同时预置了一条 00:30 空闲时段的持久化记录用于验证重启恢复与峰谷省钱展示。

两个视图

夜班队列晨报
夜班队列晨报
  • 夜班队列:
    • 随手写下指令、可选短标题,并选择工作区或自定义目录路径。
    • 支持对排队中的任务编辑、移除、单个立即跑,或一键立即开始跑完整个队列。
    • 排班设置:可开关自动夜班、自定义北京时间开干时间(自动拦截高峰时段 09:00–12:00 与 14:00–18:00)、设置并发数(1–4,默认串行 1)、勾选「天亮进入高峰前暂停派发剩余任务」以及单任务超时分钟数。
  • 晨报:
    • 顶部汇总卡片:比高峰省下多少钱、完成数、实际花费、需确认跳过步数,以及总改动文件数、命令数与 token/缓存命中。
    • 每个任务一张结果卡:状态(已完成 / 失败 / 卡住或超时 / 已取消)、摘要、改动文件(在 git 仓库中附带 +增/-删 行数)、执行命令(带成功/失败标记)、token 与费用明细、需人工确认而跳过的步骤列表,并支持一键打开会话跳转到对应对话。

无人值守与安全边界

夜班鲸绝不绕过 dsh 的沙箱或审批策略,也绝不会把任何审批决定改成放行。

  • 默认情况下,夜班鲸为每个新开的夜班会话写入 dsh 自带的 approval/policy: never(无交互拒绝模式):
    • 沙箱内允许的操作(如工作区内读写文件、常规测试命令)照常执行。
    • 任何触发人工审批的操作(越权命令、敏感工具、第三方审批插件返回 ask)都会立即被 dsh 拒绝,既不会擅自放行,也不会因为夜里留着浏览器标签页而整晚卡死在确认框。
    • 所有被拒绝的步骤都会记录在晨报的橙色提醒区,写明具体工具/命令与原因,方便早上人工核对后决定是否补跑。
  • 如果你在配置里把 unattendedApprovalPolicy 改成 ask,则会沿用 dsh 默认的询问流程(无浏览器连接时 fail-closed 拒绝;有浏览器连接但无人点击时等待至单任务超时后自动中止并标为「卡住 / 超时」)。

实现方式

插件由 Host 与 Web 两半组成:

  • 会话创建与调度:使用 ctx.sessionController.create()(无 Web 控制器时回退到 ctx.agents.create())为每个任务创建独立新会话,并调用 sessionTitle.rename() 加上 🌙 前缀,通过 agent.followup() + ctx.sessions.flush() 投递指令,使用 agent.whenIdle() 等待完成并按配置的并发数推进队列。队列、排班设置与晨报持久化保存在 dshHomePath('night-shift', 'state.json'),重启后保留;重启时若仍有运行中的任务会自动转入晨报标记为中断。
  • 只读旁观钩子(仅作用于夜班会话):
    • llm/stream:读取每次模型调用的 usage 块(含缓存命中/未命中与输出 token),结合 DeepSeek 峰谷价计算实际花费与相对高峰期的节省金额。
    • tools/pre-execute / tools/result:只读旁观工具调用(pre-execute 始终原样 next()),记录执行的命令与修改的文件。
    • session/event:监听 tool/call、approval/asked、approval/decided、assistant/message、workspace/changes、turn/end,将审批拒绝、最终摘要与 git 变更行数汇总到晨报。

价格说明

内置 DeepSeek 官方价格(2026-11-19 在 api-docs.deepseek.com 核对,单位:元 / 百万 token,空闲时段):

模型缓存命中输入缓存未命中输入输出
deepseek-flash0.0214
deepseek-v4-pro0.154.513.5

工作日 09:00–12:00、14:00–18:00(北京时间)为高峰时段,价格翻倍(2×);其余时段与周末为空闲半价。法定节假日未单独建模。可在插件配置 prices 中自定义价格。

安装

需要 dsh >= 0.2.0,在 0.2.2-rc.1 上实测通过。

dsh plugin --profile web add github:qinghuidaqzp/dsh-night-shift

安装后重启 dsh,打开右侧栏选择 夜班鲸。

配置

- id: night-shift
  config:
    startTime: "00:30"                # 默认夜班开干时间(北京时间,须为空闲时段)
    concurrency: 1                    # 同时运行的任务数(1-4)
    stopBeforePeak: true              # 进入高峰前暂停派发剩余任务
    taskTimeoutMinutes: 30            # 单任务最长运行分钟数
    unattendedApprovalPolicy: never   # never(推荐,自动拒绝)或 ask
    peakPricing: true                 # 按峰谷价计算花费与节省
    prices: []                        # 留空使用内置 DeepSeek 官方价格
键默认值说明
stateFiledsh 主目录下 night-shift/state.json队列与晨报持久化路径;留空则仅存内存
startTime00:30默认开干时间(北京时间 HH:MM,不可落入高峰时段)
concurrency1并发执行的夜班任务数(1–4)
stopBeforePeaktrue进入高峰时段后不再派发队列中剩余任务
taskTimeoutMinutes30单任务超时自动中止时间(分钟)
unattendedApprovalPolicynever夜班会话的审批策略(never 或 ask)
peakPricingtrue是否启用峰谷价计算
prices[]自定义模型价格表(空闲时段,元 / 百万 token)

局限与实测说明

  • 夜间必须保持 dsh 运行:定时器运行在 dsh Host 进程内,如果电脑休眠或退出 dsh,当晚任务不会在关机期间执行。
  • 已验证的部分:纯逻辑单测(峰谷价计算、北京时间排班校验、工具与审批解析、状态持久化与崩溃恢复)、真实 dsh 0.2.2-rc.1 集成测试(独立新会话创建、文件写入、命令执行、审批拦截记录)、Web UI 端到端测试(添加任务、高峰时间校验、立即开始、晨报渲染、点击「打开会话」跳转)。
  • 未实测的部分:未进行跨夜真实的操作系统休眠/唤醒长时跑测,也未使用真实付费 DeepSeek API Key 跑过真实过夜任务;法定节假日调休未建模。
  • 界面仅在 Web / 桌面端右侧栏提供。

开发与测试

npm install
npm test

端到端集成测试使用真实 dsh 搭配本地 test/mockseek.mjs 和 test/fixtures/approval-gate.mjs(无需 API Key):

DSH_BIN=$(which dsh) node test/integration/run.mjs

License

MIT

Ähnliche Plugins