docs(xburn/overview): 补概述引子与适用范围说明

.github/workflows/ci-check.yml

@@ -6,7 +6,7 @@ on:
 
 jobs:
   lint:
-    runs-on: ubuntu-latest
+    runs-on: self-hosted
     steps:
       - uses: actions/checkout@v4
       - name: Lint Markdown
@@ -17,27 +17,56 @@ jobs:
             blog/**/*.{md,mdx}
 
   custom-checks:
-    runs-on: ubuntu-latest
+    runs-on: self-hosted
     steps:
       - uses: actions/checkout@v4
+      - name: Detect local Node.js on runner
+        id: detect_node
+        run: |
+          if command -v node >/dev/null 2>&1 && command -v npm >/dev/null 2>&1; then
+            echo "has_node=true" >> "$GITHUB_OUTPUT"
+            echo "Using local Node.js:"
+            node -v
+            npm -v
+          else
+            echo "has_node=false" >> "$GITHUB_OUTPUT"
+          fi
+      - name: Setup Node.js (fallback if runner has no Node)
+        if: steps.detect_node.outputs.has_node != 'true'
+        uses: actions/setup-node@v4
+        with: { node-version: '24' }
       - name: Filename & directory lint
         run: bash scripts/check-filenames.sh
       - name: Frontmatter coverage
-        uses: actions/setup-node@v4
-        with: { node-version: '24' }
-      - run: node scripts/check-frontmatter.js
+        run: node scripts/check-frontmatter.js
       - name: Placeholder check
         run: bash scripts/check-placeholder.sh
 
   build:
-    runs-on: ubuntu-latest
+    runs-on: self-hosted
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - name: Detect local Node.js on runner
+        id: detect_node
+        run: |
+          if command -v node >/dev/null 2>&1 && command -v npm >/dev/null 2>&1; then
+            echo "has_node=true" >> "$GITHUB_OUTPUT"
+            echo "Using local Node.js:"
+            node -v
+            npm -v
+          else
+            echo "has_node=false" >> "$GITHUB_OUTPUT"
+          fi
+      - name: Setup Node.js (fallback if runner has no Node)
+        if: steps.detect_node.outputs.has_node != 'true'
+        uses: actions/setup-node@v4
         with:
           node-version: '24'
           cache: 'npm'
-      - run: npm ci
+      - name: Clean install dependencies
+        run: |
+          rm -rf node_modules
+          npm ci
       - name: Build site (strict broken-link checking)
         run: npm run build:ci
       - if: always()

.markdownlint-cli2.jsonc

@@ -2,7 +2,7 @@
   "config": {
     "default": false,
     "MD001": true,        // 标题层级不能跳跃
-    "MD025": true,        // 每页只有一个 H1
+    "MD025": { "front_matter_title": "" },        // 每页只有一个 H1；frontmatter 的 title 不算 H1（Docusaurus 用 frontmatter title 做侧边栏标签，正文另有 H1）
     "MD040": true,        // 代码块必须指定语言
     "MD042": true,        // 空链接不允许
     "MD045": true         // 图片必须有 alt 文本

docs/xburn/overview.md

@@ -1,6 +1,10 @@
 ---
 title: "Xburn 概述"
-description: "Xburn 是什么、适用型号、版本演进、与其他烧录工具的关系"
+description: "Xburn 烧录工具是什么、适用型号（S100/S600/X5/X5 Module）、版本演进、与 hbupdate/全镜像烧录工具的边界"
 ---
 
 # Xburn 概述
+
+Xburn 是 D-Robotics 面向 RDK 系列设备的板级烧录工具，支持 S100/S600/X5/X5 Module 的 NAND/指定区域烧录与备份。本页介绍工具定位、适用范围、版本演进及与其他烧录工具的关系。
+
+> 本页为骨架占位，内容待 W2 编写。