前言¶
在 DeepSeek Harness(DSH)里装多了定时插件、cron、任务板之后,排期往往分散在 $DSH_HOME 下各自的 JSON 里,各插件进程互不可见。侧栏自带的「自动化任务」页面主要管 DSH 自己排的任务,也看不到「是哪个插件写的、上次跑没跑、这一轮大概花多少 token」。下面介绍社区插件 dsh-automation-monitor:在会话视图头部增加一个只读的「自动化」标签页,把本机可识别的自动化排期汇总成一张表,不启动、不暂停、不修改任何任务。
这是什么¶
维护者 litongtong256 在 npm 发布包名 dsh-automation-monitor(当前资料中版本 0.5.0,MIT 许可证)。插件定位一句话:不拥有任何任务,只当那块表。Host 端聚合 $DSH_HOME 内排期与日志线索,经 GET /automation/status.json 暴露;浏览器端向 conversation.view 槽位注册标签 automation-monitor(order 25,标签文案「自动化」),约 20 秒轮询刷新。顶部还会读 .dshw-usage.json 显示今日全局花费与余额。
核心功能¶
会话标签页里的表格¶
装好并重启 DSH 后,会话头部标签行会出现「自动化」。点开可见表格列(0.4.0 起,资料沿用至 0.5.0):
| 列 | 内容 |
|---|---|
| 名称 | 任务名 + 分类 |
| 状态 | 运行中 / 已排期 / 空闲 / 已停用,附运行次数 |
| 来源 | 写入方,如 dsh-bili-scroll、@goodandready/dsh-cron、任务板 |
| 上次运行 | 相对时间 |
| 下次运行 | 计划时间 + 前端现算倒计时;1 小时内标橙色 |
| 花费 | 该轮 token 花费估计 |
表头可点击排序(名称、状态、来源、上次、下次);默认按「下次运行」升序,无下次时间的沉底。支持按任务名、来源、规则搜索,以及全部 / 已开启 / 已停用筛选。顶部分类药丸按 category 过滤。
监视数据来源¶
两条路径:精准探针(认识具体插件,能算下次时间)与通用发现(扫 $DSH_HOME 下最多三层 JSON,匹配 nextRunAt / nextRun / runAt / fireAt 等字段)。
资料中列出的精准来源包括:
- 刷 B 站
dsh-bili-scroll:$DSH_HOME/bili-duty/{state,config}.json、duty.log、out/<日期>.md - 会话提醒:
$DSH_HOME/storages/schedule.json(可列出其他会话里的提醒;内置schedule_list仅当前会话) - 任务板 cron:
$DSH_HOME/task-board/ledger-v2.json - 自定义登记:
automations.json
通用发现还覆盖 README 表格中标注为真装验证或通用识别的多个社区插件(如 @mzzsfy/dsh-cron-board、@goodandready/dsh-cron、dsh-plugin-heartbeat 等)。系统 crontab、Windows 计划任务、纯内存且不落盘的定时器扫不到;dsh-cron-panel 因不在 $DSH_HOME 而列在不可见情形中。
每条任务会标注是否花 token:会起 agent 会话(花 token) / 只跑脚本(不花 token) / 未知。
与 DSH 自带「自动化任务」的差异¶
自带页面擅长管理自己排的任务与运行记录;本插件侧重跨插件只读总览:来源、分类、上次运行、花费估计、表头排序与 1 小时内高亮等。两者可同时安装,不冲突。
与同生态监视类插件¶
README 比对过 dsh-my-observability(事后审计)、dsh-token-monitor(按模型拆用量)、dsh-hud(当前轮会话状态)等:槽位 id 为 automation-monitor,与 token-monitor-usage(order 20)并排;扫描跳过 observability、system-monitor-plugin、token-monitor 等目录以降低误报。今日总花费与若干用量插件同源 DSH 记账,本插件只给总数,表格回答「谁在花、何时再跑」。
安装与启用¶
Node 引擎要求 >=20(见 package.json)。资料给出的安装方式如下。
Windows 一键(仓库内 install.ps1):
powershell -ExecutionPolicy Bypass -File .\install.ps1
从 npm(在 desktop profile 目录安装并写入 bundle):
cd "$DSH_HOME/profiles/desktop"
npm i dsh-automation-monitor
在 dsh.profile.bundles 末尾增加一行:
"dsh-automation-monitor"
装完后重启一次 DSH,会话头部应出现「自动化」。若未安装任何可被识别的自动化来源、也未在 automations.json 登记,标签页为空属正常,不代表插件损坏。
插件以当前 DSH 进程权限读取本机 $DSH_HOME;安装前请自行查看 GitHub 仓库 源码与 MIT 许可证。社区目录 skillhub.cn 插件页 为独立站点 listing,与 DeepSeek / 幻方无官方从属关系。
典型用法¶
打开总览¶
重启 DSH → 进入任意会话 → 点击头部「自动化」→ 查看下次运行最近的任务是否在首行,必要时用分类药丸或搜索缩小范围。
手动登记一条自动化¶
未来或未识别的任务可写入 automations.json(仓库随包提供示例文件)。登记后会在标签页出现,分类为「手工登记」。
装完是空的?¶
确认是否已有 dsh-bili-scroll、日程提醒、任务板 cron 等落盘数据;没有则表格无行。可按 README「加一条新自动化」一节往 automations.json 添加只读展示项。
适用场景与注意¶
适合:本机已装多个 DSH 自动化插件,需要一张只读表统一看「谁、何时、花多少 token」,且不想从侧栏逐个插件里翻 JSON。
注意:
- 只读:不启动、不暂停、不修改任务,也不碰其他插件私有数据。
- 可见性边界:仅
$DSH_HOME内、符合探针或通用字段规律的排期;通用发现可能对名为schedule的配置误报,此类条目标「未知来源」,可展开详情核对。 - 权限与安全:与 DSH 同进程读盘;敏感路径内容会间接反映在汇总接口中,使用前请理解数据来源。
结尾¶
dsh-automation-monitor 把分散在各插件 JSON 里的排期收成会话里一个「自动化」标签页:上次与下次运行、来源、分类与 token 花费估计在一处查看,且不接管任何任务的执行。目录与文档: