dsh-caffeinate

DSH PLUGIN会话与消息

仓库 veritaswiki/dsh-caffeinate · npm dsh-caffeinate

会话与消息 L4 · 沙盒安装通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

dsh-caffeinate 是一款 DSH plugin,在 macOS 上拉起 caffeinate 子进程,并用 -w 把防休眠断言绑定到宿主进程,DSH 退出后自动释放;支持 /keepawake 查看与切换模式。

一句话选型结论

按资料字段整理

dsh-caffeinate 是会话与消息类的 DSH 可安装插件,验证等级 L4 · 沙盒安装通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类会话与消息 收录类型可安装插件 验证等级L4 · 沙盒安装通过 安全审查低风险
验证等级 L4 L4 · 沙盒安装通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-11 创建于 2026-11-10
README 10.7 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:veritaswiki/dsh-caffeinate
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖@deepseek-ai/schemastery@>=3.0.0-0需要同时安装的同级依赖
npm 包名dsh-caffeinate可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-caffeinate:为 DeepSeek Harness 提供 macOS 防休眠守护

  • 绑定宿主进程防休眠
  • always 与 running-only 双模式
  • /keepawake 查看与切换
  • 每 15 秒自检重拉
  • 卸载自动清理子进程

上游标签

caffeinatecordisdeepseek-harnessdshdsh-pluginmacos

验证等级与安全审查

L4 · 沙盒安装通过
自动化流程结论,不是人工审核
验证等级L4 · 沙盒安装通过安装命令在隔离沙盒内真实执行成功,无依赖错误
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-13): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✕ 未通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L4:在沙盒里真实装过,依赖能装上,不是纸面声明。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 需要同时装好同级依赖,漏装会启动失败。
  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在会话与消息场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-caffeinate当前 L4 · 沙盒安装通过 低风险 0 未标注 有
dsh-desktop L3 · 安装规范通过 低风险 3.0 万 未标注 无
openpets L4 · 沙盒安装通过 低风险 1,274 未标注 有
deeptide L4 · 沙盒安装通过 低风险 1,104 0.1.1-rc.2 有
jingyun-dsh L3 · 安装规范通过 低风险 1,004 未标注 有
study-mate 未做沙盒验证 未标注 856 未标注 无

仓库档案

会话与消息
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方veritaswiki仓库 dsh-caffeinate · 默认分支 main
分类会话与消息desktop
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-10 · 2026-11-11最后推送 2026-11-11
本站收录2026-11-11首次进入本站目录的时间

README 全文

10.7 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-caffeinate — DSH 运行期间不让 Mac 睡过去



<!-- npm 徽章:dsh-caffeinate 发布后再补 https://img.shields.io/npm/v/dsh-caffeinate -->

> 一个 Host 侧 DSH 插件:拉一个 macOS 自带的 caffeinate 子进程,用 -w 把防休眠断言绑到 DSH 主进程上。宿主没了,断言跟着没;屏幕该息屏还是息屏。

它做什么

  1. 拉起一个 caffeinate 子进程 —— 插件加载时 spawn(&quot;/usr/bin/caffeinate&quot;, args),stdio: &quot;ignore&quot;、detached: false,随后 unref(),不拖住宿主退出。
  2. 参数由设置决定,末尾固定 -w —— 默认拼出来是 /usr/bin/caffeinate -i -s -m -w;不勾「阻止显示器休眠」就不带 -d。
  3. 断言绑在宿主进程上 —— -w 的语义来自 caffeinate(8):「等待指定 pid 的进程退出,进程退出后断言一并释放」。所以 DSH 正常退出或被杀掉之后,不会留下一个继续压着系统的孤儿 caffeinate。
  4. 每 15 秒自检一次 —— setInterval(reconcile, 15000):always 模式下子进程没了就重拉;running-only 模式下按「有没有正在执行的 agent」决定起停。
  5. 斜杠指令随时看随时切 —— /keepawake(别名 /caffeinate)能报当前状态、子进程 PID、绑定的宿主 PID、已运行秒数、实际启动参数,并附一段 pmset -g assertions 的过滤结果;也能直接切模式。
  6. 卸载清理 —— ctx.effect 的清理函数里 clearInterval 并对子进程发 SIGTERM。

它怎么做

参数拼装(buildCaffeinateArgs)

配置键 默认 拼进去的参数 含义(依 caffeinate(8))
preventIdleSystemSleep true -i 阻止系统空闲休眠
preventSystemSleepOnAC true -s 阻止整机睡眠;这条断言只在交流电下有效
preventDiskSleep true -m 阻止磁盘空闲休眠
preventDisplaySleep false -d 阻止显示器休眠
四个全关时 — 兜底 -i 代码里 flags 为空会补一个 -i
固定尾部 — -w 监视宿主进程,process.pid

默认全开(-d 除外)时,实际命令行是:

/usr/bin/caffeinate -i -s -m -w

