注释修订

Author: cyfung1031

src/pkg/utils/cron.ts

@@ -11,29 +11,32 @@ import { t } from "@App/locales/locales";
 //   https://docs.scriptcat.org/docs/dev/background/#%E5%AE%9A%E6%97%B6%E8%84%9A%E6%9C%AC
 //
 // 在线工具测试 cron 表达式：
-//   https://crontab.guru/
+//   https://crontab.guru/ (英文，标准5位格式)
+//   https://tool.lu/crontab/ (中文，标准5位及扩展6位格式)
 //
-// ─────────────────────────── Cron 表达式格式 ───────────────────────────
+// ────────────────────────────────── Cron 表达式格式 ──────────────────────────────────
 //
 // 支持以下两种 cron 表达式：
-// - 5 位格式：分 时 日 月 周
-// - 6 位格式：秒 分 时 日 月 周
+// - 标准 5 位格式：分 时 日 月 周
+// - 扩展 6 位格式：秒 分 时 日 月 周
 //
-// ─────────────────────────── 字段取值规则 ───────────────────────────
+// 注：6位扩展格式会使脚本每秒执行，浏览器JavaScript环境无法精准每秒执行，而且对CPU负担大，并不推荐
+//
+// ────────────────────────────────── 字段取值规则 ──────────────────────────────────
 //
 // 支持以下取值写法：
 // - `*`        ：任意值
-// - `1-3,5`   ：范围或离散值
-// - `*/2`     ：步长（每隔 N 个单位）
+// - `1-3,5`    ：范围或离散值
+// - `*/2`      ：步长（每隔 N 个单位）
 // - `once`
 // - `once(*)`
 // - `once(...)`：
 //   表示在某个周期内仅执行一次（ScriptCat 扩展语法）
 //
-// ─────────────────────────── 字段取值范围 ───────────────────────────
+// ────────────────────────────────── 字段取值范围 ──────────────────────────────────
 //
 // 字段   | 允许值
-// ------ | ------------------------------------------------
+// ------ | ------------------------------------------
 // 秒     | 0 - 59
 // 分     | 0 - 59
 // 时     | 0 - 23
@@ -50,11 +53,11 @@ const DateTime = new CronTime("* * * * *").sendAt().constructor;
 /**
  * once 在不同 cron 位置上的语义映射表。
  *
- * key 表示 once 所在的 cron 位（1 ~ 5，不包含秒位）。
+ * key 表示 once 所在的 cron 位（1 ~ 5，忽略秒位）。
  *
  * 示例：
- * - "* once * * * *"  → 每小时执行一次
- * - "* * once * * *"  → 每天执行一次
+ * - "* once * * *"  → 每小时执行一次
+ * - "* * once * *"  → 每天执行一次
  */
 const ONCE_MAP = {
   1: { unit: "minute", format: "yyyy-MM-dd HH:mm:ss", label: "minute" },