ci: 修文档站 base 路径 + 加 GitHub Pages 自动部署

setube.github.io/stackprism/ 上看不到样式的根因不是主题没生效，是 vitepress config 漏了 base，build 出来的 HTML 把所有 asset link 写成 /assets/style.xxx.css，部署到子路径 /stackprism/ 下时 / 是 setube.github.io 根目录，资源全部 404，浏览器拿不到 CSS / JS / 字体，整页只剩裸 HTML。

config 加 base: '/stackprism/' 后，build 产物里 href / src 全部变成 /stackprism/assets/...，跟实际部署路径对齐。验证：dist/index.html 第一行 href="/stackprism/assets/style.Bqr992fK.css"。

新建 .github/workflows/deploy-docs.yml：push 到 main 时如果 docs/ 或文档相关文件有改动则触发，跑 pnpm run docs:build 把 docs/.vitepress/dist 上传到 actions/upload-pages-artifact，再用 actions/deploy-pages@v4 发布。两阶段 job：build / deploy 分离，concurrency group 锁 pages 避免并发部署冲突。permissions 只给 pages: write + id-token: write 满足 Pages 部署，不开多余。也支持 workflow_dispatch 手动跑。

仓库需要在 Settings → Pages → Source 选「GitHub Actions」（不是 Deploy from a branch），第一次发布之后这条配置会持久化。

插件版本升级到 1.0.93。

Author: setube

.github/workflows/deploy-docs.yml

@@ -0,0 +1,67 @@
+name: 部署文档站到 GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - 'package.json'
+      - 'pnpm-lock.yaml'
+      - '.github/workflows/deploy-docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: 构建文档站
+    runs-on: ubuntu-latest
+    steps:
+      - name: 检出仓库
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: 安装 pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: 安装 Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: 安装依赖
+        run: pnpm install --frozen-lockfile
+
+      - name: 构建 VitePress
+        run: pnpm run docs:build
+
+      - name: 配置 Pages
+        uses: actions/configure-pages@v4
+
+      - name: 上传产物
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/.vitepress/dist
+
+  deploy:
+    name: 部署到 GitHub Pages
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: 部署
+        id: deployment
+        uses: actions/deploy-pages@v4

docs/.vitepress/config.ts

@@ -4,6 +4,7 @@ export default defineConfig({
   lang: 'zh-CN',
   title: 'StackPrism',
   description: '网页技术栈检测扩展 · 使用文档',
+  base: '/stackprism/',
   lastUpdated: true,
   head: [['meta', { name: 'theme-color', content: '#0f766e' }]],
   themeConfig: {

package.json

@@ -1,7 +1,7 @@
 {
   "name": "stackprism",
   "private": true,
-  "version": "1.0.92",
+  "version": "1.0.93",
   "type": "module",
   "description": "StackPrism 用于检测网页前端、后端、CDN、SaaS、广告营销、统计、登录、支付、网站程序和主题模板线索。",
   "scripts": {