Cadence · 自序使用帮助

Cadence（自序）集中查看本机自动任务、运行记录与结果依据。适用于 macOS 14 及以上的 Apple Silicon Mac；本版不提供 Intel 构建。

自用范围与首次打开

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

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

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

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

找到你的任务

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

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

本版只管理当前用户下受支持的本机任务。容器内部、远程服务器及第三方自带的更新服务，继续使用各自入口。

看懂运行结果

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

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

运行、暂停、恢复与重载

运行一次：按原有控制入口执行；不会绕过暂停，也不会强制重启已经运行的任务。
暂停：持久禁用任务，并停止当前运行。操作前确认任务内容。
恢复：解除暂停。对于加载即运行的任务，恢复可能立即触发执行。
重载：修改任务配置后重新加载；已暂停的任务不会因此恢复。

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

键盘与命令行

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

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

cadence list                                   # 任务列表与总览计数
cadence list --filter attention                # 需处理；另有 active / done / paused / now
cadence detail <完整任务Label>                  # 概览、步骤、日志与回执
cadence events --type failed --since-hours 24  # 最近 24 小时的失败记录
cadence monitor                                # 后台监测是否在线、数据是否陈旧
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>             # 另有 pause / resume / reload

每个命令加 --json 输出 JSON，失败时退出码非 0；cadence <命令> --help 查看参数。将尖括号内的内容替换为 cadence list 显示的完整 Label；不要直接输入尖括号。

CLI 与窗口共用状态、控制逻辑与暂停规则。控制动作会影响对应任务，请先用 detail 查看详情，或加 --dry-run 预演。系统通知授权、后台监测与菜单栏开关只能在窗口的设置中更改。

通知与后台监测

在设置中按需开启系统通知、菜单栏入口与后台监测。通知还受“系统设置 → 通知”中的系统权限控制。关闭后台监测会停止本应用的自动状态采集，不会停止业务任务。

异常恢复

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

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

更新与卸载

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

卸载：先在设置关闭本应用的后台监测与菜单栏入口，再退出 App，将其移到废纸篓。原有 launchd 业务任务不随 App 删除；若需停用某项业务，先明确选中并暂停对应任务。命令行入口随 App 删除后不再可用，可按设置显示的安装位置移除对应的 cadence 链接。

联系与反馈

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