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 检查通过"

.github/workflows/release.yml

@@ -18,13 +18,14 @@ permissions:
 
 jobs:
   # ─────────────────────────────────────────────────────────────
-  # 预检：发布前必须通过 CI
+  # 预检：版本号校验 + 与 pyproject.toml 一致性检查
   # ─────────────────────────────────────────────────────────────
   pre-check:
     name: Pre-release Check
     runs-on: ubuntu-latest
     outputs:
       version: ${{ steps.meta.outputs.version }}
+      tag: ${{ steps.meta.outputs.tag }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -65,7 +66,7 @@ jobs:
           fi
 
   # ─────────────────────────────────────────────────────────────
-  # 构建：后端 wheel（纯 Python，单平台即可）+ 前端 dist
+  # 构建：wheel + sdist（纯 Python，单平台即可）
   # ─────────────────────────────────────────────────────────────
   build:
     name: Build Artifacts
@@ -86,70 +87,26 @@ jobs:
         with:
           python-version: '3.13'
 
-      - name: 安装 pnpm（前端构建依赖）
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
+      - name: 安装依赖
+        run: uv sync --extra dev --frozen
 
-      - name: 设置 Node 22（前端构建）
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: pnpm
-          cache-dependency-path: frontend/pnpm-lock.yaml
-
-      - name: 安装前端依赖（缓存）
-        working-directory: frontend
-        run: pnpm install --frozen-lockfile
-
-      - name: 构建后端 wheel + sdist（自动触发前端构建）
+      - name: 构建 wheel + sdist
         run: uv build
 
-      - name: 上传后端产物
-        uses: actions/upload-artifact@v4
-        with:
-          name: backend-dist
-          path: dist/*
-          retention-days: 30
-
-  build-frontend:
-    name: Build Frontend
-    needs: pre-check
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: 安装 pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: 设置 Node 22
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: pnpm
-          cache-dependency-path: frontend/pnpm-lock.yaml
-
-      - name: 安装依赖
-        working-directory: frontend
-        run: pnpm install --frozen-lockfile
-
-      - name: 构建
-        working-directory: frontend
-        run: pnpm run build
-
-      - name: 打包前端 dist
+      - name: 校验产物
         run: |
-          cd frontend
-          zip -r ../endo-frontend-${{ needs.pre-check.outputs.version }}.zip dist
+          echo "待上传产物："
+          ls -la dist/
+          if [ -z "$(ls -A dist/*.whl dist/*.tar.gz 2>/dev/null)" ]; then
+            echo "❌ 未找到 wheel 或 sdist 产物"
+            exit 1
+          fi
 
-      - name: 上传前端产物
+      - name: 上传构建产物
         uses: actions/upload-artifact@v4
         with:
-          name: frontend-dist-release
-          path: endo-frontend-*.zip
+          name: dist
+          path: dist/*
           retention-days: 30
 
   # ─────────────────────────────────────────────────────────────
@@ -161,25 +118,16 @@ jobs:
     runs-on: ubuntu-latest
     environment:
       name: pypi
-      url: https://pypi.org/project/endo/${{ needs.pre-check.outputs.version }}
+      url: https://pypi.org/project/pyflowx/${{ needs.pre-check.outputs.version }}
     permissions:
       id-token: write
     steps:
-      - name: 下载后端构建产物
+      - name: 下载构建产物
         uses: actions/download-artifact@v4
         with:
-          name: backend-dist
+          name: dist
           path: dist
 
-      - name: 校验产物
-        run: |
-          echo "待上传产物："
-          ls -la dist/
-          if [ -z "$(ls -A dist/*.whl dist/*.tar.gz 2>/dev/null)" ]; then
-            echo "❌ 未找到 wheel 或 sdist 产物"
-            exit 1
-          fi
-
       - name: 上传到 PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
         with:
@@ -190,7 +138,7 @@ jobs:
   # ─────────────────────────────────────────────────────────────
   release:
     name: Publish Release
-    needs: [pre-check, build, build-frontend, publish-pypi]
+    needs: [pre-check, build, publish-pypi]
     runs-on: ubuntu-latest
     permissions:
       contents: write
@@ -198,39 +146,31 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: 下载所有构建产物
+      - name: 下载构建产物
         uses: actions/download-artifact@v4
         with:
-          path: release-assets
+          name: dist
+          path: assets
 
       - name: 整理发布产物
         run: |
-          mkdir -p assets
-          find release-assets -name "*.whl" -exec cp {} assets/ \;
-          find release-assets -name "*.tar.gz" -exec cp {} assets/ \;
-          find release-assets -name "*.zip" -exec cp {} assets/ \;
           ls -la assets/
 
       - name: 生成 Release Notes
         id: notes
         run: |
           {
-            echo "## endo ${{ needs.pre-check.outputs.version }}"
+            echo "## pyflowx ${{ needs.pre-check.outputs.version }}"
             echo ""
             echo "### 下载"
             echo ""
-            echo "- **后端 wheel**: \`endo-${{ needs.pre-check.outputs.version }}-py3-none-any.whl\`"
-            echo "- **源码包**: \`endo-${{ needs.pre-check.outputs.version }}.tar.gz\`"
-            echo "- **前端 dist**: \`endo-frontend-${{ needs.pre-check.outputs.version }}.zip\`"
+            echo "- **Wheel**: \`pyflowx-${{ needs.pre-check.outputs.version }}-py3-none-any.whl\`"
+            echo "- **源码包**: \`pyflowx-${{ needs.pre-check.outputs.version }}.tar.gz\`"
             echo ""
             echo "### 安装"
             echo ""
             echo '```bash'
-            echo "# 后端"
-            echo "pip install endo-${{ needs.pre-check.outputs.version }}-py3-none-any.whl"
-            echo ""
-            echo "# 前端"
-            echo "unzip endo-frontend-${{ needs.pre-check.outputs.version }}.zip -d frontend-dist"
+            echo "pip install pyflowx==${{ needs.pre-check.outputs.version }}"
             echo '```'
             echo ""
             echo "### 完整变更日志"
@@ -245,7 +185,7 @@ jobs:
         uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ needs.pre-check.outputs.tag }}
-          name: endo ${{ needs.pre-check.outputs.version }}
+          name: pyflowx ${{ needs.pre-check.outputs.version }}
           body: ${{ steps.notes.outputs.content }}
           files: assets/*
           draft: false