← Cadence · 自序

Cadence · 自序使用帮助

Cadence(自序)集中查看本机自动任务、选定远程对象、运行记录与结果依据。适用于 macOS 14 及以上的 Apple Silicon Mac;本版不提供 Intel 构建。

自用范围与首次打开

本应用保持自用。产品主页仅展示脱敏界面、演示与实测,不提供安装包或源码。以下说明面向已安装的自用版本。

从“应用程序”打开 App。根据 macOS 提示确认首次打开,通知权限按需开启。

应用自带运行依赖,不需要安装 Python、Homebrew 或开发工具。无需创建账号。

从旧版升级时,先退出旧版,再将「Cadence」拖入“应用程序”并打开。首次打开会接续旧版已有的登录项与命令行入口,保留任务、暂停状态和偏好;旧 zixu 和 tl-automation 命令继续兼容。确认新版本正常后,可将旧版 App 移到废纸篓。若迁移提示失败,按提示处理冲突后点击刷新重试。

找到你的任务

侧栏包括“总览”“任务”“运行记录”和“设置”。总览帮助你先看到运行中与需处理的任务;选中任务后,在“概览”“运行日志”“原始回执”中查看依据。

首次使用没有受支持的任务时,界面会显示“从已有自动化开始”。可通过“添加已有任务”登记现有 LaunchAgent;登记本身不改变排程与运行状态,不创建业务脚本。应用不附带他人的配置、凭证与业务资料。

本机自动化统一从 Cadence 窗口或 cadence CLI 管理。任务脚本、业务排程与回执仍由各自的原项目维护。支持当前用户下的本机 launchd 任务,以及端点配置中选定的 VPS systemd 服务、Docker 容器、青龙 cron / subscription;不扫描或接管全部远程对象。

任务详情显示“责任源”“执行位置”“执行器”和“可用动作”。先确认这些信息,再执行运行或暂停。本机青龙登录监视只控制对应 LaunchAgent;远程青龙 cron / subscription 则控制所选单项排程。暂停 Docker 会停整个容器,影响容器内所有任务。控制一项常驻服务,不代表它承担的业务任务已经完成。

看懂运行结果

可见状态 含义与下一步
运行中 任务仍在运行。常驻服务持续运行通常是正常情况。
完成 查看任务详情中的结果依据,确认回执覆盖的具体步骤。
需处理 阅读最后退出码、失败说明或日志,定位问题后再运行。
暂停 自动执行处于暂停状态;只有主动恢复才会解除。
未知 / 缺少回执 目前没有足够依据。可刷新状态或查看原始日志。

进程退出码不能独自证明业务结果。没有业务回执的任务,只能确认操作系统能够提供的运行状态。分组中的部分任务完成,不表示所有分项成功。

运行、暂停、恢复与重载

可用动作由任务能力与当前状态决定。不支持的动作显示原因,已暂停的任务不能运行一次。分组任务的暂停作用于整组;查看分项回执并确认影响后再操作。

远程暂停 systemd 会停止并禁用所选服务;暂停 Docker 会停止整个所选容器,并设为不自动重启,恢复时还原原重启策略并回读确认;暂停青龙 cron / subscription 只禁用所选单项排程。远程没有重载和移出工作台动作,按详情中的能力开放按钮。

窗口关闭或退出 App 不会停止原业务任务,也不会改写排程。业务任务继续由 launchd 或原远程执行端管理。

键盘与命令行

快捷键 操作
⌘1 总览
⌘2 任务
⌘Y 运行记录
⌘, 设置
⌘F 搜索任务
⌘R 刷新
⌘0 打开主窗口

在设置中安装命令行入口后,可以用同源 CLI cadence 完成窗口里的查看与操作,适合脚本和 AI 助手调用:

