refactor: 重构代码风格与配置，完善文档与CI

1. 移除冗余导入与简化代码写法
2. 更新coverage配置与pre-commit钩子
3. 重构CI流程，拆分lint/typecheck/test任务
4. 汉化项目文档与注释
5. 修正graphlib导入的类型忽略注释

.github/workflows/ci.yml

@@ -13,20 +13,75 @@ concurrency:
 
 jobs:
   # ─────────────────────────────────────────────────────────────
-  # 后端：多平台 × 多 Python 版本矩阵测试
+  # lint：代码风格与格式检查（单平台即可）
   # ─────────────────────────────────────────────────────────────
-  backend-test:
-    name: Backend (${{ matrix.os }} / py${{ matrix.python-version }})
+  lint:
+    name: Lint (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: 安装 uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: latest
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: 设置 Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: 安装依赖
+        run: uv sync --extra dev --frozen
+
+      - name: Ruff 检查
+        run: uv run ruff check src tests examples
+
+      - name: Ruff 格式检查
+        run: uv run ruff format --check src tests examples
+
+  # ─────────────────────────────────────────────────────────────
+  # typecheck：mypy 严格类型检查
+  # ─────────────────────────────────────────────────────────────
+  typecheck:
+    name: Typecheck (mypy)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: 安装 uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: latest
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: 设置 Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: 安装依赖
+        run: uv sync --extra dev --frozen
+
+      - name: Mypy 严格类型检查
+        run: uv run mypy
+
+  # ─────────────────────────────────────────────────────────────
+  # test：多平台 × 多 Python 版本矩阵测试 + 覆盖率
+  # ─────────────────────────────────────────────────────────────
+  test:
+    name: Test (${{ matrix.os }} / py${{ matrix.python-version }})
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
-        python-version: ['3.13', '3.14']
-        exclude:
-          # macOS + py3.14 暂时跳过（部分依赖未发布 wheel）
-          - os: macos-latest
-            python-version: '3.14'
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13']
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -46,16 +101,14 @@ jobs:
       - name: 安装依赖
         run: uv sync --extra dev --frozen
 
-      - name: Ruff 检查
-        run: uv run ruff check backend/endo tests
+      - name: 运行测试（含覆盖率，强制 100%）
+        run: uv run pytest -v --cov=pyflowx --cov-report=xml --cov-report=term-missing --cov-fail-under=100
 
-      - name: Ruff 格式检查
-        run: uv run ruff format --check backend/endo tests
-
-      - name: 运行测试
-        env:
-          PYTHONPATH: backend
-        run: uv run pytest -v --cov=endo --cov-report=xml --cov-report=term-missing
+      - name: 运行示例冒烟测试
+        run: |
+          uv run python examples/etl_pipeline.py
+          uv run python examples/parallel_run.py
+          uv run python examples/async_aggregation.py
 
       - name: 上传覆盖率
         if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
@@ -66,66 +119,20 @@ jobs:
           retention-days: 7
 
   # ─────────────────────────────────────────────────────────────
-  # 前端：多平台构建验证
-  # ─────────────────────────────────────────────────────────────
-  frontend-build:
-    name: Frontend (${{ matrix.os }} / node${{ matrix.node-version }})
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest]
-        node-version: [20, 22]
-    defaults:
-      run:
-        working-directory: frontend
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: 安装 pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: 设置 Node ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: pnpm
-          cache-dependency-path: frontend/pnpm-lock.yaml
-
-      - name: 安装依赖
-        run: pnpm install --frozen-lockfile
-
-      - name: TypeScript 类型检查
-        run: npx tsc --noEmit -p tsconfig.app.json
-
-      - name: 构建
-        run: pnpm run build
-
-      - name: 上传构建产物
-        if: matrix.os == 'ubuntu-latest' && matrix.node-version == 22
-        uses: actions/upload-artifact@v4
-        with:
-          name: frontend-dist
-          path: frontend/dist
-          retention-days: 7
-
-  # ─────────────────────────────────────────────────────────────
-  # 聚合：所有测试通过后才标记完成
+  # 聚合：所有检查通过后才标记完成
   # ─────────────────────────────────────────────────────────────
   ci-pass:
     name: CI Pass
     runs-on: ubuntu-latest
-    needs: [backend-test, frontend-build]
+    needs: [lint, typecheck, test]
     if: always()
     steps:
       - name: 检查依赖任务结果
-        if: ${{ needs.backend-test.result != 'success' || needs.frontend-build.result != 'success' }}
+        if: ${{ needs.lint.result != 'success' || needs.typecheck.result != 'success' || needs.test.result != 'success' }}
         run: |
-          echo "backend-test: ${{ needs.backend-test.result }}"
-          echo "frontend-build: ${{ needs.frontend-build.result }}"
+          echo "lint: ${{ needs.lint.result }}"
+          echo "typecheck: ${{ needs.typecheck.result }}"
+          echo "test: ${{ needs.test.result }}"
           exit 1
       - name: 全部通过
         run: echo "✅ 所有 CI 检查通过"