防猝死小卫士 Codingendless/dsh-prevent-scd

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

English · 中文

dsh-prevent-scd 是给 DeepSeek Harness（DSH）Web UI 做的休息提醒宠物插件，风格俏皮——像 ChatGPT 的宠物一样，它会跳出来捣乱，逼你去休息。

它会盯着 DSH 会话里的人工操作痕迹，一旦出现下面两种情况就唠叨你：

- 你已经连续工作了好几个小时（默认 3 小时，可配置），或者
- 已经是深夜（默认 23:00–06:00，可配置），你还在操作。

输入框那一栏住着一只可爱的手绘护士猫（内联 SVG，零外部资源）。你快到上限时它会露出担心的表情，然后用一块蹦跳的牌子挡住整个屏幕——夜里显示「⛔ 睡觉!」，白天显示「⛔ 走走!」——同时拦截回车，直到你选择对应的操作（夜里选「好，我睡」，白天选「我去走走」，安静 2 小时），或者再拖 15 分钟。

亮点

- 宿主半边（Node）：监听 session/event 里真实的 user/message（插件注入 / 回放的事件不算），维护连续工作计时。
- 浏览器半边（Web）：常驻状态行 + 伙伴萌系弹窗（你连续工作每满 moeIntervalMinutes，猫就蹦到右下角打个招呼——点一下关掉，绝不挡路）+ 全屏捣乱遮罩，五种 SVG 姿势（打盹 / 担心 / 拦睡觉 / 拦散步 / 松口气告别），CSS 动画（呼吸、摇尾巴、抖动、飘 Zzz）。
- 场景感知文案：深夜 → 去睡觉，白天长时间工作 → 去走走——消息、标题、按钮、牌子全都跟着触发原因走。
- 每个阈值都能配：maxWorkMinutes、idleBreakMinutes（空档超过这个时长就重置计时，默认 30 分钟）、深夜时段、冷却、拖延时长。
- 状态持久化到 $DSH_HOME/prevent-scd/state.json，dsh 重启也不丢。
- 无外部资源，无网络请求，离线可用。18 个单元 / 集成 / 冒烟测试。

快速安装

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

在配置档的 cordis.patch.yml 里覆盖配置（热重载，不用重启）：

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

HTTP 接口

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

许可证

MIT

中文文档

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

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

规则(全部可配置)

| 配置 | 默认 | 说明 |
| maxWorkMinutes | 180 | 连续工作上限（分钟），达到后宠物出来捣乱 |
| warnAtMinutes | 150 | 提前提醒：连续时长到达该值先小声提醒 |
| idleBreakMinutes | 30 | 无操作多久算中断：超过该时长连续计时清零 |
| moeIntervalMinutes | 45 | 陪伴卖萌：卫士猫每连续工作满该分钟数，在右下角冒出来卖萌一次（0 = 关闭） |
| moeDurationSeconds | 6 | 卖萌卡片停留时长（秒），点一下可提前关闭 |
| 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_SLEEP / PET_ANGRY_MOVE / PET_HAPPY 五个 SVG 字符串，改完用 node tools/render-pets.mjs tools/art 渲染预览，再刷新浏览器即可（客户端 bundle 是运行时从插件目录读取的，无需重启 dsh）。

测试

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

License

MIT