dsh-prevent-scd — DSH 防猝死小卫士 🐱

English · 中文

dsh-prevent-scd is a playful rest-reminder pet plugin for the DeepSeek Harness (DSH) web UI — like ChatGPT's pet, it comes out and causes trouble to make you take a break.

It watches for traces of human operation in DSH sessions and nags you when:

• you have been working continuously for hours (default 3 h, any configurable), or
• it is late night (default 23:00–06:00, configurable) and you are still operating.

A cute hand-drawn nurse-cat (inline SVG, zero external assets) lives in the composer strip, turns worried when you approach the limit, then blocks the whole screen with a bouncing 「⛔ 休息!」 sign — intercepting Enter — until you choose “I'll rest now” (quiet for 2 h) or “just 15 more minutes” (snooze).

Highlights

• Host half (Node): listens to session/event real user/messages (plugin-injected / replay events do not count), maintains continuous-work timing.
• Browser half (Web): persistent status line + full-screen mischief overlay, four SVG poses (napping / worried / blocking / relieved farewell), CSS animations (breathing, tail wag, shake, floating Zzz).
• Every threshold is configurable: maxWorkMinutes, idleBreakMinutes (a no-op gap longer than this resets the clock, default 30 min), late-night window, cooldown, snooze.
• State persists to $DSH_HOME/prevent-scd/state.json, surviving dsh restarts.
• No external assets, no network calls, works offline. 18 unit/integration/smoke tests.

Quick install

dsh plugin --profile web add -w "path/to/dsh-prevent-scd"
# restart the dsh web service to activate

Override config in the profile's cordis.patch.yml (hot-reloaded, no restart needed):

- id: prevent-scd
  config:
    maxWorkMinutes: 120
    idleBreakMinutes: 20
    lateNightStart: '23:00'
    lateNightEnd: '06:00'

HTTP surface

• GET /prevent-scd/state.json — state snapshot (browser polls every 15 s)
• POST /prevent-scd/ack — { "kind": "rest" | "snooze" } user response

License

MIT

---

中文文档

一个 DSH(DeepSeek Harness)Web 插件:检测「深夜 + 有人工操作」或「连续数小时有人工操作」, 放出宠物跳出来捣乱,提醒你休息——像 ChatGPT 的宠物一样。

• 宿主半边(Node):监听 session/event 的真实用户消息(user/message,source.kind === 'user', 且为 append 进入日志的事件;插件注入/历史回放不算人工操作),维护连续计时;
• 浏览器半边(Web):输入框下方常驻一行状态小字,休息时间到后宠物占满全屏捣乱 (挡住界面、拦截回车),给你「去休息 / 再干 N 分钟」两个出口。

规则(全部可配置)

配置	默认	说明
maxWorkMinutes	180	连续工作上限(分钟),达到后宠物出来捣乱
warnAtMinutes	150	提前提醒:连续时长到达该值先小声提醒
idleBreakMinutes	30	无操作多久算中断:超过该时长连续计时清零
lateNightStart	23:00	深夜窗口开始(HH:MM,支持跨零点)
lateNightEnd	06:00	深夜窗口结束
recentActivityMinutes	20	深夜判定「人在」的操作窗口:超过该时长无操作不打扰
lateNightMinWorkMinutes	0	深夜触发所需的最少连续工作分钟(0 = 深夜有操作即提醒)
restCooldownMinutes	120	点「我去休息」后的安静时长
snoozeMinutes	15	点「再干 N 分钟」的延时时长
evaluateIntervalSeconds	30	宿主侧评估间隔(浏览器侧轮询固定 15 秒)
persist	true	计时状态持久化(重启 dsh 不丢)
statePath	''	状态文件路径;留空 = $DSH_HOME/prevent-scd/state.json

「连续」的定义:任一无操作间隔超过 idleBreakMinutes(默认 30 分钟)即视为中断, 连续计时清零,下次操作重新起算。

安装

# 在你的 profile 里安装(示例:web)
dsh plugin --profile web add -w "D:\projects\vibe\dshp\dsh-prevent‑scd"

然后重启 dsh web 服务生效(profile bundle 列表变更需要重启;运行中的实例不受影响)。

注意:pnpm 对 link: 依赖不安装传递依赖,@deepseek-ai/cordis / @deepseek-ai/schemastery 通过本机共享的 D:\projects\vibe\dshp\node_modules 解析 (与同目录的 dsh-liang-rheostat 插件同一约定)。换机器部署时,先在插件目录 执行 pnpm install 或把这两个依赖装到可达的 node_modules。

配置

在 profile 的 cordis.patch.yml 里按行 id 覆盖(最后写入者胜,保存即热生效):

- id: prevent-scd
  config:
    maxWorkMinutes: 120        # 2 小时就提醒
    idleBreakMinutes: 20       # 20 分钟无操作算中断
    lateNightStart: '22:30'    # 22:30 到次日 6:30 算深夜
    lateNightEnd: '06:30'
    snoozeMinutes: 10

或直接改 bundle 里的默认值(cordis.patch.yml 中该行的 config)。

卸载

dsh plugin --profile web remove dsh-prevent-scd
# 并删除 profile package.json 的 dsh.profile.bundles 里的 dsh-prevent-scd(如果 pnpm remove 没自动清)

删除 $DSH_HOME/prevent-scd/ 可清掉计时状态。

内部结构

cordis.patch.yml      bundle patch:插入 prevent-scd 一行(dsh.client 双面包)
lib/index.js          宿主插件:session/event 监听、/prevent-scd/* HTTP 端点、持久化
lib/tracker.js        纯逻辑规则引擎(无 cordis 依赖,可独立测试)
lib/client.js         浏览器 bundle:状态条 + 全屏宠物拦截(手写 ModuleLoader 格式)
                      宠物为内嵌 SVG 矢量插画(渐变毛色/高光/护士帽+爱心主题,
                      打盹/担忧/拦路/放行四种姿态,零外部资源)
tools/render-pets.mjs 开发工具:把四个宠物 SVG 渲染成 PNG 并做结构分析
test/                 node:test 单元/集成/冒烟测试

• GET /prevent-scd/state.json — 状态快照(浏览器每 15 秒轮询)
• POST /prevent-scd/ack — { "kind": "rest" | "snooze" } 用户回应

改宠物美术:lib/client.js 里的 PET_SLEEP / PET_WORRY / PET_ANGRY / PET_HAPPY 四个 SVG 字符串,改完用 node tools/render-pets.mjs tools/art 渲染预览, 再刷新浏览器即可(客户端 bundle 是运行时从插件目录读取的,无需重启 dsh)。

测试

pnpm test    # 或 node --test-force-exit test/tracker.test.js 等

License

MIT