chore(infra): 继承工作设施并适配 Tauri 项目（CI/发布链/git hooks/部署配置）

Author: Aparencia

.env.example

@@ -0,0 +1,93 @@
+# ===========================================
+# 熵减 (Entropydecrease) 环境变量模板
+# ===========================================
+# 复制此文件为 .env 并填入实际值
+
+# --- 前端 (client/) ---
+
+# Supabase 认证（在 https://supabase.com 创建项目后获取）
+VITE_SUPABASE_URL=https://your-project-id.supabase.co
+VITE_SUPABASE_ANON_KEY=your-anon-key
+
+# 后端服务地址
+VITE_API_BASE_URL=http://localhost:8080
+VITE_AI_GATEWAY_URL=http://localhost:8000
+VITE_API_HEALTH_URL=/api/health
+VITE_SYNC_SERVER_URL=http://localhost:8080
+
+# --- 后端 (server/) ---
+
+# 应用环境（development/production）
+APP_ENV=development
+
+# AI 模型 API Key（在对应平台注册获取）
+# 通义千问：https://dashscope.aliyun.com
+QWEN_API_KEY=sk-your-qwen-api-key
+
+# DeepSeek：https://platform.deepseek.com
+DEEPSEEK_API_KEY=sk-your-deepseek-key
+
+# 智谱 GLM（可选，作为备选模型）：https://open.bigmodel.cn
+GLM_API_KEY=sk-your-glm-api-key
+
+# Gemini（可选，用于视频分析）：https://aistudio.google.com/app/apikey
+GEMINI_API_KEY=your-gemini-api-key
+
+# 数据库（Docker Compose 默认值，本地开发无需修改）
+DATABASE_URL=postgresql://keban:keban_dev@localhost:5432/keban
+REDIS_URL=redis://localhost:6379
+
+# JWT 安全密钥（生产环境必须修改为随机字符串）
+JWT_SECRET=change-this-to-a-random-string-in-production
+
+# Supabase JWT 公钥（从 Supabase Dashboard > Settings > API > JWT Settings 获取）
+# 用于后端服务验证前端 Supabase Auth 签发的 RS256 JWT
+SUPABASE_JWT_SECRET=
+
+# Supabase 项目 URL（用于后端验证 JWT issuer）
+SUPABASE_URL=https://your-project-id.supabase.co
+
+# Supabase 服务端密钥（Service Role Key，仅供服务端调用，禁止暴露给前端）
+SUPABASE_SERVICE_KEY=your-service-role-key
+
+# Supabase JWT 签名算法（HS256/RS256/ES256）
+# SUPABASE_JWT_ALGORITHM=RS256
+
+# 开发者白名单（AI 网关）：逗号分隔的 Supabase user_id 或邮箱，
+# 命中的账号完全豁免平台配额（不限流/不限费用）并赋予 lifetime 最高身份，
+# 仅供开发者自测，切勿在生产环境加入普通用户。
+# DEV_USER_IDS=dev@example.com,uuid-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+
+# 服务端口
+SYNC_SERVICE_PORT=8080
+AI_GATEWAY_PORT=8000
+
+# AI 网关预算控制（每日 token/费用上限，0=不限制）
+# BUDGET_DAILY_TOKEN_LIMIT=100000
+# BUDGET_DAILY_COST_LIMIT=10
+
+# AI 网关开发降级模式（生产环境缺密钥时拒绝启动；仅开发环境可显式开启）
+# GATEWAY_ALLOW_DEV_AUTH=false
+
+# OpenTelemetry 导出端点（可选，配置后网关上报 trace 到 OTLP Collector）
+# OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
+
+# 付费系统（面包多，可选——未配置时付费功能禁用）
+# PAYMENT_PROVIDER=mianbaoduo
+# PAYMENT_API_KEY=your-mianbaoduo-api-key
+# PAYMENT_API_SECRET=your-mianbaoduo-api-secret
+# PAYMENT_WEBHOOK_SECRET=your-webhook-secret
+# PAYMENT_API_BASE_URL=https://api.mianbaoduo.com
+# PAYMENT_TIMEOUT_MS=5000
+# PAYMENT_RETRY_COUNT=3
+
+# --- 生产部署配置 ---
+
+# CORS 允许的前端域名（多个用逗号分隔）
+# CORS_ORIGINS=https://entropydecrease.com,https://www.entropydecrease.com
+
+# 前端 API 基础 URL（生产环境设置为后端服务域名）
+# VITE_API_BASE_URL=https://api.entropydecrease.com
+
+# 日志级别（DEBUG/INFO/WARNING/ERROR）
+# LOG_LEVEL=INFO

