dsh-nightwatch

dsh-nightwatch — 让对话一直跑到某个钟点，然后自己停

Keep a DeepSeek Harness session working until a wall-clock deadline, then stop. One button in the composer, nothing to type.

给 DSH 的输入框加一颗「☽ 守夜」按钮：点一下选个截止时间，之后每轮答完就自动接一句「继续」， 一直跑到点为止；到点不再开口。适合「去睡觉，让它自己干活到早上」这种场景。

这个插件只有按钮，没有指令。 开关、改时间、立刻停、看还剩多久，全在那一颗按钮和它的卡片里； 不需要记任何语法，也不会在对话流里留下任何东西。

用法（按钮）

输入框左下角有一排小按钮（在「完全权限」右边、和「↻ 迭代」并排），里面那颗 ☽ 守夜 就是它。

1. 点 ☽ 守夜 → 弹出一张小卡片；
2. 六个快捷选项任点一个：+30 分 / +1 小时 / +2 小时 / 今晚 23:00 / 明早 7:00 / +8 小时； 或者在最下面的输入框里自己填一个时间（写法见下表），回车即可；
3. 点「开始守夜」。

开起来之后：

• 按钮变成 ☽ 守夜 · 3h20m，那个数字每秒自己减，不用等刷新；
• 再点一次卡片，顶部显示「守夜进行中 · 还剩 … · 已接 N 轮」，可以改时间（按钮变成「改到」） 或者点红色的「立刻停」；
• 最后 10 分钟按钮会变成「快到点了，正在收尾」的语气（见下）。

按钮上没有任何文字提示你是「第一次用」——它就是一颗常驻的小药丸，安静地待在那儿。 万一宿主那一半没挂上，按钮会变灰并写明原因（「宿主未挂载」/「会话未加载」），旁边一颗「重试」。

没有指令

这个插件默认不注册任何 slash 指令。所有操作都在按钮卡片里：

想做的事	怎么做
开起来	点 ☽ 守夜 → 点一个快捷项，或自己填时间 → 「开始守夜」
看还剩多久、接了轮	药丸上的数字本身就在倒计时；点开卡片还有一行完整状态
改到别的时间	点开卡片 → 选新的时间 → 按钮上的「改到」
立刻停	点开卡片 → 红色「立刻停」

enableCommand: true 会额外注册 /nightwatch（以及 1.1.0 的旧名 /run-until）， 只给没有按钮的场景用——无头会话、脚本、远程 shell。装了它就有两套界面同时存在， 所以默认关掉。开启后的写法：

写法	含义
/nightwatch 22:30	跑到今晚 22:30（如果现在已经过了 22:30，就是明天 22:30）
/nightwatch +90m	再跑 90 分钟
/nightwatch 明天 07:00	明早 7:00（也接受 07:00 明天）
/nightwatch 2026-10-30 06:00	指定日期时间
/nightwatch	查看当前状态
/nightwatch stop	立刻停（也接受 停 / 取消 / off / clear）

支持全角冒号 22：30，也支持 7:05 这种不补零的写法。按钮卡片里的输入框认的是同一套写法。

安装

本插件按 DSH 的「本地 bundle」方式装载：在你的 profile 目录里加一条依赖 + 一条 bundle 引用。

从 npm 装（推荐）

已发布在 npm：https://www.npmjs.com/package/dsh-nightwatch

# profile 目录就是 ~/.dsh/profiles/<你的 profile>
cd ~/.dsh/profiles/<你的 profile>
npm i dsh-nightwatch

然后在同一个 package.json 的 dsh.profile.bundles 末尾加一项：

{
  "dependencies": { "dsh-nightwatch": "^1.2.2" },
  "dsh": { "profile": { "bundles": ["…原有的不要动…", "dsh-nightwatch"] } }
}

npm i 会把包放进 node_modules/dsh-nightwatch，不需要再建 junction。

从源码装（想改代码时用这个）

git clone https://github.com/Zci514/dsh-nightwatch.git D:/dsh/dsh-nightwatch

# Windows：把 profile 指向源码目录
cmd //c "mklink /J \"%USERPROFILE%\.dsh\profiles\node_modules\dsh-nightwatch\" D:\dsh\dsh-nightwatch"
# macOS / Linux：
ln -s /path/to/dsh-nightwatch ~/.dsh/profiles/node_modules/dsh-nightwatch