绑的是谁的 pid:buildCaffeinateArgs(state, process.pid) —— 即运行插件的那个 DSH 宿主进程,不是 caffeinate 自己的 pid,也不是它 fork 出去的任何子进程。

生命周期

时机 行为
插件加载 apply() 里先跑一次 reconcile()
每 15 秒 setInterval 再跑一次 reconcile(),定时器 unref()
插件卸载 clearInterval + 对子进程 kill(&quot;SIGTERM&quot;)
宿主进程消失 由 caffeinate -w 自行释放断言并退出
子进程自己退出 / 起不来 exit / error 回调把 state.child 清空,下一次 reconcile() 重拉;错误记进 state.lastError

reconcile() 的三种结果

  • enabled === false → 停掉子进程;
  • mode === &quot;always&quot; → 没有子进程就起一个;
  • mode === &quot;running-only&quot; → 有 status === &quot;running&quot; 的 agent 才起,否则停。

判断方式是从宿主取 agents 服务,遍历其 values() 看 status。

安装

本插件是 DSH(Cordis)bundle。两种装法。

方式 A:让 Agent 用 plugin_manager 安装

在 DSH 里对 Agent 说「装 dsh-caffeinate」,它会调 plugin_manager:

  • action: &quot;install_bundle&quot;,target 填安装 spec:
  • 已 clone 到本地:file:/abs/path/to/dsh-caffeinate
  • GitHub 上的仓库:github:veritaswiki/dsh-caffeinate
  • 或直接填 npm 包名 dsh-caffeinate(需已发布到 registry)
  • 装完 action: &quot;set_bundle&quot; 启用。

> 首发状态:包名已定为 dsh-caffeinate,但还没有发布到 npm registry,所以现在在 npm 上搜不到。发布前请用上面的 github: 或 file: spec。

