💥 脚本猫 AI Agent

.github/ISSUE_TEMPLATE/bug_report_en.yaml

@@ -14,7 +14,9 @@ body:
     attributes:
       label: "Problem Description"
       description: "What problem occurred? What is the expected normal behavior?"
-      placeholder: "e.g., When clicking the download button on YouTube page, the script throws a 404 error, expected to show a download window"
+      placeholder:
+        "e.g., When clicking the download button on YouTube page, the script throws a 404 error, expected to show a
+        download window"
     validations:
       required: true
 
@@ -37,7 +39,9 @@ body:
     id: scriptcat-version
     attributes:
       label: ScriptCat Version
-      description: You can view it by clicking on the ScriptCat popup window. If possible, please use the latest version as your issue may have already been resolved
+      description:
+        You can view it by clicking on the ScriptCat popup window. If possible, please use the latest version as your
+        issue may have already been resolved
       placeholder: e.g., v0.17.0
     validations:
       required: true

.github/ISSUE_TEMPLATE/feature_request_en.md

@@ -12,7 +12,8 @@ Please clearly describe the feature you want:
 
 ### Use Case
 
-In what situations is this feature needed? (e.g., when processing specific websites, improving operational efficiency, etc.)
+In what situations is this feature needed? (e.g., when processing specific websites, improving operational efficiency,
+etc.)
 
 ### Additional Information
 

.github/copilot-instructions.md

@@ -9,62 +9,77 @@ When performing a code review, respond in Chinese.
 ScriptCat is a sophisticated browser extension that executes user scripts with a unique multi-process architecture:
 
 ### Core Components
-- **Service Worker** (`src/service_worker.ts`) - Main background process handling script management, installations, and chrome APIs
+
+- **Service Worker** (`src/service_worker.ts`) - Main background process handling script management, installations, and
+  chrome APIs
 - **Offscreen** (`src/offscreen.ts`) - Isolated background environment for running background/scheduled scripts
 - **Sandbox** (`src/sandbox.ts`) - Secure execution environment inside offscreen for script isolation
 - **Content Scripts** (`src/content.ts`) - Injected into web pages to execute user scripts
 - **Inject Scripts** (`src/inject.ts`) - Runs in page context with access to page globals
 
 ### Message Passing System
+
 ScriptCat uses a sophisticated message passing architecture (`packages/message/`):
+
 - **ExtensionMessage** - Chrome extension runtime messages between service worker/content/pages
 - **WindowMessage** - PostMessage-based communication between offscreen/sandbox
 - **CustomEventMessage** - CustomEvent-based communication between content/inject scripts
 - **MessageQueue** - Cross-environment event broadcasting system
 
-Key pattern: All communication flows through Service Worker → Offscreen → Sandbox for background scripts, or Service Worker → Content → Inject for page scripts.
+Key pattern: All communication flows through Service Worker → Offscreen → Sandbox for background scripts, or Service
+Worker → Content → Inject for page scripts.
 
 ### Script Execution Flow
+
 1. **Page Scripts**: Service Worker registers with `chrome.userScripts` → injected into pages
 2. **Background Scripts**: Service Worker → Offscreen → Sandbox execution
 3. **Scheduled Scripts**: Cron-based execution in Sandbox environment
 
 ## Key Development Patterns
 
 ### Path Aliases
+
 ```typescript
 "@App": "./src/"
 "@Packages": "./packages/"
 "@Tests": "./tests/"
 ```
 
 ### Repository Pattern
+
 All data access uses DAO classes extending `Repo<T>` base class:
+
 ```typescript
 // Example: ScriptDAO, ResourceDAO, SubscribeDAO
 export class ScriptDAO extends Repo<Script> {
-  public save(val: Script) { return super._save(val.uuid, val); }
+  public save(val: Script) {
+    return super._save(val.uuid, val);
+  }
 }
 ```
 
 ### Service Layer Structure
+
 Services follow a consistent pattern with dependency injection:
