feat: optimize workflows and build scripts

- ci.yml (原 build_doc.yml)：合并 lychee check job（check→build 串行）、
  改用 setup-node 内置 yarn cache、workflow 命名改为 CI
- 删除 check.yml（已并入 ci.yml）
- 删除 update.yml，新增 dependabot.yml（npm + github-actions 每周自动 PR）
- sync-contentful.yml (原 app_from_contentful.yml)：git-auto-commit@v5、
  job id build→generate、workflow 命名规范化
- sync-catalog.yml (原 json2md.yml)：git-auto-commit@v5、job id build→generate、
  6 个分散 step 合并为 1 个 Generate all Markdown files step
- builds/sync_contentful.py (原 gen_md_from_contenful.py)：修正拼写错误 contenful→contentful
- builds/gen_app_index.py (原 json2md.py)：语义化重命名
- builds/gen_allapps.py：修复 import sys 缺失（避免 NameError）
- DEVELOPMENT.md：同步更新 CI 工作流说明表格

Author: zhaojing1987

.github/dependabot.yml

@@ -0,0 +1,19 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 3
+    labels:
+      - "dependencies"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"

.github/workflows/check.yml

@@ -1,8 +1,8 @@
-# 文档构建与部署工作流
-# - dev 分支：只构建，不部署（用于验证 PR 不破坏构建）
-# - main 分支：构建 + 部署到 Cloudflare Pages（生产环境）
+# CI 主工作流
+# - check job：lychee 外链检查（仅 dev push / PR，main 跳过）
+# - build job：Docusaurus 构建，依赖 check 通过；main 分支额外部署到 Cloudflare Pages
 
-name: Docs Build and Upload to Cloudflare
+name: CI
 
 on:
   workflow_dispatch:
@@ -37,23 +37,47 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  check:
+    name: Broken Links Check
+    runs-on: ubuntu-latest
+    if: github.ref != 'refs/heads/main'
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check broken links
+        uses: lycheeverse/lychee-action@v2
+        with:
+          args: >-
+            --verbose
+            --no-progress
+            --exclude-path node_modules
+            --exclude-path build
+            versioned_docs/
+            i18n/
+          fail: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload lychee results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: lychee-report
+          path: lychee/out.md
+          retention-days: 7
+
   build:
     name: Build on branch ${{ github.ref_name }}
     runs-on: ubuntu-latest
+    needs: check
+    if: always() && (needs.check.result == 'success' || needs.check.result == 'skipped')
     steps:
     - uses: actions/checkout@v4
 
     - uses: actions/setup-node@v4
       with:
         node-version: 20
-
-    - name: Cache yarn dependencies
-      uses: actions/cache@v4
-      with:
-        path: node_modules
-        key: ${{ runner.os }}-yarn-${{ hashFiles('**/package.json') }}
-        restore-keys: |
-          ${{ runner.os }}-yarn-
+        cache: 'yarn'
 
     - name: Docusaurus build
       run: |

.github/workflows/build_doc.yml .github/workflows/ci.yml.github/workflows/build_doc.yml renamed to .github/workflows/ci.yml

@@ -2,15 +2,15 @@
 # 触发方式：手动触发 或 repository_dispatch（事件名: applist_dev_event）。
 # repository_dispatch 由 Websoft9 主仓库 release 时自动触发。
 
-name: Generate Apps list for docs
+name: Sync App Catalog
 
 on:
   workflow_dispatch:
   repository_dispatch:
     types: [applist_dev_event]
 
 jobs:
-  build:
+  generate:
     runs-on: ubuntu-latest
 
     steps:
@@ -31,32 +31,18 @@ jobs:
             -o media-latest.zip https://artifact.websoft9.com/release/websoft9/plugin/media/media-latest.zip
           unzip media-latest.zip "media/json/product_zh.json" "media/json/product_en.json" "media/json/catalog_zh.json" "media/json/catalog_en.json" -d ./extracted
 