dependencies 里写 "dsh-nightwatch": "file:D:/dsh/dsh-nightwatch"，bundles 同样追加一项。

无论哪种装法，bundles 数组的顺序都是加载顺序，把 dsh-nightwatch 追加到最后即可。

从 1.1.0（@local/dsh-run-until）升上来

1. 目录/仓库名从 dsh-run-until 改成 dsh-nightwatch，插件名也去掉了 @local 作用域；
2. profile 里 @local/dsh-run-until 的三处引用（bundles 数组、dependencies、pnpm-lock.yaml） 全部换成 dsh-nightwatch，并把 profiles/node_modules/@local/dsh-run-until 的目录联接 改建到 profiles/node_modules/dsh-nightwatch；
3. 状态文件从 $DSH_HOME/run-until.json 换成 $DSH_HOME/nightwatch.json。 正在跑的守夜不会丢：启动时若新文件为空，会读一次旧文件并把记录搬过去； 旧文件保留不删，回滚到 1.1.0 时它还在自己该在的地方。

它到底做了什么

每一轮回答结束后（turn/end），插件检查一次：

1. 没开守夜 / 已停用 / 已到点 / 轮次用完 → 什么都不做；
2. 会话里还有你没处理的消息排队 → 让给你的消息，不插嘴；
3. 距离上一轮不到 1.5 秒 → 等一下，避免空转；
4. 否则发一条 source.kind = 'cordis-host-runner' 的用户消息，内容是「继续，现在是几点，距离几点还有多久」。

这条消息不是以你的身份发的（source.kind 不是 'user'），所以自动循环不会替你去批准自己的操作请求。

另外有一个后台心跳（默认 20 秒一次）兜底：如果某一轮结束时钩子没跑成（比如正好在重启， 或者那一轮被另一个插件接管），心跳发现会话空着且守夜还没到点，会补一句， 保证不会因为一次意外就整夜停摆。

快到点时它会收尾

默认最后 10 分钟（wrapUpMinutes）会换成收尾语气：

「快到点了，把手上这件事做到一个能交代的状态，写下还差什么、下一步从哪接着做，不要再开新的大动作。」 这样 22:30 停下来的时候，你回来看到的是一份能接手的现场，而不是半截活。

什么时候会停

停止条件	说明
到点	主功能。到点后不再发新消息
轮次上限	默认 400 轮（maxRounds），防止无限烧 token；0 表示不限
连续出错	默认连续 3 轮报错就停（maxConsecutiveErrors），避免死循环刷错误
连续没动手	默认连续 4 轮一个工具都没调就停（maxIdleRounds）——模型只回「好的」不动手时，每轮都白烧一整个上下文
你手动中止	在按钮卡片里点「立刻停」，立即停
会话被删除	记录一并清掉

到点时会话正在跑的那一轮不会被强行掐断（graceMs: 0 的默认含义是「只是不再开新轮」）， 它会自然答完，然后安静下来。

停掉的记录会在内存里留 10 分钟（好让「已续跑 N 轮」还能报出来），然后被扫掉 —— 一个常开的 DSH 不会因为开关过多少会话就攒下多少条记录。

重启后还在吗

在。守夜记录写在 $DSH_HOME/nightwatch.json（默认即 ~/.dsh/nightwatch.json）：

{ "version": 1, "armings": { "session-…": { "deadline": 1793225466992, "armedAt": 1793225346992, "rounds": 5 } } }

写入是先写 .tmp 再改名的原子替换，所以断电/崩溃不会留下半截文件 （半截文件会被读成「什么都没开」，等于把守夜悄悄丢掉）。

重启 DSH 后，只要截止时间还没过、那个会话还在，插件会自动认领并接着跑。 过期的记录会被自动丢掉，不会拿一个昨天的时间去骚扰你。

（前提是重启后那个会话被加载出来——DSH 重启后不会立刻把所有历史会话都实例化， 打开那个会话、或在里面说一句话，它就会被认领并继续。）

配置

改 cordis.patch.yml 里 nightwatch 那段，或在你自己的 profile patch 里覆盖：