cadence list                                   # 任务列表与总览计数
cadence list --filter attention                # 需处理;另有 active / done / paused / now
cadence detail <完整任务Label>                  # 概览、步骤、日志与回执
cadence show <完整任务Label>                    # detail 的便捷别名
cadence events --type failed --since-hours 24  # 最近 24 小时的失败记录
cadence monitor                                # 后台监测是否在线、数据是否陈旧
cadence prefs                                  # 设置页三个开关与通知授权的当前值
cadence prefs --auto-refresh off               # 暂停界面自动刷新;后台监测与业务排程不受影响
cadence quit                                   # 只退出界面;后台监测与业务排程继续
cadence discover                               # 可纳入的已有任务
cadence enroll <完整任务Label>                  # 只登记,不启动
cadence unenroll <完整任务Label>                # 移出工作台,原任务照常运行
cadence settings <完整任务Label> errors         # 提醒方式:all / result / errors / silent
cadence control run <完整任务Label> --dry-run   # 预演,不做任何更改
cadence control run <完整任务Label>             # 运行一次,再查 detail / events 确认结果
cadence control pause <完整任务Label>           # 持久暂停并停止当前运行
cadence control resume <完整任务Label>          # 恢复;加载即运行的任务可能立即执行
cadence control reload <完整任务Label>          # 重载原配置,保持暂停状态
cadence pause <完整任务Label> --dry-run         # 便捷写法;run / pause / resume / reload 与 control 相同
cadence remote status --json                  # 批量读取选定远程端点的状态
cadence remote configure --file <配置.json>    # 校验并保存端点配置,不启业务

每个命令加 --json 输出 JSON,失败时退出码非 0;cadence <命令> --help 查看参数。将尖括号内的内容替换为 cadence list 显示的完整标识;不要直接输入尖括号。远程标识格式为 remote:<endpoint_id>:<backend>:<task_id>,不接受短名。本机仍可用短名。

CLI 与窗口共用状态、控制逻辑与暂停规则。控制动作会影响对应任务,请先用 detail 查看责任源、执行端、可用动作与结果依据,或加 --dry-run 预演。CLI 控制占锁时最多等待 2 秒;忙时退出码 75,JSON 返回 state=deferred,busy=true,本次未提交。控制超时后先回读 detail,再决定是否重试。设置页的界面自动刷新、菜单栏快捷入口与系统通知三个开关可用 cadence prefs 读取和改写;只有首次启用系统通知须在窗口里通过 macOS 的授权提示。

远程端点

远程端点沿用已有 SSH 主机配置,并指向已部署的远端 helper 和选定对象清单。使用 cadence remote configure --file <配置绝对路径> --json 校验并保存到本应用的本机配置;原配置会自动留一份备份。这一步不会启动服务或任务。随后用 cadence remote status --json 核对是否接通,再从列表复制完整任务标识进行预演。remote status 只读,不写缓存或历史;后台采集器每 60 秒更新共享远程缓存。

端点失联或权限不足时,缓存记录会显示未知、陈旧与错误,CLI 返回非 0。先修复连接并重新读状态,不把缓存中的旧成功当成当前成功,不因一次超时自动重发控制请求。青龙的业务与接口访问仍由原执行端维护,面板令牌、Cookie 和完整环境变量不会进入窗口。

设置:通知、菜单栏与界面自动刷新

设置页里与界面和提醒有关的开关有三个:系统通知、菜单栏快捷入口与界面自动刷新。通知还受“系统设置 → 通知”中的系统权限控制;首次启用时在窗口里通过 macOS 的授权提示。

界面自动刷新只决定窗口多久取一次状态。暂停它,窗口不再自动更新,仍可手动刷新;后台监测与业务排程照常运行。

后台监测由独立的登录项运行,负责采集状态与发出失败提醒,不由设置页的开关控制。关闭窗口或退出 App 都不会停止它。用 cadence monitor 查看它是否在线、数据是否陈旧;用 cadence prefs 读取或改写上面三个开关。

异常恢复

状态陈旧时先刷新;任务执行失败时查看日志与回执,修复原脚本、权限或网络后再运行。若只修改了任务配置,可使用“重载”。不要通过反复点击运行来绕过暂停或重启已在执行的任务。

打开失败时确认 macOS 版本与芯片。如果系统提示损坏或无法验证,请停止打开并反馈完整提示,不需要关闭系统安全保护。

更新与卸载

更新:自用安装包由本机私有发行流程维护。退出 App 后,使用已核验的本机版本替换“应用程序”中的旧版本。原任务与业务数据保持原状。

卸载:先退出 App,再将其移到废纸篓。后台监测是独立的登录项,不随界面退出而停;卸载时在“系统设置 → 通用 → 登录项与扩展”里一并关闭本应用对应的后台项目。原有 launchd 业务任务不随 App 删除;若需停用某项业务,先明确选中并暂停对应任务。命令行入口随 App 删除后不再可用,可按设置显示的安装位置移除对应的 cadence 链接。

联系与反馈

发送到 hi@tianli.cyou,提供 App 版本、macOS 版本、芯片、操作步骤和提示原文。日志与截图可能包含账号、路径及业务信息,请先脱敏。应用不会自动把日志发送给开发者。