Refactor/v3 product grade

.github/workflows/deploy.yml

@@ -0,0 +1,36 @@
+name: Deploy
+
+on:
+  push:
+    branches: [main, master]
+  workflow_dispatch: # 允许手动触发
+
+jobs:
+  deploy:
+    name: Deploy to Cloudflare Workers
+    runs-on: ubuntu-latest
+    # 需要在 GitHub 仓库 Settings → Secrets 配置：
+    #   CLOUDFLARE_API_TOKEN  (Workers 编辑 + KV 编辑权限)
+    #   CLOUDFLARE_ACCOUNT_ID (可选；Token 可锁定到单 account)
+    steps:
+      - 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: Lint + Test (deploy 前最后一道防线)
+        run: |
+          npm run lint
+          npm test
+
+      - name: Deploy to Cloudflare Workers
+        run: npm run deploy:safe
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

.github/workflows/test.yml

@@ -0,0 +1,29 @@
+name: Test
+
+on:
+  push:
+    branches: [main, master, 'refactor/**']
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  test:
+    name: Lint + Unit Tests
+    runs-on: ubuntu-latest
+    steps:
+      - 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: Type check (JSDoc + // @ts-check)
+        run: npm run lint
+
+      - name: Run unit tests
+        run: npm test

.gitignore

@@ -1,3 +1,20 @@
+node_modules/
 .wrangler/
 .codeflicker/
-package-lock.json
+dist/
+coverage/
+.DS_Store
+
+# 本地调研与草稿，不入库
+优化文档/
+CHANGELOG-TEST.md
+docs/
+
+# AI 工具本地配置
+.codex/
+.agents/
+
+# 环境变量
+.env
+.env.*
+.dev.vars