diff --git a/.env.example b/.env.example index 24a6267..53d85e4 100644 --- a/.env.example +++ b/.env.example @@ -11,8 +11,8 @@ YUN_XUE_TANG_BUDGET_MINUTES=0 YUN_XUE_TANG_BARK_URL= # 通知分组,留空 = Bark 默认 YUN_XUE_TANG_BARK_GROUP=云学堂助手 -# 通知在 Bark 服务端保留多少秒,0 = Bark 默认 -YUN_XUE_TANG_BARK_TTL=600 +# 通知在 Bark 服务端保留多少秒,0 = 永久保留(不传 ttl) +YUN_XUE_TANG_BARK_TTL=0 # 时区,影响日志时间戳 TZ=Asia/Shanghai diff --git a/README.md b/README.md index 337c85a..066e983 100644 --- a/README.md +++ b/README.md @@ -259,7 +259,7 @@ Windows 上要注意:`Ctrl+C` 会让运行器优雅收尾(暂停视频、停 | `--log-max-bytes N`(旧名 `--log-max`) | `YUN_XUE_TANG_LOG_MAX_BYTES` | `logMaxBytes` | `5242880` | 单文件上限,超出轮转 | | `--bark-url URL` | `YUN_XUE_TANG_BARK_URL` | `barkUrl` | 空 | Bark 推送地址(含设备 key),运行器自己收尾时推手机通知;空 = 不推送 | | `--bark-group NAME` | `YUN_XUE_TANG_BARK_GROUP` | `barkGroup` | 空 | Bark 通知分组(App 里按组折叠) | -| `--bark-ttl N` | `YUN_XUE_TANG_BARK_TTL` | `barkTtl` | `0` | 通知在 Bark 服务端保留多少秒;`0` = 默认 | +| `--bark-ttl N` | `YUN_XUE_TANG_BARK_TTL` | `barkTtl` | `0` | 通知在 Bark 服务端保留多少秒;`0` = 永久保留 | | `--no-tui` | `YUN_XUE_TANG_TUI` | `tui` | 开 | `1`/`0`,是否在终端显示实时面板;stdout 不是 TTY 时自动关闭 | | `--no-color` | `YUN_XUE_TANG_COLOR` | `color` | 开 | `1`/`0`,面板是否带 ANSI 颜色(也认 `NO_COLOR`) | | `--config PATH` | `YUN_XUE_TANG_CONFIG` | — | `./config/runner.config.mjs` | 指定另一个配置文件 | @@ -325,7 +325,7 @@ export default { // config/runner.config.mjs barkUrl: 'https://api.day.app/<你的设备 key>', // 也接受带 {title}/{body} 的完整模板 barkGroup: '云学堂助手', // 通知分组 -barkTtl: 600, // 服务端保留秒数 +barkTtl: 0, // 服务端保留秒数,0 = 永久保留 ``` ```sh diff --git a/config/runner.config.mjs b/config/runner.config.mjs index d16cc43..4d15727 100644 --- a/config/runner.config.mjs +++ b/config/runner.config.mjs @@ -58,8 +58,8 @@ export default { barkUrl: '', /** 通知分组(Bark App 里把同一组折叠在一起),留空 = Bark 默认 */ barkGroup: '云学堂助手', - /** 通知在 Bark 服务端保留多少秒;0 = Bark 默认(效仿 curl 示例里的 600) */ - barkTtl: 600, + /** 通知在 Bark 服务端保留多少秒;0 = 永久保留(不传 ttl 参数) */ + barkTtl: 0, // ---------- 终端面板 ---------- /** 终端里显示实时面板(框线 + 进度条);false = 回到逐行日志。非 TTY(重定向/计划任务)时自动关闭 */ diff --git a/runner/config.mjs b/runner/config.mjs index 475955d..5f35eaf 100644 --- a/runner/config.mjs +++ b/runner/config.mjs @@ -44,7 +44,7 @@ const DEFAULTS = { // key 等价于「谁能往你手机推通知」,别提交到公开仓库;可用环境变量覆盖。 barkUrl: '', barkGroup: '', // 通知分组(Bark App 里按组折叠),留空 = Bark 默认 - barkTtl: 0, // 通知在 Bark 服务端保留多少秒;0 = Bark 默认 + barkTtl: 0, // 通知在 Bark 服务端保留多少秒;0 = 永久保留 }; const argv = process.argv.slice(2); @@ -381,7 +381,7 @@ export function helpText() { ['logMaxBytes', '--log-max-bytes', 'YUN_XUE_TANG_LOG_MAX_BYTES', LOG_MAX_BYTES, '单文件上限,超出轮转'], ['barkUrl', '--bark-url', 'YUN_XUE_TANG_BARK_URL', maskBarkUrl(BARK_URL), 'Bark 推送地址(含设备 key);留空 = 不推送'], ['barkGroup', '--bark-group', 'YUN_XUE_TANG_BARK_GROUP', BARK_GROUP || '(Bark 默认)', 'Bark 通知分组'], - ['barkTtl', '--bark-ttl', 'YUN_XUE_TANG_BARK_TTL', BARK_TTL, 'Bark 通知在服务端保留秒数;0 = 默认'], + ['barkTtl', '--bark-ttl', 'YUN_XUE_TANG_BARK_TTL', BARK_TTL, 'Bark 通知在服务端保留秒数;0 = 永久保留'], ['(字段 check)', '--check', '', CHECK_ONLY, '只做环境自检,不动进度'], ['(无字段)', '--config', 'YUN_XUE_TANG_CONFIG', CONFIG_FILE || '(内置默认)', '指定配置文件路径'], ]; diff --git a/runner/notify.mjs b/runner/notify.mjs index b075a5a..3eb4900 100644 --- a/runner/notify.mjs +++ b/runner/notify.mjs @@ -7,7 +7,7 @@ // 手动 Ctrl+C 主动停止不推送:人就在键盘前,不需要再提醒一次。 // 通知是附加信息:发送失败只记告警,绝不影响退出码,也不阻塞下一次会话。 // -// Bark 接口:GET https://api.day.app///<body>?group=<分组>&ttl=<秒> +// Bark 接口:GET https://api.day.app/<key>/<title>/<body>?group=<分组>[&ttl=<秒>](省略 ttl = 永久保留) import { formatCredit } from './study.mjs';