键	默认	范围	作用
enabled	true	布尔	总开关。关掉后按钮还在，但不会续跑
enableCommand	false	布尔	是否额外注册 /nightwatch 指令。给无头会话/脚本用；GUI 里装了就有两套界面
minIntervalMs	1500	0–600000	两轮之间最少间隔，防空转
maxRounds	400	0–100000	最多替你说几次；0 = 不限
maxIdleRounds	4	0–100	连续几轮没调工具就收手；0 = 不检查
maxConsecutiveErrors	3	1–100	连续几轮出错就收手
heartbeatMs	20000	2000–300000	心跳间隔（下限 2 秒）
armKickDelayMs	20000	0–600000	开启后先等这么久再补第一句，避免和你正在说的话抢
wrapUpMinutes	10	0–240	到点前多久切收尾语气；0 = 不切。实际窗口最多是剩余时间的一半，免得十分钟的默认值把五分钟的守夜整段吃掉
graceMs	0	0–3600000	到点后还允许在跑的那轮继续多久，超时才强制中断
skipTruncatedTurnEnd	true	布尔	输出被截断时让给 continue-on-limit 插件，由心跳兜底
continueText	见 lib/policy.js	1–4000 字符	续跑文案，支持 {now} {deadline} {left}
wrapUpText	见 lib/policy.js	1–4000 字符	收尾文案

与 continue-on-limit 的分工

dsh-plugin-continue-on-limit 只在输出被截断（turn/end 的 reason.kind === 'max-tokens'） 时补一句「继续」，它跟时间无关，不会让对话跑一整夜。 nightwatch 管的是时钟：每轮正常结束后接着开下一轮，到点收工。 两个一起装是对的：截断交给前者，长跑交给后者，skipTruncatedTurnEnd 保证它们不抢同一轮。

开发

git clone https://github.com/Zci514/dsh-nightwatch.git
cd dsh-nightwatch
node --test test/          # 66 条，纯策略层 + 假宿主集成层 + 按钮路由层

• lib/policy.js — 纯函数：时间解析、判定、文案、面板快照、记录回收规则。零依赖，可单独测。
• lib/index.js — 宿主胶水：事件订阅、消息投递、原子持久化、按钮用的 HTTP 路由（以及默认关闭的指令）。
• client.js — 浏览器半边：输入框那颗按钮和卡片（window.__ModuleLoader__ 包一层）。
• test/fake-host.js — 假宿主，只实现插件真正用到的那几个面（含一个能驱动 HTTP 路由的假 webServer）。
• test/nightwatch.test.js — 三层测试。

插件不 import 任何 @deepseek-ai/* 运行时包（profile 里解析不到）， Config 是手写的 Standard Schema，lib/index.js 只依赖 node: 内置模块。

按钮与宿主之间只有三条 HTTP 路由（GET /nightwatch/state、POST /nightwatch/arm|stop）， 所以按钮不走 slash 指令——点十次按钮只应该让界面变十次，不该往对话流里塞流水。 /run-until 下也挂了同一套路由，留给 1.1.0 留下的链接和书签。

按钮路由的同源闸

DSH 给自己的 /api 和 /connect 上了 Host/Origin 检查，但不给插件注册的前缀路由加闸。 所以这几个路由自己检查：

• Sec-Fetch-Site 只要不是 same-origin / none → 403；
• 有 Origin 时其 host 必须等于请求的 Host，否则 403；
• POST 只收 JSON：content-type 是 application/json / text/plain 或为空才处理， urlencoded、multipart/form-data 一律 415。表单只能发这几种「无需预检」的类型， 光靠 Origin 挡不住「页面谎报空 Origin」，所以要再锁一道 body 类型；
• 两个头都没有（curl、脚本、测试）→ 放行（这道闸防的是「浏览器里别的页面」，不是认证）。

已知限制

• 宿主侧代码不热重载，改 lib/ 之后要重启 DSH；client.js 会自动热更。
• 到点默认不打断正在跑的那一轮（graceMs）。
• 重启后要等那个会话被加载出来才会被认领（见上）。
• 只在 Windows + DSH 桌面版上实测过；逻辑层与平台无关。

License

MIT