Merge branch 'release/v1.4' into develop/add-no-csp-option

Author: cyfung1031

.github/pull_request_template.md

@@ -1,15 +1,13 @@
-## 概述 Descriptions
+## Checklist / 检查清单
 
-<!-- 如果有关联的 issue，请在下面记载 -->
-<!-- Describe related issue(s) if any. -->
-<!-- close #xxx -->
+- [ ] Fixes mentioned issues / 修复已提及的问题
+- [ ] Code reviewed by human / 代码通过人工检查
+- [ ] Changes tested / 已完成测试
 
-## 变更内容 Changes
+## Description / 描述
 
-<!-- - 这个 PR 做了什么？ -->
-<!-- - What does this PR do? -->
+<!-- Description / PR 描述 -->
 
-### 截图 Screenshots
+## Screenshots / 截图
 
-<!-- 如果可以展示页面，请务必附上截图 -->
-<!-- If it can be illustrated, please provide a screenshot. -->
+<!-- Screenshots / 截图-->

.gitignore

@@ -39,3 +39,5 @@ CLAUDE.md
 
 test-results
 playwright-report
+
+superpowers

.husky/pre-commit

@@ -1,13 +1,35 @@
 #!/bin/sh
 
-pnpm run lint-fix
+# Skip checks: SKIP_PRE_PUSH=1 git push or git push --no-verify
+if [ "$SKIP_PRE_PUSH" = "1" ]; then
+  echo "⏭ SKIP_PRE_PUSH=1, skipping pre-push checks"
+  exit 0
+fi
 
-# 将已暂存且被 lint-fix 修改过的文件重新加入暂存区
-STAGED=$(git diff --cached --name-only --diff-filter=d)
-CHANGED=$(git diff --name-only)
+# Only run checks when pushing to main or release/* branches
+remote="$1"
+need_check=0
 
-for file in $CHANGED; do
-  case "$STAGED" in
-    *"$file"*) git add "$file" ;;
-  esac
+while read local_ref local_sha remote_ref remote_sha; do
+  branch=$(echo "$remote_ref" | sed 's|refs/heads/||')
+
+  if [ "$branch" = "main" ] || echo "$branch" | grep -q "^release/"; then
+    need_check=1
+    echo "🔍 Detected push target: $branch"
+  fi
 done
+
+if [ "$need_check" = "0" ]; then
+  exit 0
+fi
+
+echo ""
+echo "▶ Running lint..."
+pnpm run lint || exit 1
+
+echo ""
+echo "▶ Running tests..."
+pnpm run test:ci || exit 1
+
+echo ""
+echo "✅ All checks passed! (build and e2e tests will run in CI)"

.husky/pre-push

@@ -15,9 +15,9 @@ async function openToolsPage(context: Parameters<typeof openOptionsPage>[0], ext
   return page;
 }
 
-/** 获取「开发调试」卡片区域的定位器 */
+/** 获取「开发工具」卡片区域的定位器 */
 function getDevCard(page: Page) {
-  // 开发调试 / Development Debugging 卡片是页面上第二个 Card
+  // 开发工具 / Development Tool 卡片是页面上第二个 Card
   return page.locator(".arco-card").nth(1);
 }
 
@@ -106,7 +106,7 @@ test.describe("VSCode 连接", () => {
     const card = getDevCard(page);
 
     // 卡片标题
-    await expect(card.getByText(/development debugging|开发调试/i)).toBeVisible();
+    await expect(card.getByText(/development tool|开发工具/i)).toBeVisible();
 
     // VSCode URL 输入框
     const urlInput = card.locator(".arco-input");

e2e/vscode-connect.spec.ts

@@ -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-expr.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("网络错误，请求失败。");
+        },
+    });
+});

example/crontab/crontab-once.js

@@ -0,0 +1,23 @@
+// ==UserScript==
+// @name         window.onurlchange 示例
+// @namespace    https://bbs.tampermonkey.net.cn/
+// @version      0.1.0
+// @description  监听页面 URL 变化（兼容 Tampermonkey）
+// @author       You
+// @match        *://*/*
+// @grant        window.onurlchange
+// ==/UserScript==
+
+if (window.onurlchange === null) {
+  // feature is supported
+
+  // 方式一：使用 window.onurlchange 赋值
+  window.onurlchange = function (e) {
+    console.log("URL changed to:", e.url);
+  };
+
+  // 方式二：使用 addEventListener
+  window.addEventListener("urlchange", function (e) {
+    console.log("URL changed (addEventListener):", e.url);
+  });
+}

example/crontab.js example/crontab/crontab.jsexample/crontab.js renamed to example/crontab/crontab.js

@@ -1,6 +1,6 @@
 {
   "name": "scriptcat",
-  "version": "1.4.0-beta",
+  "version": "1.4.0-beta.1",
   "description": "脚本猫,一个可以执行用户脚本的浏览器扩展,万物皆可脚本化,让你的浏览器可以做更多的事情!",
   "author": "CodFrm",
   "license": "GPLv3",
@@ -55,7 +55,7 @@
     "string-similarity-js": "^2.1.4",
     "uuid": "^11.1.0",
     "webdav": "^5.9.0",
-    "yaml": "^2.8.1"
+    "yaml": "^2.8.3"
   },
   "devDependencies": {
     "@eslint/compat": "^1.4.1",
@@ -75,6 +75,8 @@
     "@types/serviceworker": "^0.0.120",
     "@unocss/postcss": "66.5.4",
     "@vitest/coverage-v8": "^4.0.18",
+    "acorn": "^8.16.0",
+    "uglify-js":"^3.19.3",
     "autoprefixer": "^10.4.21",
     "cross-env": "^10.1.0",
     "crx": "^5.0.1",
@@ -89,6 +91,7 @@
     "iconv-lite": "^0.7.2",
     "jsdom": "^26.1.0",
     "jszip": "^3.10.1",
+    "magic-string": "^0.30.21",
     "mock-xmlhttprequest": "^8.4.1",
     "postcss": "^8.5.6",
     "postcss-loader": "^8.2.0",