chore(dev): 添加格式化配置、Agent指南和代码检查 CI

Author: MingxuanGame

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[*.json]
+indent_size = 2

.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+    push:
+        branches: [main, master]
+    pull_request:
+        branches: [main, master]
+
+jobs:
+    lint-and-format:
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Setup Node.js
+              uses: actions/setup-node@v4
+              with:
+                  node-version: 22
+                  cache: npm
+
+            - name: Install dependencies
+              run: npm ci
+
+            - name: Run ESLint
+              run: npm run lint
+
+            - name: Check formatting
+              run: npm run format:check

.prettierignore

@@ -0,0 +1,4 @@
+dist
+node_modules
+package-lock.json
+.qoder

.prettierrc

@@ -0,0 +1 @@
+{ "semi": false, "singleQuote": true, "tabWidth": 4, "trailingComma": "all", "printWidth": 100 }

AGENTS.md

@@ -0,0 +1,53 @@
+# AGENTS.md
+
+## Project Overview
+
+Brainllo is a Chrome extension that monitors user browsing behavior (tab switches, mouse movements, keyboard input, scrolling, etc.) and calculates cognitive load and physical fatigue levels in real time. Built with React + TypeScript + Vite + CRXJS.
+
+## Tech Stack
+
+- **Language**: TypeScript (strict mode)
+- **Framework**: React 19
+- **Build**: Vite 8 + @crxjs/vite-plugin
+- **Linting**: ESLint 10 (flat config) with typescript-eslint
+- **Formatting**: Prettier
+- **Package Manager**: npm
+
+## Commands
+
+| Command                | Description                          |
+| ---------------------- | ------------------------------------ |
+| `npm run dev`          | Start dev server with HMR            |
+| `npm run build`        | Type-check then build for production |
+| `npm run lint`         | Run ESLint                           |
+| `npm run format`       | Format all files with Prettier       |
+| `npm run format:check` | Check formatting without writing     |
+
+## Code Style
+
+- No semicolons
+- Single quotes
+- 4 spaces indentation
+- Trailing commas
+- Print width: 100 characters
+- LF line endings
+
+## Architecture
+
+- `src/background/` — Service worker, event listeners, cognitive load engine
+- `src/background/engine/` — Core calculation engine (cognitive load, fatigue, calibration)
+- `src/background/helper/` — Analyzers (keyboard, mouse, tab switch, event frequency)
+- `src/content/` — Content scripts injected into web pages
+- `src/models/` — Data models and event type definitions
+- `src/services/` — Service layer (AI, storage, options)
+- `src/popup/` — Extension popup UI (React)
+
+## Guidelines for AI Agents
+
+1. Always run `npm run lint` and `npm run format:check` before considering a task complete.
+2. Follow the existing code style — no semicolons, single quotes, 4-space indent.
+3. Use TypeScript strict typing; avoid `any` unless absolutely necessary.
+4. New event types should extend the base `Event` class in `src/models/events/`.
+5. Background scripts run in a service worker context — no DOM access.
+6. Content scripts have DOM access but run in an isolated world.
+7. Do not modify `dist/` — it is generated by the build process.

README.md

@@ -20,31 +20,30 @@ If you are developing a production application, we recommend updating the config
 
 ```js
 export default defineConfig([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      // Other configs...
+    globalIgnores(['dist']),
+    {
+        files: ['**/*.{ts,tsx}'],
+        extends: [
+            // Other configs...
 
-      // Remove tseslint.configs.recommended and replace with this
-      tseslint.configs.recommendedTypeChecked,
-      // Alternatively, use this for stricter rules
-      tseslint.configs.strictTypeChecked,
-      // Optionally, add this for stylistic rules
-      tseslint.configs.stylisticTypeChecked,
+            // Remove tseslint.configs.recommended and replace with this
+            tseslint.configs.recommendedTypeChecked,
+            // Alternatively, use this for stricter rules
+            tseslint.configs.strictTypeChecked,
+            // Optionally, add this for stylistic rules
+            tseslint.configs.stylisticTypeChecked,
 
-      // Other configs...
-    ],
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.node.json', './tsconfig.app.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-      // other options...
+            // Other configs...
+        ],
+        languageOptions: {
+            parserOptions: {
+                project: ['./tsconfig.node.json', './tsconfig.app.json'],
+                tsconfigRootDir: import.meta.dirname,
+            },
+            // other options...
+        },
     },
-  },
 ])
-
 ```
 
 You can also