-      - name: Generate Markdown for app catalog README.mdx(zh)
-        run: |
-          python builds/json2md.py --json_file ./extracted/media/json/product_zh.json --output_file versioned_docs/version-2.0/apps/README.mdx --ignore-list template/meta/skip_applink.json
-
-      - name: Generate Markdown for app catalog README.mdx(en)
-        run: |
-          python builds/json2md.py --json_file ./extracted/media/json/product_en.json --output_file i18n/en/docusaurus-plugin-content-docs/version-2.0/apps/README.mdx --ignore-list template/meta/skip_applink.json
-
-      - name: Generate Markdown for allcatalogs.md(zh)
+      - name: Generate all Markdown files
         run: |
+          # zh
+          python builds/gen_app_index.py --json_file ./extracted/media/json/product_zh.json --output_file versioned_docs/version-2.0/apps/README.mdx --ignore-list template/meta/skip_applink.json
           python builds/gen_allcatalogs.py --json_file ./extracted/media/json/catalog_zh.json --output_file versioned_docs/version-2.0/apps/_include/allcatalogs.md
-
-      - name: Generate Markdown for allcatalogs.md(en)
-        run: |
-          python builds/gen_allcatalogs.py --json_file ./extracted/media/json/catalog_en.json --output_file i18n/en/docusaurus-plugin-content-docs/version-2.0/apps/_include/allcatalogs.md
-
-      - name: Generate Markdown for allapps.md(zh)
-        run: |
           python builds/gen_allapps.py --json_file ./extracted/media/json/product_zh.json --output_file versioned_docs/version-2.0/apps/_include/allapps.md
-
-      - name: Generate Markdown for allapps.md(en)
-        run: |
+          # en
+          python builds/gen_app_index.py --json_file ./extracted/media/json/product_en.json --output_file i18n/en/docusaurus-plugin-content-docs/version-2.0/apps/README.mdx --ignore-list template/meta/skip_applink.json
+          python builds/gen_allcatalogs.py --json_file ./extracted/media/json/catalog_en.json --output_file i18n/en/docusaurus-plugin-content-docs/version-2.0/apps/_include/allcatalogs.md
           python builds/gen_allapps.py --json_file ./extracted/media/json/product_en.json --output_file i18n/en/docusaurus-plugin-content-docs/version-2.0/apps/_include/allapps.md
 
       - name: Commit and push changes
-        uses: stefanzweifel/git-auto-commit-action@v4
+        uses: stefanzweifel/git-auto-commit-action@v5
         with:
           commit_message: Update Product Catalog Markdown
-

.github/workflows/json2md.yml .github/workflows/sync-catalog.yml.github/workflows/json2md.yml renamed to .github/workflows/sync-catalog.yml

@@ -2,13 +2,13 @@
 # 触发方式：管理员手动触发（workflow_dispatch），需要仓库 Write 权限 + CONTENTFUL_ACCESS_TOKEN。
 # 注意：该 workflow 生成的 _include/ 文件不应手工修改，属于自动管理内容。
 
-name: Generate Apps header and appdocs files
+name: Sync from Contentful
 
 on:
   workflow_dispatch:
 
 jobs:
-  build:
+  generate:
     runs-on: ubuntu-latest
 
     steps:
@@ -31,12 +31,12 @@ jobs:
       env:
         CONTENTFUL_ACCESS_TOKEN: ${{ secrets.CONTENTFUL_GRAPHQLTOKEN }}
       run: |
-        python builds/gen_md_from_contenful.py template/meta/zh_head.jinja2 versioned_docs/version-2.0/apps/_include
-        python builds/gen_md_from_contenful.py template/meta/en_head.jinja2 i18n/en/docusaurus-plugin-content-docs/version-2.0/apps/_include
-        python builds/gen_md_from_contenful.py template/meta/zh_app.jinja2 versioned_docs/version-2.0/apps --ignore-list template/meta/skip_file.json
-        python builds/gen_md_from_contenful.py template/meta/en_app.jinja2 i18n/en/docusaurus-plugin-content-docs/version-2.0/apps --ignore-list template/meta/skip_file.json
+        python builds/sync_contentful.py template/meta/zh_head.jinja2 versioned_docs/version-2.0/apps/_include
+        python builds/sync_contentful.py template/meta/en_head.jinja2 i18n/en/docusaurus-plugin-content-docs/version-2.0/apps/_include
+        python builds/sync_contentful.py template/meta/zh_app.jinja2 versioned_docs/version-2.0/apps --ignore-list template/meta/skip_file.json
+        python builds/sync_contentful.py template/meta/en_app.jinja2 i18n/en/docusaurus-plugin-content-docs/version-2.0/apps --ignore-list template/meta/skip_file.json
         
     - name: Commit and push changes
