dsh-automation-monitor
把你机器上所有「会自己跑起来、悄悄花 token」的自动化，收进会话里的一个只读标签页。
装好重启后，会话头部的标签行里会多出一个「自动化」：
对话 | … | 自动化
↑ 本插件
（排在哪、还有哪些标签，取决于你装了哪些插件、开了哪些开关，这里不列。）
点开就是一张表 —— 谁在自动跑 · 上次跑没跑 · 下次几点跑 · 大概花多少 token，
顶部顺带告诉你今天全局花了多少钱、余额还剩多少。
它不拥有任何任务：不启动、不暂停、不修改任何东西，也不碰别的插件的数据。只是那块表。
30 秒上手
| 怎么装 | 怎么做 |
|---|
| Windows 一键 | powershell -ExecutionPolicy Bypass -File .\install.ps1 |
| 从 npm | cd "$DSH_HOME/profiles/desktop" → npm i dsh-automation-monitor → 在 dsh.profile.bundles 末尾加一行 "dsh-automation-monitor" |
| 手动（改源码用） | 见下面「手动安装」 |
装完重启一次 DSH，会话头部就多出「自动化」。空的也不代表坏了 —— 见下面「装完打开是空的？」。
它监视什么
两条路：精准探针（认识具体插件，能算出下次时间）和通用发现（不认识，靠字段名规律扫出来）。
| 探针 | 读哪里 | 说明 |
|---|
刷B站 dsh-bili-scroll | $DSH_HOME/bili-duty/{state,config}.json、duty.log、out/<日期>.md | 下次窗口时间按插件真实调度逻辑算（含「夜间跨零点会跑两轮」这个坑） |
QQ 伙伴 dsh-aurabot-qq | $DSH_HOME/plugins-data/aurabot/{config,speakup,qzone-social,diary}.json | 「主动搭话 / 空间社交 / 日记 / 内容抓取」四条都单独列出来，每条带自己的开关与下次时间 |
| 会话提醒 | $DSH_HOME/storages/schedule.json | 能列出别的会话里的提醒（DSH 自带的 schedule_list 只看当前会话） |
| 任务板 cron | $DSH_HOME/task-board/ledger-v2.json | 有定时调度的卡片才会出现 |
| 通用发现 | $DSH_HOME 下所有 JSON（≤3 层） | 见下面「支持的插件」 |
| 自定义 | automations.json | 未来任何自动化，加一条就出现在标签页里 |
标签页顶部还显示今日全局花费与余额（读 .dshw-usage.json）。
表格里每行有什么（0.4.0 起）：
| 列 | 内容 |
|---|
| 名称 | 任务名 + 它属于哪一类（分类） |
| 状态 | 运行中 / 已排期 / 空闲 / 已停用，下面一行小字是「已经跑了几次」 |
| 来源 | 这条是谁写的（dsh-bili-scroll、@goodandready/dsh-cron、任务板…） |
| 上次运行 | 什么时候跑过（相对时间） |
| 下次运行 | 什么时候跑 + 前端现算的倒计时；1 小时内会标成橙色 |
| 花费 | 这一轮大概花多少 token |
表头可以点：名称 / 状态 / 来源 / 上次 / 下次，五列都能排序，点一下正序、再点一下倒序。
默认按「下次运行」升序 —— 最快会跑的那个永远在第一行；没有下次时间的沉底。
装完打开是空的？ 这几条来源都是「有就显示、没有就跳过」。
你要是没装 dsh-bili-scroll、也没建过日程提醒，打开就是空的 —— 不是插件坏了，是确实没东西可监视。
可以往 automations.json 里手动登记几条（见下面「加一条新自动化」）。
支持的插件（AI 上网逐个查过源码）
DSH 没有「自动化注册表」，每个插件的定时器都在自己进程里跑，互相看不见。
但几乎所有插件都会把排期落进 $DSH_HOME 下的某个 JSON，而且字段名高度统一 ——
实测 11 个主流自动化插件，10 个用 nextRunAt / nextRun / runAt / fireAt 这一套命名。
所以本插件用「通用发现」兜底：扫 $DSH_HOME（最多 3 层），凡是带这些字段的 JSON 都列出来，
再按文件路径猜它属于哪一类。
| 插件 | 状态文件 | 分类 | 检测 |
|---|
dsh-bili-scroll | bili-duty/ | 内容抓取 | ✅ 精准（装在本机，实测） |
dsh-aurabot-qq 1.1.13 | plugins-data/aurabot/ | QQ 机器人 | ✅ 精准（装在本机，实测）｜主动搭话 / 空间社交 / 日记 / 内容抓取 四条分开列 |
| DSH 内置提醒 | storages/schedule.json | 定时提醒 | ✅ 精准（装在本机，实测） |
| 任务板 | task-board/ledger-v2.json | 任务板 | ✅ 精准（装在本机，实测） |
@mzzsfy/dsh-cron-board 0.7.1 | cron-board/jobs.json | cron 调度 | ✅ 真装验证 |
@michengai/dsh-automation 1.0.10 | automation-settings.json | 定时任务 | ✅ 真装验证 |
dsh-taskboard 0.9.6 | dsh-taskboard*.json | 任务板 | ✅ 真装验证（与本机原有任务板重复，已卸） |
dsh-plugin-heartbeat 0.4.2 | heartbeat.json | 心跳常驻 | ✅ 通用（真装过） |
@goodandready/dsh-cron 0.3.21 | data/cron/tasks.json | cron 调度 | ✅ 通用（真装过） |
@kanadego/dsh-heartbeat 2.0.1 | data/*.json | 心跳常驻 | 认得出文件，但它没有「下次几点」（按作息算法决定何时醒），所以不会列出来 |
@hhuangpanda/dsh-automation | automation/state.json | 定时任务 | ⚠️ 装失败（npm 包解出来缺 package.json），只有源码结论 |
@alpacachen/dsh-automation | automation/state.json | 定时任务 | ⚠️ 装失败，同上 |
dsh-scheduler | tasks.json | 定时任务 | ⚠️ 装失败，同上 |
dsh-automation-center | 未确认 | — | ⚠️ 装失败，同上 |
dsh-cron-panel | 系统 crontab | — | ❌ 不在 $DSH_HOME，扫不到 |
这些标记是怎么来的（不玩虚的）：
- ✅ 精准 / 真装验证 = 把这些插件真的装进
node_modules、真的让宿主加载起来，再按
它们源码里的真实字段名造出它们会写的文件，确认本插件认得出、分类对、花费判断对。
之所以看到的是造的文件而不是它们自己写的：它们都要你在 UI 里先建任务才落盘，本鱼没建
—— 建了可能真跑、真花钱。
- ⚠️ 装失败 = 这几个包从 npm 解开后是残的（
package.json 都没有），复制进 node_modules
也不完整。好在装的同时就确认了：它们没有被写进 profile 配置，所以宿主启动时不会去找
这些不存在的包，不会因此闪退。
- ❌ 扫不到 = 结构上看不见，见下一节。
想自己复现：node test/real-format-check.mjs（按真实插件格式造 fixture → 验识别 → 自动清理）。
什么情况它看不见
- 写进系统 crontab / Windows 计划任务的（如
dsh-cron-panel）：本插件只扫 $DSH_HOME，看不到系统级定时器。
- 纯内存定时器、不落盘的：没有文件就没有线索，任何外部工具都看不见。
- 通用发现的误报：别的插件恰好有个叫
schedule 的配置项也会被列出来。所以这类条目标「未知来源」，展开详情能看到字段线索，一眼能判断是不是真任务。
分类
标签页顶部有一排筛选小药丸，按 category 分：
| 分类 | 含义 |
|---|
| 内容抓取 | 定时去外面抓东西（刷B站、RSS 之类） |
| QQ 机器人 | QQ 伙伴（dsh-aurabot-qq）的主动搭话 / 空间社交 / 日记 / 内容抓取 |
| 定时任务 | 通用的定时执行体 |
| cron 调度 | 用 cron 表达式排的 |
| 心跳常驻 | 周期性唤醒 agent「自己想想」 |
| 定时提醒 | 到点提醒人，不起 agent |
| 任务板 | 任务卡片自带的排期 |
| 手工登记 | 你写进 automations.json 的 |
| 未知来源 | 通用发现扫出来、不知道该归哪的 |
每条还会标它会不会花 token：
会起 agent 会话（花 token） / 只跑脚本（不花 token） / 未知。
和 DSH 自带的「自动化任务」有什么区别
DSH 自带一个「自动化任务」页面（侧栏里那个），它很好用 —— 但它只管自己排的任务，
而且只看得到「什么时候跑」，看不到「跑了什么、花了多少、是哪个插件干的」。
| DSH 自带 | 本插件 |
|---|
| 能看到谁的任务 | 只有它自己排的 | 所有插件的（扫 $DSH_HOME 里的排期文件） |
| 规则（每天 08:00 / cron / 一次性） | ✓ | ✓ |
| 下次运行 | ✓ | ✓ + 前端实时倒计时（不靠服务端那句算死的） |
| 上次运行 | 部分 | ✓ |
| 运行记录 | ✓（只有自己的） | ✓（含插件自己写的日志，例如 duty.log） |
| 搜索 | ✓ | ✓（任务名 / 来源 / 规则都能搜） |
| 状态筛选 | ✓（全部/已开启/已结束） | ✓（全部 / 已开启 / 已停用） |
| 分类 | ✗ | ✓（内容抓取 / 定时提醒 / cron 调度 / 心跳常驻 / 任务板…） |
| 来源（谁写的这条） | ✗ | ✓（dsh-bili-scroll、@goodandready/dsh-cron…） |
| 花费估计 | ✗ | ✓（会起 agent 会话？还是只跑脚本？） |
| 点表头排序 | ✗ | ✓ |
| 1 小时内即将运行高亮 | ✗ | ✓ |
一句话：自带的是「我自己排的闹钟」，这个是「这台机器上所有闹钟的总览 + 谁来叫、要花多少钱」。
两者不冲突，可以同时装。
为什么还要一个？（和同类插件的区别）
查过 npm 上 DSH 插件市场（3570 个包）里所有带 monitor / automation / 监视 字样的：
| 插件 | 它做什么 | 和本插件的关系 |
|---|
dsh-automation-center | 全局自动化中心：创建、排期、审计 Agent 任务 | 执行端 —— 它自己跑任务 |
@michengai/dsh-automation | 在独立 Session 里按计划执行编码任务 | 执行端 |
@hhuangpanda/dsh-automation | Agent 创建的持久化自动化 | 执行端 |
dsh-my-observability | 事件审计 + 资源看门狗面板 + Git 工具 | 看 agent 行为与资源，不看「下次几点跑」 |
dsh-token-monitor / @lcthe/dsh-usage-monitor | 只盯 token 花费 | 只有钱，没有排期 |
dsh-rss-monitor / dsh-system-monitor-plugin | RSS / 系统资源 | 不相干 |
没有一个做这件事：把「你已经装的别的插件」的自动化排期汇总成一张只读的表 ——
谁在跑、上次跑没跑、下次几点跑、花多少 token。
本插件的定位就一句：不拥有任何任务，只当那块表。
和同类「监视面板」插件的关系
DSH 生态里做「看点什么」的插件不少。本鱼把能装的都下载下来读过源码，逐个比对过：
| 插件 | 它看什么 | 数据源 | 位置 | 和本插件的关系 |
|---|
dsh-my-observability | agent 行为审计流 + 资源看门狗 + Git 提交工具 | $DSH_HOME/observability/audit.json | 右栏 tab | 互补：它记「刚才发生过什么」，本插件记「以后什么时候会再发生」 |
dsh-system-monitor-plugin | DSH 进程与子进程的 CPU / 内存 | 进程采样 + system-monitor-plugin/env.json | 会话 view tab | 不同维度：它看硬件，本插件看排期 |
dsh-token-monitor | 模型额度徽标 + 用量统计页签 | provider 接口 + storages/token-monitor/config.json | 会话 view tab（token-monitor-usage，order 20）+ 设置页 | 重叠一点：都显示花费，但它按模型拆，本插件只给总数 |
dsh-hud | 会话实时状态栏（上下文占用 / 令牌 / 轮次 / 计时） | 前端会话数据 | 输入框下方 dock | 不同层：它看当前这一轮，本插件看全局排期 |
@leetoners/dsh-ui-subagent-monitor | 正在跑的子代理 | 会话数据 | 侧栏按钮 + 悬浮卡片 | 互补：它看「现在谁在跑」，本插件看「到点谁会跑」 |
结论：没有功能重复，也不打架。 具体验证过：
- 槽位不冲突：本插件注册
conversation.view 用的 id 是 automation-monitor（order 25）；
dsh-token-monitor 用的是 token-monitor-usage（order 20）。DSH 的 slot 支持多个注册，会并排显示成两个 tab。
- 数据不串：这几个插件写的
audit.json、env.json 是事件流和系统采样，没有 nextRunAt 那套排期字段，
通用发现不会把它们误列成自动化任务（本鱼拿它们的真实格式造了文件实测，0 误报）。
- 防误报：
observability、system-monitor-plugin、token-monitor 三个目录已加进扫描跳过列表 ——
省 IO，也防它们以后改格式时误报。
- 花费数据同源：
dsh-token-monitor、dsh-cost-meter、dsh-whale-widget 与本插件都读 DSH 自己的记账，
所以「今天花了多少」各家显示一致；区别是它们能按模型/按会话拆，本插件只给总数（它要回答的是「谁在花」）。
结构（两个半端，各一个文件）
| 文件 | 半边 | 干什么 |
|---|
lib/index.js | host | 探针 + 唯一接口 GET /automation/status.json |
lib/client.js | 浏览器 | 往 conversation.view 槽位注册「自动化」标签页，读上面那个接口，20 秒轮询 |
lib/client.js 是自注册脚本（不是 ESM），格式必须是：
window.__ModuleLoader__.load({
id: '<等于 package.json 的 name>',
factory: (require) => { ...; return { inject: ['slots'], apply(ctx) {...} } },
})
标签页的注册只有这一句关键：
slots.inject('conversation.view', () => slots.register({
name: 'conversation.view',
id: 'automation-monitor',
order: 25, // 20 = 刷过的视频，越大越靠右
label: '自动化',
scope: 'session',
}, () => h(AutomationTab)))
安装
Windows 用户：仓库里带了个 install.ps1，跑一次就把下面第 2–4 步全做了：
powershell -ExecutionPolicy Bypass -File .\install.ps1
它会自动找 DSH_HOME、建链接、往 package.json 里加两行；改之前会备份，改坏了自动还原。
想装到别处就加参数：-DshHome "D:\dsh-home" -ProfileName desktop。
手动装的话继续往下看。
前提：DSH 桌面版（要有 conversation.view 这个槽位的版本）。
Windows / macOS / Linux 都能装，下面的路径都是示例，照抄时换成你自己的。
最省事：从 npm 装（一条命令）
包已经发在 npm 上了：https://www.npmjs.com/package/dsh-automation-monitor
# 先进到你的 profile 目录
cd "$DSH_HOME/profiles/desktop" # Windows PowerShell: cd "$env:DSH_HOME\profiles\desktop"
# 装
npm i dsh-automation-monitor # 用 pnpm 也行：pnpm add dsh-automation-monitor
它会被放进 node_modules/dsh-automation-monitor，正是 DSH 要读的位置，不用建链接。
然后只剩一步：打开同一个目录下的 package.json，在 dsh.profile.bundles 数组末尾加一行
"dsh-automation-monitor"
重启 DSH，会话头部就多出「自动化」标签页。
想改源码、或者长期用一份自己的改动，再走下面的手动流程（clone + junction）。
1. 先找到你的 DSH_HOME
DSH 的数据和插件都在它下面：
# Windows PowerShell
echo $env:DSH_HOME
# macOS / Linux
echo $DSH_HOME
没设过的话默认是 ~/.dsh（比如 C:\Users\你的用户名\.dsh）。
你的 profile 目录 = $DSH_HOME/profiles/<profile 名>，一般叫 desktop。
下面统一写作 $DSH_HOME 和 desktop。
2. 把代码放下
git clone https://github.com/litongtong256/dsh-automation-monitor.git /path/to/dsh-automation-monitor
放哪都行（D:\plugins\...、/opt/...、~/code/...），记住路径就行。
3. 挂进 profile 的 node_modules
Windows（junction，不需要管理员权限）：
New-Item -ItemType Junction `
-Path "$env:DSH_HOME\profiles\desktop\node_modules\dsh-automation-monitor" `
-Target "D:\plugins\dsh-automation-monitor"
macOS / Linux（符号链接）：
ln -s /opt/dsh-automation-monitor \
"$DSH_HOME/profiles/desktop/node_modules/dsh-automation-monitor"
4. 在 profile 的 package.json 里登记两处
打开 $DSH_HOME/profiles/desktop/package.json：
{
"dependencies": {
"dsh-automation-monitor": "0.2.0" // ← 加这一行
},
"dsh": {
"profile": {
"bundles": [
// ... 原有的
"dsh-automation-monitor" // ← 数组末尾加这一行
]
}
}
}
5. 重启 DSH
会话头部多出「自动化」标签页，就是装好了。
卸载
Remove-Item "$env:DSH_HOME\profiles\desktop\node_modules\dsh-automation-monitor" -Force
再把 package.json 里上面那两行删掉，重启即可。删掉链接不会删你 clone 下来的源码。
用 junction / symlink 装的原因
改代码不用重新安装，开发目录就是运行目录。代价是别乱删别乱搬源码目录，搬了要重建链接：
Remove-Item "$env:DSH_HOME\profiles\desktop\node_modules\dsh-automation-monitor" -Force
New-Item -ItemType Junction `
-Path "$env:DSH_HOME\profiles\desktop\node_modules\dsh-automation-monitor" `
-Target "<新路径>"
也正因如此：别在 profile 里跑 npm install，它会把链接覆盖成真目录，你的改动就跟运行中的那份脱钩了。
自检（不用起 DSH）
进插件目录跑：
node test/self-check.mjs # 探针能读到什么
node test/self-check-apply.mjs # host 只注册一个接口
node test/self-check-client.mjs # 标签页注册 + 首屏渲染
node test/self-check-robust.mjs # 宿主缺 API / 坏 ctx 也不会抛（防闪退）
Node 18+ 都行。想用 DSH 自带的那个也行：$DSH_HOME/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin/node.exe
版本兼容（为什么它不会把你的 DSH 拖崩）
装插件最怕的事，是某个插件的加载代码抛异常，把整个宿主带下去 —— 白屏或者直接闪退。
这个插件在这方面是按最坏情况写的：
| 宿主给的东西 | 它的反应 |
|---|
正常（有 root.inject / root.effect / webServer.register） | 正常注册 /automation/status.json |
没有 root.inject | 打一行日志，跳过接口注册，其它一切照旧 |
root.effect 或 webServer.register 自己抛 | 捕获，打日志，继续 |
webServer 不存在或没有 register | 捕获，跳过 |
浏览器端没有 window.__ModuleLoader__ | 安静退出，不动页面 |
浏览器端拿不到 react | 返回一个空插件，不注册任何东西 |
slots 不存在 / 没有 conversation.view 槽位 | 静默跳过，不报错 |
| 任意一个探针读文件时炸了 | 只影响那一条，进 warnings，其它照常显示 |
它不判断版本号。DSH 的版本号在运行时并不总是拿得到，硬编码「只支持 0.15.x」只会让
新版一升级就坏。所以走的是能力探测：宿主给什么 API 就用什么，缺哪个就少一个功能，
绝不假设。
想自己验证 apply() 在任何坏输入下都不抛：
node test/self-check-robust.mjs # 13 种坏宿主输入，全部必须安静通过
用
- 会话头部点「自动化」。
- 点任意一行展开详情（排期、自动评论开关、最近日志、数据源路径）。
- 打开时每 20 秒自动刷新，也可以点右上角「刷新」。
- 状态标签：已排期（蓝）/ 运行中（绿）/ 空闲（灰）/ 已停用（暗）。
加一条新自动化
编辑 $DSH_HOME/automations.json（没有就从插件目录复制一份）：
{
"items": [
{
"id": "backup",
"name": "夜间备份",
"kind": "脚本",
"enabled": true,
"scheduleText": "每天 03:00",
"lastRun": "2026-10-27T19:00:00Z",
"nextRun": "2026-10-28T19:00:00Z",
"costText": "不花 token",
"note": "每天凌晨把项目打包到 D 盘"
}
]
}
存盘后刷新标签页就能看到。
加一个新探测器（自动读）
lib/index.js 里有一个 probes 数组，每个探针是 (nowMs) => item[]：
const probes = [
['bili-scroll', probeBili],
['schedule', probeSchedule],
['task-board', probeTaskBoard],
['custom', probeCustom],
// 加一行：['my-source', probeMySource],
]
每个 item 的字段：
| 字段 | 说明 |
|---|
id name kind | 标识、显示名、分类 |
enabled | 是否启用（false 显示为已停用） |
state | running / scheduled / idle / disabled |
stateText | 状态中文标签 |
scheduleText | 排期描述 |
lastRunText nextRunText | 上次 / 下次（已格式化的中文） |
costText detail[] lastLog sourceFile | 花费、详情行、最近日志、数据源路径 |
接口
| 路由 | 用途 |
|---|
GET /automation/status.json | 全部条目的 JSON（可直接 curl，只读） |
边界
- 只读：所有探针只
readFileSync，没有任何写入；标签页也不会启动/暂停/修改任何任务。
- 失败不拖累宿主：探针异常只进
warnings；标签页 fetch 失败只显示一行提示，不影响会话本身。
- 不引第三方依赖：host 侧纯 Node，浏览器侧只用宿主自带的
react。
关于这个项目
这个是全部 dsh 制作，当时只是没有搜到类似的插件，我就让他写了一个，然后测试看能不能上传到 GitHub 上，研究一下居然真的成功了，我根本看不懂代码啊，如果有什么这个项目问题我很抱歉啊，只有这一句话是人类说的，以下内容全是大肥鱼生成的；
—— 项目主人
代码、文档、issue 回复基本都是大肥鱼（AI）写的。人只负责说「我要什么」和「这个不对」。
所以：用出问题欢迎提 issue，但别指望有人能手写修复 —— 先看看「边界」那节，很多是设计如此。
