dsh-nightwatch

dsh plugin --profile web add 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 

…(truncated)