📝 配合 ScriptCat 1.3.x 更新 @crontab 例子 (#1323)

* 配合 ScriptCat 1.3.x 更新 `@crontab` 例子

* 修正

Author: cyfung1031

example/crontab/crontab-once-expr.js

@@ -0,0 +1,55 @@
+// ==UserScript==
+// @name         once(...) 示例 - 工作时间内每小时执行一次
+// @namespace    https://bbs.tampermonkey.net.cn/
+// @version      0.1.0
+// @description  演示 once(...) 语法：每天 9 时至 17 时期间，每小时执行一次
+// @author       You
+// @crontab      * once(9-17) * * *
+// @grant        GM_log
+// @grant        GM_xmlhttpRequest
+// @connect      httpbin.org
+// ==/UserScript==
+
+/**
+ * `once(expr)` 语法说明：
+ *
+ *   * once(9-17) * * *
+ *   ↑ ↑
+ *   分 时位
+ *
+ * - `once(9-17)` 写在时位：
+ *   - 括号内 `9-17` 是时位的候选值，即只有 9 时至 17 时才会触发
+ *   - `once` 锁定"每小时"这个周期，每小时重置一次
+ *
+ * 效果：每天 9:00–17:59，每小时在当小时内第一次命中时执行，共执行 9 次/天。
+ * 18 时起不再触发，次日 9 时重新开始。
+ *
+ * 与 `* 9-17 * * *` 的区别：
+ *   - `* 9-17 * * *`      每小时的每一分钟都执行（共 60×9 = 540 次/天）
+ *   - `* once(9-17) * * *` 每小时只执行一次（共 9 次/天）
+ *
+ * 常见用途：工作时间内定期轮询、状态检查、数据同步等。
+ */
+return new Promise((resolve, reject) => {
+    const hour = new Date().getHours();
+    GM_log(`当前时间：${hour} 时，本小时内第一次触发，开始执行……`);
+
+    GM_xmlhttpRequest({
+        url: "https://httpbin.org/get",
+        method: "GET",
+        responseType: "json",
+        anonymous: true,
+
+        onload(resp) {
+            if (resp.status === 200) {
+                GM_log(`${hour} 时执行成功，本小时内不再重复。`);
+                resolve("ok");
+            } else {
+                reject(`请求失败，状态码：${resp.status}`);
+            }
+        },
+        onerror() {
+            reject("网络错误，请求失败。");
+        },
+    });
+});

example/crontab/crontab-once.js

@@ -0,0 +1,49 @@
+// ==UserScript==
+// @name         once 示例 - 每天只执行一次
+// @namespace    https://bbs.tampermonkey.net.cn/
+// @version      0.1.0
+// @description  演示 once 语法：每天在工作时间（9-18点）内第一次触发时执行，当天不再重复
+// @author       You
+// @crontab      * 9-18 once * *
+// @grant        GM_log
+// @grant        GM_xmlhttpRequest
+// @connect      httpbin.org
+// ==/UserScript==
+
+/**
+ * `once` 语法说明：
+ *
+ *   * 9-18 once * *
+ *   ↑ ↑    ↑
+ *   分 时   日位的 once
+ *
+ * - 分位 `*`、时位 `9-18`：每天 9:00–18:59 的每分钟都是候选时间
+ * - 日位 `once`：在"每天"这个周期内，只允许执行一次
+ *
+ * 效果：每天工作时间内，第一次触发时执行；执行成功后，当天剩余时间不再执行。
+ * 次日 9 点起重置，重新等待第一次触发。
+ *
+ * 常见用途：每天定时同步、上报、检查类任务。
+ */
+return new Promise((resolve, reject) => {
+    GM_log("今天还没执行过，开始执行……");
+
+    GM_xmlhttpRequest({
+        url: "https://httpbin.org/get",
+        method: "GET",
+        responseType: "json",
+        anonymous: true,
+
+        onload(resp) {
+            if (resp.status === 200) {
+                GM_log("执行成功，今天不会再运行。");
+                resolve("ok");
+            } else {
+                reject(`请求失败，状态码：${resp.status}`);
+            }
+        },
+        onerror() {
+            reject("网络错误，请求失败。");
+        },
+    });
+});