@@ -58,24 +57,23 @@ import reactX from 'eslint-plugin-react-x'
 import reactDom from 'eslint-plugin-react-dom'
 
 export default defineConfig([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      // Other configs...
-      // Enable lint rules for React
-      reactX.configs['recommended-typescript'],
-      // Enable lint rules for React DOM
-      reactDom.configs.recommended,
-    ],
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.node.json', './tsconfig.app.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-      // other options...
+    globalIgnores(['dist']),
+    {
+        files: ['**/*.{ts,tsx}'],
+        extends: [
+            // Other configs...
+            // Enable lint rules for React
+            reactX.configs['recommended-typescript'],
+            // Enable lint rules for React DOM
+            reactDom.configs.recommended,
+        ],
+        languageOptions: {
+            parserOptions: {
+                project: ['./tsconfig.node.json', './tsconfig.app.json'],
+                tsconfigRootDir: import.meta.dirname,
+            },
+            // other options...
+        },
     },
-  },
 ])
-
 ```

eslint.config.js

@@ -3,7 +3,7 @@ import globals from 'globals'
 import reactHooks from 'eslint-plugin-react-hooks'
 import reactRefresh from 'eslint-plugin-react-refresh'
 import tseslint from 'typescript-eslint'
-import {defineConfig, globalIgnores} from 'eslint/config'
+import { defineConfig, globalIgnores } from 'eslint/config'
 
 export default defineConfig([
     globalIgnores(['dist']),

index.html

@@ -1,13 +1,13 @@
 <!doctype html>
 <html lang="en">
-<head>
-    <meta charset="UTF-8"/>
-    <link href="/favicon.svg" rel="icon" type="image/svg+xml"/>
-    <meta content="width=device-width, initial-scale=1.0" name="viewport"/>
-    <title>brainllo</title>
-</head>
-<body>
-<div id="root"></div>
-<script src="/src/popup/main.tsx" type="module"></script>
-</body>
+    <head>
+        <meta charset="UTF-8" />
+        <link href="/favicon.svg" rel="icon" type="image/svg+xml" />
+        <meta content="width=device-width, initial-scale=1.0" name="viewport" />
+        <title>brainllo</title>
+    </head>
+    <body>
+        <div id="root"></div>
+        <script src="/src/popup/main.tsx" type="module"></script>
+    </body>
 </html>

package-lock.json

@@ -1,36 +1,39 @@
 {
-  "name": "brainrest",
-  "private": true,
-  "version": "0.0.0",
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc -b && vite build",
-    "debug": "tsc -b && vite build --sourcemap",
-    "lint": "eslint .",
-    "preview": "vite preview"
-  },
-  "dependencies": {
-    "idb": "^8.0.3",
-    "markitdown-html": "^0.1.0",
-    "openai": "^6.48.0",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7"
-  },
-  "devDependencies": {
-    "@crxjs/vite-plugin": "^2.7.1",
-    "@eslint/js": "^10.0.1",
-    "@types/chrome": "^0.2.2",
-    "@types/node": "^24.13.2",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^6.0.3",
-    "eslint": "^10.6.0",
-    "eslint-plugin-react-hooks": "^7.1.1",
-    "eslint-plugin-react-refresh": "^0.5.3",
-    "globals": "^17.7.0",
-    "typescript": "~6.0.2",
-    "typescript-eslint": "^8.62.0",
-    "vite": "^8.1.1"
-  }
+    "name": "brainrest",
+    "private": true,
+    "version": "0.0.0",
+    "type": "module",
+    "scripts": {
+        "dev": "vite",
+        "build": "tsc -b && vite build",
+        "debug": "tsc -b && vite build --sourcemap",
+        "lint": "eslint .",
+        "format": "prettier --write .",
+        "format:check": "prettier --check .",
+        "preview": "vite preview"
+    },
+    "dependencies": {
+        "idb": "^8.0.3",
+        "markitdown-html": "^0.1.0",
+        "openai": "^6.48.0",
+        "react": "^19.2.7",
+        "react-dom": "^19.2.7"
+    },
+    "devDependencies": {
+        "@crxjs/vite-plugin": "^2.7.1",
+        "@eslint/js": "^10.0.1",
+        "@types/chrome": "^0.2.2",
+        "@types/node": "^24.13.2",
+        "@types/react": "^19.2.17",
+        "@types/react-dom": "^19.2.3",
+        "@vitejs/plugin-react": "^6.0.3",
+        "eslint": "^10.6.0",
+        "eslint-plugin-react-hooks": "^7.1.1",
+        "eslint-plugin-react-refresh": "^0.5.3",
+        "globals": "^17.7.0",
+        "prettier": "^3.9.6",
+        "typescript": "~6.0.2",
+        "typescript-eslint": "^8.62.0",
+        "vite": "^8.1.1"
+    }
 }