方式 B:手动挂到 profile

  1. 把仓库放在任意目录(下面记作 /abs/path/to/dsh-caffeinate)。
  2. 编辑 profile 的 package.json(~/.dsh/profiles//package.json):
    - dependencies 里加 &quot;dsh-caffeinate&quot;: &quot;link:/abs/path/to/dsh-caffeinate&quot;
    - dsh.profile.bundles 数组里加 &quot;dsh-caffeinate&quot;
  3. 在 profile 目录安装依赖(DSH 下次启动时也会自行安装)。

依赖说明

index.js 需要 @deepseek-ai/schemastery(Host 侧配置校验)。DSH 自带这个包,正常安装不需要另装;package.json 里它是 peerDependencies(&gt;=3.0.0-0),只用来把依赖关系写明。本仓库不带 node_modules。

配置

配置项在插件的标准设置表单里(Schemastery Config):

键 类型 默认值 说明
enabled boolean true 是否启用守护
mode &quot;always&quot; | &quot;running-only&quot; &quot;always&quot; always = DSH 打开期间一直防休眠;running-only = 只有 agent 在执行时才防休眠
preventIdleSystemSleep boolean true 对应 -i
preventSystemSleepOnAC boolean true 对应 -s
preventDiskSleep boolean true 对应 -m
preventDisplaySleep boolean false 对应 -d;默认关闭,屏幕照常息屏锁屏

非法值的行为(normalizeConfig):布尔项除显式 false 外都按 true;mode 除显式 &quot;running-only&quot; 外都按 &quot;always&quot;;preventDisplaySleep 走 Boolean(),非真值即 false。

配置在 apply() 时读一次即定型,代码里没有监听配置变更的分支。

斜杠指令

/keepawake 与 /caffeinate 注册的是同一套逻辑,子命令行为如下:

输入 内存状态变化 是否重启子进程
/keepawake status(或空、或任何未识别的词) 无 否,只报告
/keepawake on / start enabled=true、mode=always、屏幕策略回到配置里的 preventDisplaySleep 值 是(先停再起,PID 与运行时长归零)
/keepawake display / screen enabled=true、mode=always、preventDisplaySleep=true 是
/keepawake nodisplay / headless enabled=true、mode=always、preventDisplaySleep=false 是
/keepawake running / auto enabled=true、mode=running-only 否,交给 reconcile() 决定
/keepawake off / stop enabled=false 是(停)

注意 status 不是独立分支:代码里没有 status 判断,它和不认识的词一样落到「只报告」这条默认路径上。

每次执行完都会返回同一份报告:守护状态、当前 mode、实际启动参数、屏幕策略、最近异常(若有),以及 pmset -g assertions 里匹配 PreventUserIdleSystemSleep、PreventSystemSleep、PreventUserIdleDisplaySleep、caffeinate、powerd 的行(pmset 超时 4 秒,取不到就截前 600 字符,非 macOS 直接说明不支持)。

已知限制

  • 仅 macOS。非 darwin 平台不会 spawn,state.lastError 记下「不支持的操作系统平台」,指令报告里能看到;pmset 那一段也会说明平台不支持。
  • 需要 /usr/bin/caffeinate 存在(macOS 自带)。插件不检查路径、不做安装提示;spawn 失败只会进 lastError。
  • -w 绑的是宿主主进程 pid。DSH fork 出去的进程不在绑定范围内:它们不在时不会让 caffeinate 续命,它们还在时也不会让 caffeinate 多活——主进程一走,这一层断言就结束。
  • running-only 依赖宿主暴露 agents 服务,且 agent 的 status 为 &quot;running&quot;。取不到该服务时判断恒为「没有正在执行的 agent」,结果是这个模式下不会拉起 caffeinate(宁可不防,也不乱防)。
  • 15 秒轮询:running-only 的起停最多有 15 秒延迟,不是事件驱动的即时反应。
  • 指令改动不落盘:/keepawake 只改内存里的状态,不写配置。重载插件后回到配置文件里的值。
  • /keepawake display、/keepawake nodisplay 会把 mode 强制成 always:想同时保持「屏幕常亮 + 仅任务执行时防休眠」当前做不到,得二选一。
  • /keepawake on 不会强制开屏幕常亮,它把屏幕策略恢复成配置里的值——如果配置里 preventDisplaySleep 是 false,它就是关的。
  • -s 只在交流电下有效,这是 caffeinate 自身语义,插件不额外判断电源状态。
  • 不改断言的叠加关系:若机器上另有系统级 caffeinate(例如 examples/com.user.caffeinate.plist 那种常驻 LaunchAgent),两层断言会同时存在,/keepawake off 只关插件这一层。
  • 没有单元测试:门禁是 node --check 加脱敏扫描,scripts/sanitize-check.mjs 不覆盖行为。

与其它实现的关系

同一个问题还有一份实现:bearice/dsh-keep-awake(npm 包名 dsh-keep-awake)。它走跨平台路线,并提供可视化的双语设置页;本包只做 macOS,交互面放在斜杠指令上。本包之所以叫 dsh-caffeinate 而不是 dsh-keep-awake,是因为后者在 npm 上已被占用。

取舍写在明面上:直接用系统自带的 caffeinate、把生命周期交给 -w,换来的是几乎为零的平台层代码和一个可脚本化、可回滚的命令面;代价是只能在 macOS 上跑,屏幕上也没有独立面板(配置在插件标准设置表单里)。需要跨平台就用那一份,只需要 Mac 上安静地不合盖,用这份就够。

开发与检查

node --check index.js
node scripts/sanitize-check.mjs

scripts/sanitize-check.mjs 是脱敏门禁:本机绝对路径、私有包前缀、回环地址、内网地址段、密钥与令牌前缀一律不许出现,命中即退出码 1。CI(.github/workflows/ci.yml)在 Node 20 上只跑这两步,不发布 npm。

文件

文件 作用
package.json bundle 清单:dsh.bundle.patch 指回 cordis.patch.yml
cordis.patch.yml 插入一行 Loader 条目(insert.name 必须等于包名)
index.js Host 侧全部逻辑:配置、caffeinate 起停、reconcile、两个斜杠指令
locale/zh.json、locale/en.json 插件管理页的标题与描述
icon.svg 插件图标(源码)
assets/icon-180.png 180×180 位图,供需要位图图标的场合使用
examples/com.user.caffeinate.plist 可选的系统级 LaunchAgent 示例;插件不安装、不读取、不依赖它

License

MIT © 2026 veritaswiki

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-caffeinate 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:veritaswiki/dsh-caffeinate` 即可。对应的 npm 包名是 `dsh-caffeinate`。

dsh-caffeinate 的验证等级是什么意思?

L4 · 沙盒安装通过。安装命令在隔离沙盒内真实执行成功,无依赖错误

dsh-caffeinate 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-caffeinate 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-caffeinate 需要什么运行环境?

需要同时安装 @deepseek-ai/schemastery@>=3.0.0-0。环境不满足时安装会失败,建议先确认本机版本。

dsh-caffeinate 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-caffeinate 有哪些功能?

绑定宿主进程防休眠、always 与 running-only 双模式、/keepawake 查看与切换、每 15 秒自检重拉、卸载自动清理子进程。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

1 条
不同作者的仓库分开列,请确认你要装的是哪一个
会话与消息
按星标排序,可作替代方案

dsh-desktop

dsh-desktop

为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。

L3 · 安装规范通过 3.0 万 星

openpets

openpets

L4 · 沙盒安装通过 1,274 星

deeptide

deeptide

L4 · 沙盒安装通过 1,104 星

jingyun-dsh

jingyun-dsh

井云 DSH 客户端插件,为 DeepSeek Harness 注入会员登录、订阅支付、算力管控与应用市场,让智能体和技能快速变成可交易商品

L3 · 安装规范通过 1,004 星

study-mate

study-mate

StudyMate 是 DSH 的「学习模式」预设与技能包,为数学、计算机科目定制学习路线、讲解课件与练习评估,跨科目共享记忆。

未标注验证等级 856 星

veritaswiki 的其它插件

3 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-13。