+
 ```typescript
 export class ExampleService {
   constructor(
-    private group: Group,           // Message handling group
-    private messageQueue: IMessageQueue,  // Event broadcasting (MessageQueue's interface)
-    private dataDAO: DataDAO        // Data access
+    private group: Group, // Message handling group
+    private messageQueue: IMessageQueue, // Event broadcasting (MessageQueue's interface)
+    private dataDAO: DataDAO // Data access
   ) {}
-  
+
   init() {
     this.group.on("action", this.handleAction.bind(this));
   }
 }
 ```
 
 ### Script Compilation & Sandboxing
+
 User scripts are compiled with sandbox context isolation:
+
 - `compileScriptCode()` - Wraps scripts with error handling and context binding
 - `compileInjectScript()` - Creates window-mounted functions for inject scripts
 - Sandbox uses `with(arguments[0])` for controlled variable access
@@ -77,10 +92,10 @@ User scripts are compiled with sandbox context isolation:
 - **Rspack** - Fast bundler (Webpack alternative) with SWC
 - **TypeScript** - Type-safe development
 
-
 ## Development Workflows
 
 ### Build & Development
+
 ```bash
 pnpm run dev           # Development with source maps
 pnpm run dev:noMap     # Development without source maps (needed for incognito)
@@ -89,44 +104,51 @@ pnpm run pack          # Create browser extension packages
 ```
 
 ### Testing
+
 ```bash
 pnpm test              # Run all tests with Vitest
 pnpm run coverage      # Generate coverage reports
 ```
 
 **Testing Patterns:**
+
 - Uses Vitest with jsdom environment
 - Chrome extension APIs mocked via `@Packages/chrome-extension-mock`
 - Message system testing with `MockMessage` classes
 - Sandbox testing validates script isolation
 
 ### Code Organization
+
 - **Monorepo structure** with packages in `packages/` (message, filesystem, etc.)
 - **Feature-based organization** in `src/app/service/` by environment
 - **Shared utilities** in `src/pkg/` for cross-cutting concerns
 - **Type definitions** in `src/types/` with global declarations
 
 ### Browser Extension Specifics
+
 - **Manifest V3** with service worker background
 - **User Scripts API** for script injection (Chrome/Edge)
-- **Offscreen API** for DOM access in background contexts  
+- **Offscreen API** for DOM access in background contexts
 - **Declarative Net Request** for script installation interception
 
 ## Critical Integration Points
 
 ### Script Installation Flow
+
 1. URL patterns trigger declarative net request rules
 2. Service Worker opens install page with cached script data
 3. Install page validates and processes script metadata
 4. Scripts registered with appropriate execution environment
 
 ### GM API Implementation
+
 - Split between Service Worker (`GMApi`) and Offscreen (`OffscreenGMApi`)
 - Permission verification via `PermissionVerify` service
 - Value storage abstracted through `ValueService`
 - Cross-origin requests handled in service worker context
 
 ### Resource Management
+
 - `ResourceService` handles script dependencies (@require, @resource)
 - Content Security Policy handling for external resources
 - Caching layer via `Cache` class with automatic expiration
@@ -139,33 +161,42 @@ pnpm run coverage      # Generate coverage reports
 - Sandbox script execution isolated from page context - use `unsafeWindow` for page access
 
 ## File Structure Patterns
+
 - Tests co-located with source files (`.test.ts` suffix)
 - Template files use `.tpl` extension for build-time processing
 - Configuration files use factory pattern for environment-specific setup
 
 ## Language
+
 - The code is developed and maintained by developers based in Mainland China.
 - Comments should preferably be written in Simplified Chinese.
 - The user interface supports multiple languages, with English set as the default for global users.
 
 ## PR Review Policy
 
-When performing Pull Request (PR) reviews, Copilot must always conduct a **comprehensive and independent review** of the entire PR content.
+When performing Pull Request (PR) reviews, Copilot must always conduct a **comprehensive and independent review** of the
+entire PR content.
 
 - **Full Review Every Time**  
-  Always review **all modified files** in every PR, regardless of previous reviews or user comments. Even during re-reviews, treat the PR as new and **do not rely on prior review states**.
+  Always review **all modified files** in every PR, regardless of previous reviews or user comments. Even during
+  re-reviews, treat the PR as new and **do not rely on prior review states**.
 
 - **No Skipping of Files**  