-      uses: stefanzweifel/git-auto-commit-action@v4
+      uses: stefanzweifel/git-auto-commit-action@v5
       with:
         commit_message: Automated generation product markdown header

.github/workflows/app_from_contentful.yml .github/workflows/sync-contentful.yml.github/workflows/app_from_contentful.yml renamed to .github/workflows/sync-contentful.yml

@@ -64,7 +64,7 @@ template/
 
 ### 1. Jinja2 App 模板（`template/meta/`）
 
-由 `app_from_contentful.yml` 自动调用，从 Contentful CMS 生成 App 文档的 `_include/` 元数据片段和 App 文档骨架。
+由 `sync-contentful.yml` 自动调用，从 Contentful CMS 生成 App 文档的 `_include/` 元数据片段和 App 文档骨架。
 
 - `zh_head.jinja2` / `en_head.jinja2` — 生成 `apps/_include/{appname}.md`
 - `zh_app.jinja2` / `en_app.jinja2` — 生成 `apps/{appname}.md` 骨架
@@ -83,16 +83,16 @@ template/
 
 | 工作流 | 触发条件 | 用途 |
 |--------|----------|------|
-| `build_doc.yml` | push to `dev`/`main`，`workflow_dispatch` | 构建文档并部署到 Cloudflare Pages（main 分支）|
-| `check.yml` | push to `dev`，PR to `dev`，`workflow_dispatch` | broken-links 检查（PR 质量门）|
-| `app_from_contentful.yml` | `workflow_dispatch`（管理员手动触发）| 从 Contentful 生成 App 元数据文档 |
-| `json2md.yml` | `workflow_dispatch`，`repository_dispatch: applist_dev_event` | 从制品生成 App 目录列表（由主仓库 release 触发）|
-| `update.yml` | `workflow_dispatch` | 升级 Docusaurus 依赖并创建 PR |
+| `ci.yml` | push to `dev`/`main`，PR to `dev`，`workflow_dispatch` | CI 主流程：外链检查（check job）+ 文档构建（build job）；main 分支额外部署到 Cloudflare Pages |
+| `sync-contentful.yml` | `workflow_dispatch`（管理员手动触发）| 从 Contentful CMS 生成 App 元数据文档（`_include/`）和文档骨架 |
+| `sync-catalog.yml` | `workflow_dispatch`，`repository_dispatch: applist_dev_event` | 从制品生成 App 目录列表（由主仓库 release 触发）|
 
-**分支行为差异（`build_doc.yml`）：**
+**分支行为差异（`ci.yml`）：**
 
-- `dev` 分支：执行构建验证，**不部署**到生产环境
-- `main` 分支：构建 + 部署到 Cloudflare Pages
+- `dev` 分支 / PR：先运行 `check` job（lychee 外链检查），通过后运行 `build` job（构建验证），**不部署**
+- `main` 分支：跳过 `check` job，直接运行 `build` job + 部署到 Cloudflare Pages
+
+> **注**：Docusaurus 依赖升级由 [Dependabot](https://docs.github.com/en/code-security/dependabot) 自动管理（每周一提 PR），无需手动触发。
 
 ---
 
@@ -143,7 +143,7 @@ graph LR
 > **此步骤需要仓库 Write 权限 + `CONTENTFUL_ACCESS_TOKEN`，普通贡献者无法自行完成。**
 
 1. 在 [Contentful CMS](https://app.contentful.com/) 中录入新 App 的产品数据
-2. 在 GitHub Actions 页面手动触发 `app_from_contentful.yml`
+2. 在 GitHub Actions 页面手动触发 `sync-contentful.yml`
 3. 确认以下两个文件已自动生成并 commit 到 `dev` 分支：
    - `versioned_docs/version-2.0/apps/_include/{appname}.md`
    - `i18n/en/docusaurus-plugin-content-docs/version-2.0/apps/_include/{appname}.md`