feat: Bark 通知默认不设置 ttl,永久保留

barkTtl 默认由 600 改为 0:0 时 buildBarkUrl 不追加 ttl 参数,通知在 Bark
服务端不会过期。示例配置与文档同步说明。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
voidandClaude Sonnet 4.6 committed 2026-11-03 10:46:08 +00:00
1 parent 9511237649
commit c7914d67c7
5 files changed
+9 -9

No files matched your search

+2 -2
View File
@@ -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
+2 -2
View File
@@ -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
+2 -2
View File
@@ -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(重定向/计划任务)时自动关闭 */
+2 -2
View File
@@ -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 || '(内置默认)', '指定配置文件路径'],
];
+1 -1
View File
@@ -7,7 +7,7 @@
// 手动 Ctrl+C 主动停止不推送:人就在键盘前,不需要再提醒一次。
// 通知是附加信息:发送失败只记告警,绝不影响退出码,也不阻塞下一次会话。
//
// Bark 接口:GET https://api.day.app/<key>/<title>/<body>?group=<分组>&ttl=<秒>
// Bark 接口:GET https://api.day.app/<key>/<title>/<body>?group=<分组>[&ttl=<秒>](省略 ttl = 永久保留)
import { formatCredit } from './study.mjs';