-  Do not skip or ignore any text-based file types (including `.md`, `.json`, `.yml`, `.toml`, `.ts`, `.js`, `.py`, `.html`, `.css`, `.tsx`, `.vue`, `.sh`, etc.). Every file that is changed must be fully examined.
+  Do not skip or ignore any text-based file types (including `.md`, `.json`, `.yml`, `.toml`, `.ts`, `.js`, `.py`,
+  `.html`, `.css`, `.tsx`, `.vue`, `.sh`, etc.). Every file that is changed must be fully examined.
 
 - **Reference as Context Only**  
-  PR descriptions, commit messages, or user discussions serve only as **reference context**. The review must focus primarily on the **actual code and file changes**.
+  PR descriptions, commit messages, or user discussions serve only as **reference context**. The review must focus
+  primarily on the **actual code and file changes**.
 
 - **Infer Intent from Code Changes**  
-  Always attempt to **infer the purpose and intent** of the changes directly from the modified content, rather than relying solely on user statements or PR titles.
+  Always attempt to **infer the purpose and intent** of the changes directly from the modified content, rather than
+  relying solely on user statements or PR titles.
 
 - **Critical Thinking Requirement**  
-  For each change, Copilot should assess correctness, consistency, and maintainability — ensuring that logic, style, and architectural impact align with project standards.
+  For each change, Copilot should assess correctness, consistency, and maintainability — ensuring that logic, style, and
+  architectural impact align with project standards.
 
 - **Independent Verification**  
-  Do not assume unchanged files or previously reviewed sections are safe; verify all code paths potentially affected by the modifications.
+  Do not assume unchanged files or previously reviewed sections are safe; verify all code paths potentially affected by
+  the modifications.

.github/workflows/build.yaml