.github/dependabot.yml

@@ -0,0 +1,45 @@
+# Dependabot 自动安全更新配置
+# 定期扫描项目各模块的依赖漏洞，自动发起 Pull Request 升级受影响的依赖版本。
+# 详见：https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  # ─── 客户端 npm 依赖 ───
+  # Electron + React 桌面客户端，依赖数量最多，每周扫描安全漏洞
+  - package-ecosystem: "npm"
+    directory: "/client"
+    schedule:
+      interval: "weekly"        # 每周检查一次更新
+    open-pull-requests-limit: 10 # 最多同时保持 10 个 PR，避免维护负担过重
+
+  # ─── 官网 npm 依赖 ───
+  # Next.js 静态官网，依赖相对较少
+  - package-ecosystem: "npm"
+    directory: "/website"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+
+  # ─── AI 网关 pip 依赖 ───
+  # Python FastAPI 后端，负责多模型路由与 AI 调度
+  - package-ecosystem: "pip"
+    directory: "/server/ai-gateway"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+
+  # ─── 同步服务 Go 依赖 ───
+  # Go Gin 后端，负责数据同步与 WebSocket 通道
+  - package-ecosystem: "gomod"
+    directory: "/server/sync-service"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+
+  # ─── GitHub Actions 依赖 ───
+  # CI/CD 流水线中使用的第三方 Action 插件
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5

.github/workflows/pr-check.yml

@@ -0,0 +1,102 @@
+name: PR Quality Check
+
+on:
+  pull_request:
+    branches: [main, dev]
+  push:
+    branches: [dev]
+
+jobs:
+  # ===========================================================================
+  # 路径变更检测 —— 决定哪些子项目需要执行检查
+  # ===========================================================================
+  changes:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      app-frontend: ${{ steps.filter.outputs.app-frontend }}
+      app-rust: ${{ steps.filter.outputs.app-rust }}
+      docs: ${{ steps.filter.outputs.docs }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            app-frontend:
+              - 'app/src/**'
+              - 'app/package.json'
+              - 'app/package-lock.json'
+              - 'app/index.html'
+              - 'app/vite.config.ts'
+              - 'app/tsconfig*.json'
+            app-rust:
+              - 'app/src-tauri/**'
+              - 'app/src-tauri/Cargo.lock'
+            docs:
+              - 'docs/**'
+              - 'scripts/docs-check.mjs'
+              - '.docscheckignore'
+
+  # ===========================================================================
+  # App 前端 —— React + Vite + TypeScript
+  # ===========================================================================
+  app-frontend:
+    needs: changes
+    if: needs.changes.outputs.app-frontend == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+          cache-dependency-path: app/package-lock.json
+      - run: cd app && npm ci
+      - name: Typecheck
+        run: cd app && npx tsc --noEmit
+      - name: Build
+        run: cd app && npm run build
+
+  # ===========================================================================
+  # App Rust 后端 —— Tauri 主进程（含单测与 lint）
+  # ===========================================================================
+  app-rust:
+    needs: changes
+    if: needs.changes.outputs.app-rust == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      # sherpa-onnx 等 crate 编译耗时较长，启用 sccache 加速重复构建
+      - name: Cache cargo registry
+        uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: app/src-tauri
+      - name: Test
+        run: cd app/src-tauri && cargo test
+      - name: Lint (clippy)
+        run: cd app/src-tauri && cargo clippy -- -D warnings
+
+  # ===========================================================================
+  # Docs —— 文档体系一致性检查（链接/索引/命名）
+  # ===========================================================================
+  docs:
+    needs: changes
+    if: needs.changes.outputs.docs == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: Docs check
+        run: node scripts/docs-check.mjs