build: 文档站 logo 复用 public/icons/icon.svg，自动同步而不再单独维护

之前我在 docs/public/logo.svg 重画了一个棱镜+彩虹的 svg，但项目根目录 public/icons/icon.svg 已经有一份精心做的图标（多 facet 渐变 + dropShadow）。两份 logo 各画一遍是浪费，改了一处忘了改另一处会脱钩。

新增 build-scripts/sync-docs-assets.mjs：单源同步脚本，读 public/icons/icon.svg 复制到 docs/public/icon.svg。脚本走 import.meta.url 解析项目根，跨平台 Windows / Unix 都能跑。

package.json scripts 新增 docs:assets 调用同步脚本，docs:dev / docs:build 都先跑一遍 docs:assets。本地与 GitHub Pages workflow 同样走 pnpm run docs:build → 自动同步 → vitepress build。

.gitignore 加 docs/public/icon.svg：源 truth 在 public/icons/icon.svg，docs 那份是同步产物不入库。如果以后维护者改了 public/icons/icon.svg，下次 docs:dev / docs:build 自动同步过来。

VitePress config 与 docs/index.md 里 logo 路径全部从 /logo.svg 改成 /icon.svg。删除冗余的 docs/public/logo.svg。

插件版本升级到 1.0.94。

Author: setube

.gitignore

@@ -5,6 +5,7 @@ node_modules/
 .vite/
 docs/.vitepress/cache/
 docs/.vitepress/dist/
+docs/public/icon.svg
 
 # Build and packaged extension output
 dist/

build-scripts/sync-docs-assets.mjs

@@ -0,0 +1,14 @@
+import { copyFileSync, mkdirSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = resolve(fileURLToPath(import.meta.url), '../../')
+const targets = [['public/icons/icon.svg', 'docs/public/icon.svg']]
+
+for (const [src, dst] of targets) {
+  const srcPath = resolve(root, src)
+  const dstPath = resolve(root, dst)
+  mkdirSync(dirname(dstPath), { recursive: true })
+  copyFileSync(srcPath, dstPath)
+  console.log(`synced ${src} → ${dst}`)
+}

docs/.vitepress/config.ts

@@ -8,7 +8,7 @@ export default defineConfig({
   lastUpdated: true,
   head: [['meta', { name: 'theme-color', content: '#0f766e' }]],
   themeConfig: {
-    logo: '/logo.svg',
+    logo: '/icon.svg',
     nav: [
       { text: '使用指南', link: '/guide/' },
       { text: '配置指南', link: '/config/' },

docs/index.md

@@ -6,7 +6,7 @@ hero:
   text: 看清网页的技术栈
   tagline: 在浏览器扩展弹窗里识别前端框架、UI 库、CDN、SaaS、统计、登录、支付与网站程序，离线规则、毫秒级响应。
   image:
-    src: /logo.svg
+    src: /icon.svg
     alt: StackPrism
   actions:
     - theme: brand

docs/public/logo.svg

@@ -1,7 +1,7 @@
 {
   "name": "stackprism",
   "private": true,
-  "version": "1.0.93",
+  "version": "1.0.94",
   "type": "module",
   "description": "StackPrism 用于检测网页前端、后端、CDN、SaaS、广告营销、统计、登录、支付、网站程序和主题模板线索。",
   "scripts": {
@@ -10,8 +10,9 @@
     "build:injected": "node build-scripts/build-injected.mjs",
     "build": "pnpm run build:injected && vite build",
     "dev": "pnpm run build:injected && vite",
-    "docs:dev": "vitepress dev docs",
-    "docs:build": "vitepress build docs",
+    "docs:assets": "node build-scripts/sync-docs-assets.mjs",
+    "docs:dev": "pnpm run docs:assets && vitepress dev docs",
+    "docs:build": "pnpm run docs:assets && vitepress build docs",
     "docs:preview": "vitepress preview docs"
   },
   "devDependencies": {