dsh-automation-monitor

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	下次窗口时间按插件真实调度逻辑算（含「夜间跨零点会跑两轮」这个坑）
会话提醒	$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 内置提醒	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 之类）
定时任务	通用的定时执行体
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，但别指望有人能手写修复 —— 先看看「边界」那节，很多是设计如此。