@@ -5,6 +5,7 @@ on:
     branches:
       - main
       - release/*
+      - feature/*
       - dev
     paths-ignore:
       - ".github/**"
@@ -25,7 +26,7 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: 22
-          cache: 'pnpm'
+          cache: "pnpm"
 
       - name: Package with Node
         env:
@@ -51,4 +52,3 @@ jobs:
           name: scriptcat-chrome-extension
           path: |
             dist/ext/*
-

.github/workflows/packageRelease.yml

@@ -18,7 +18,7 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: 22
-          cache: 'pnpm'
+          cache: "pnpm"
 
       - name: Package with Node
         env:

.github/workflows/test.yaml

@@ -5,6 +5,7 @@ on:
     branches:
       - main
       - release/*
+      - feature/*
       - dev
       - develop/*
   pull_request:
@@ -21,7 +22,7 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: 22
-          cache: 'pnpm'
+          cache: "pnpm"
 
       - name: Setup pnpm
         run: corepack enable
@@ -61,7 +62,7 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: 22
-          cache: 'pnpm'
+          cache: "pnpm"
 
       - name: Setup pnpm
         run: corepack enable

.husky/pre-commit

@@ -0,0 +1,13 @@
+#!/bin/sh
+
+pnpm run lint-fix
+
+# 将已暂存且被 lint-fix 修改过的文件重新加入暂存区
+STAGED=$(git diff --cached --name-only --diff-filter=d)
+CHANGED=$(git diff --name-only)
+
+for file in $CHANGED; do
+  case "$STAGED" in
+    *"$file"*) git add "$file" ;;
+  esac
+done

.husky/pre-push

@@ -0,0 +1,35 @@
+#!/bin/sh
+
+# 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
+
+# Only run checks when pushing to main or release/* branches
+remote="$1"
+need_check=0
+
+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)"

.prettierrc

@@ -16,4 +16,4 @@
   "trailingComma": "es5",
   "useTabs": false,
   "endOfLine": "auto"
-}
+}

CONTRIBUTING.md

@@ -46,13 +46,11 @@ git commit -m "✨ add login feature"
 ### 工作流概述
 
 `main` 分支是 ScriptCat 的主分支。为了保持代码的完整性，请不要直接修改 `main`
-分支。你应该创建一个新的分支，并在这个分支上进行修改，然后发起一个目标分支为
-`main` 的 Pull Request。Pull Request
-的标题请尽量使用中文，以便于自动生成更新日志。
+分支。你应该创建一个新的分支，并在这个分支上进行修改，然后发起一个目标分支为 `main` 的 Pull Request。Pull
+Request 的标题请尽量使用中文，以便于自动生成更新日志。
 
-如果你不是 ScriptCat 团队的成员，你可以先 fork 本仓库，然后向本仓库的 `main`
-分支发起 Pull Request。在创建 commit 时，请按照上述 commit message
-规范进行。我们将在 code review 完成后将你的贡献合并到主分支。
+如果你不是 ScriptCat 团队的成员，你可以先 fork 本仓库，然后向本仓库的 `main` 分支发起 Pull
+Request。在创建 commit 时，请按照上述 commit message 规范进行。我们将在 code review 完成后将你的贡献合并到主分支。
 
 ## 撰写文档
 

README.md

@@ -71,7 +71,7 @@ smooth.
 
 | Browser | Store Link                                                                                                                                                                                                                       | Status       |
 | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ |
-| Chrome  | [Stable Version](https://chromewebstore.google.com/detail/scriptcat/ndcooeababalnlpkfedmmbbbgkljhpjf) [Beta Version](https://chromewebstore.google.com/detail/scriptcat-beta/jaehimmlecjmebpekkipmpmbpfhdacom)                  | ✅ Available |
+| Chrome  | [Stable Version](https://chromewebstore.google.com/detail/scriptcat/ndcooeababalnlpkfedmmbbbgkljhpjf) [Beta Version](https://chromewebstore.google.com/detail/scriptcat-beta/jaehimmlecjmebpekkipmpmbpfhdacom)                   | ✅ Available |
 | Edge    | [Stable Version](https://microsoftedge.microsoft.com/addons/detail/scriptcat/liilgpjgabokdklappibcjfablkpcekh) [Beta Version](https://microsoftedge.microsoft.com/addons/detail/scriptcat-beta/nimmbghgpcjmeniofmpdfkofcedcjpfi) | ✅ Available |
 | Firefox | [Stable Version](https://addons.mozilla.org/en/firefox/addon/scriptcat/) [Beta Version](https://addons.mozilla.org/en/firefox/addon/scriptcat-pre/)                                                                              | ✅ MV2       |
 

README_RU.md

@@ -69,11 +69,11 @@ ScriptCat — это мощный менеджер пользовательск
 
 #### Магазины расширений (рекомендуется)
 
-| Браузер | Ссылка на магазин | Статус |
-| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- |
-| Chrome  | [Стабильная версия](https://chromewebstore.google.com/detail/scriptcat/ndcooeababalnlpkfedmmbbbgkljhpjf) / [Beta](https://chromewebstore.google.com/detail/scriptcat-beta/jaehimmlecjmebpekkipmpmbpfhdacom) | ✅ Доступно |
+| Браузер | Ссылка на магазин                                                                                                                                                                                                             | Статус      |
+| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
+| Chrome  | [Стабильная версия](https://chromewebstore.google.com/detail/scriptcat/ndcooeababalnlpkfedmmbbbgkljhpjf) / [Beta](https://chromewebstore.google.com/detail/scriptcat-beta/jaehimmlecjmebpekkipmpmbpfhdacom)                   | ✅ Доступно |
 | Edge    | [Стабильная версия](https://microsoftedge.microsoft.com/addons/detail/scriptcat/liilgpjgabokdklappibcjfablkpcekh) / [Beta](https://microsoftedge.microsoft.com/addons/detail/scriptcat-beta/nimmbghgpcjmeniofmpdfkofcedcjpfi) | ✅ Доступно |
-| Firefox | [Стабильная версия](https://addons.mozilla.org/firefox/addon/scriptcat/) / [Beta](https://addons.mozilla.org/firefox/addon/scriptcat-pre/) | ✅ MV2 |
+| Firefox | [Стабильная версия](https://addons.mozilla.org/firefox/addon/scriptcat/) / [Beta](https://addons.mozilla.org/firefox/addon/scriptcat-pre/)                                                                                    | ✅ MV2      |
 
 #### Ручная установка