docs: 套上 Pinia 风格的品牌主题，并修复内部链接 404

之前的文档站直接吃 VitePress 默认蓝色主题，logo 是个朴素的圆角方块，跟项目调性脱节。参考 Pinia 中文文档的视觉规格做了一组品牌化覆盖：

新建 docs/.vitepress/theme/ 扩展默认主题：
- index.ts 走 extends DefaultTheme + 引入 style.css，VitePress 1.x 的标准做法
- style.css 覆盖 --vp-c-brand-1/2/3 + --vp-c-brand-soft + --vp-c-brand-mute 系列 token，浅色 teal 实色 (#0f766e / #115e59 / #134e4a)，暗色切到 cyan tint (#2dd4bf / #14b8a6 / #0d9488)，nav active / link / 按钮 / 进度条全部跟随
- 首页 hero name 用 --vp-home-hero-name-background linear-gradient 渲染成渐变文字（120deg teal → cyan），暗色另一组渐变
- hero image 后面铺一层 --vp-home-hero-image-background-image 双色对角光晕，blur 56-96px 随屏幕宽度递进
- .VPHomeHero .VPImage 加 6s 浮动动画 + drop-shadow 让 logo 真正"漂浮"，浅暗各一份阴影色
- .VPFeature hover 抬升 -2px + 边框切品牌色 + 阴影
- :not(pre) > code 用 --vp-c-brand-mute 浅底 + 品牌色文字，行内代码视觉与品牌统一

logo 整体重做：原来是 teal 方块 + 白色棱镜 path，过于扁平。新版做成「光线穿过棱镜分散成彩虹」的等腰三角形棱镜：
- 三角形主面用 5eead4 → 0f766e 渐变填充，右半侧叠 14b8a6 → 115e59 渐变 0.45 不透明度做立体感，外描边 0d9488
- 左侧一束白光从 (14, 92) 射入到 (84, 92)
- 右侧五道彩色出射光：红 / 橙 / 绿 / 蓝 / 紫，对应 prism 物理上散射出的可见光
- viewBox 200×200，扩展图标（icons/*.png）不动，只改 docs/public/logo.svg

修复点击文档站内链接 404：
- 删 cleanUrls: true（之前 cleanUrls=true 模式下 URL 不带 .html，但需要 server 端 rewrite 才能映射回 .html 文件，dev / preview / 静态托管支持程度不一致）
- 把所有 markdown 内部链接补 .md 后缀（VitePress 默认会把 [xxx](./foo.md) 自动 rewrite 成 ./foo.html）。21 处分布在 6 个文件，用一行 node 脚本批改：跳过 trailing slash 的目录链接（/config/）、跳过 http(s):// 外链、跳过已 .md 结尾的，剩下的全部追加 .md 后缀

插件版本升级到 1.0.92。

Author: setube

docs/.vitepress/config.ts

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

docs/.vitepress/theme/index.ts

@@ -0,0 +1,7 @@
+import DefaultTheme from 'vitepress/theme'
+import type { Theme } from 'vitepress'
+import './style.css'
+
+export default {
+  extends: DefaultTheme
+} satisfies Theme

docs/.vitepress/theme/style.css

@@ -0,0 +1,137 @@
+/**
+ * VitePress 默认主题的 brand token 覆盖
+ * 走 --vp-c-brand-* 让 nav active / link / 按钮 / 进度条等全部跟随
+ * 浅色：teal 实色；暗色：cyan tint
+ */
+
+:root {
+  --vp-c-brand-1: #0f766e;
+  --vp-c-brand-2: #115e59;
+  --vp-c-brand-3: #134e4a;
+  --vp-c-brand-soft: rgba(15, 118, 110, 0.14);
+  --vp-c-brand-mute: rgba(15, 118, 110, 0.08);
+
+  /* nav / sidebar / footer 用这些品牌色派生 */
+  --vp-c-text-1: #1f2937;
+  --vp-c-text-2: #475569;
+  --vp-c-text-3: #64748b;
+
+  /* button: cta */
+  --vp-button-brand-border: transparent;
+  --vp-button-brand-text: #ffffff;
+  --vp-button-brand-bg: var(--vp-c-brand-1);
+  --vp-button-brand-hover-border: transparent;
+  --vp-button-brand-hover-text: #ffffff;
+  --vp-button-brand-hover-bg: var(--vp-c-brand-2);
+  --vp-button-brand-active-border: transparent;
+  --vp-button-brand-active-text: #ffffff;
+  --vp-button-brand-active-bg: var(--vp-c-brand-3);
+
+  /* 首页 hero 文本渐变（标题"StackPrism"） */
+  --vp-home-hero-name-color: transparent;
+  --vp-home-hero-name-background: linear-gradient(120deg, #0f766e 30%, #14b8a6);
+
+  /* 首页 hero 图片背后的彩色光晕 */
+  --vp-home-hero-image-background-image: linear-gradient(-45deg, #0f766e 50%, #2dd4bf 50%);
+  --vp-home-hero-image-filter: blur(56px);
+
+  /* 自定义块（tip / warning / danger）的左侧条颜色跟着品牌色 */
+  --vp-custom-block-tip-border: transparent;
+  --vp-custom-block-tip-text: var(--vp-c-brand-2);
+  --vp-custom-block-tip-bg: var(--vp-c-brand-soft);
+
+  /* 代码块标题与 background */
+  --vp-code-tab-active-bar-color: var(--vp-c-brand-1);
+  --vp-code-tab-active-text-color: var(--vp-c-text-1);
+}
+
+.dark {
+  --vp-c-brand-1: #2dd4bf;
+  --vp-c-brand-2: #14b8a6;
+  --vp-c-brand-3: #0d9488;
+  --vp-c-brand-soft: rgba(45, 212, 191, 0.16);
+  --vp-c-brand-mute: rgba(45, 212, 191, 0.08);
+
+  --vp-c-text-1: #e2e8f0;
+  --vp-c-text-2: #cbd5e1;
+  --vp-c-text-3: #94a3b8;
+
+  --vp-home-hero-name-background: linear-gradient(120deg, #2dd4bf 30%, #5eead4);
+  --vp-home-hero-image-background-image: linear-gradient(-45deg, #2dd4bf 50%, #14b8a6 50%);
+  --vp-home-hero-image-filter: blur(64px);
+}
+
+@media (min-width: 640px) {
+  :root {
+    --vp-home-hero-image-filter: blur(72px);
+  }
+}
+
+@media (min-width: 960px) {
+  :root {
+    --vp-home-hero-image-filter: blur(96px);
+  }
+}
+
+/* 让 hero 图片漂浮：默认 svg 没有阴影/动效，加一个 idle 浮动 */
+.VPHomeHero .VPImage {
+  animation: hero-float 6s ease-in-out infinite;
+  filter: drop-shadow(0 18px 40px rgba(15, 118, 110, 0.3));
+}
+
+.dark .VPHomeHero .VPImage {
+  filter: drop-shadow(0 18px 40px rgba(45, 212, 191, 0.35));
+}
+
+@keyframes hero-float {
+  0%,
+  100% {
+    transform: translateY(0);
+  }
+  50% {
+    transform: translateY(-10px);
+  }
+}
+
+/* feature 卡片：hover 抬升 + 边框跟随品牌色 */
+.VPFeature {
+  transition:
+    border-color 0.2s ease,
+    transform 0.2s ease,
+    box-shadow 0.2s ease;
+}
+
+.VPFeature:hover {
+  border-color: var(--vp-c-brand-2);
+  transform: translateY(-2px);
+  box-shadow: 0 12px 32px rgba(15, 118, 110, 0.12);
+}
+
+.dark .VPFeature:hover {
+  box-shadow: 0 12px 32px rgba(45, 212, 191, 0.18);
+}
+
+/* 中文阅读：行高与字号微调 */
+:root {
+  --vp-layout-max-width: 1440px;
+}
+
+.VPDoc h1 {
+  letter-spacing: -0.02em;
+}
+
+.VPDoc h2 {
+  letter-spacing: -0.01em;
+}
+
+.VPDoc :not(pre) > code {
+  background: var(--vp-c-brand-mute);
+  color: var(--vp-c-brand-2);
+  font-size: 0.86em;
+  padding: 2px 6px;
+  border-radius: 4px;
+}
+
+.dark .VPDoc :not(pre) > code {
+  color: var(--vp-c-brand-1);
+}

docs/config/index.md

@@ -4,11 +4,11 @@
 
 设置页分四个 panel：
 
-- [识别开关](./categories) — 22 个分类的启停（关掉后该分类的技术不再显示在弹窗里）
-- [禁用指定技术](./disabled-technologies) — 用名字精确屏蔽某些技术（无视分类）
-- [自定义弹窗样式](./custom-css) — 写一段 CSS 覆盖弹窗 / 设置页样式
-- [自定义规则](./custom-rules) — 用表单或 JSON 添加自己的识别规则
-- [规则 JSON 导入导出](./json-export) — 在多浏览器 / 多设备同步规则集合
+- [识别开关](./categories.md) — 22 个分类的启停（关掉后该分类的技术不再显示在弹窗里）
+- [禁用指定技术](./disabled-technologies.md) — 用名字精确屏蔽某些技术（无视分类）
+- [自定义弹窗样式](./custom-css.md) — 写一段 CSS 覆盖弹窗 / 设置页样式
+- [自定义规则](./custom-rules.md) — 用表单或 JSON 添加自己的识别规则
+- [规则 JSON 导入导出](./json-export.md) — 在多浏览器 / 多设备同步规则集合
 
 ## 配置存储位置
 

docs/dev/contribute-rules.md

@@ -49,7 +49,7 @@
 }
 ```
 
-字段含义见 [规则文件格式](./rule-format)。
+字段含义见 [规则文件格式](./rule-format.md)。
 
 ## 在哪个 group 里？
 

docs/dev/index.md

@@ -4,11 +4,11 @@
 
 ## 章节
 
-- [架构概览](./architecture) — 项目目录结构、各模块职责、数据流
-- [规则文件格式](./rule-format) — `public/rules/` 下 JSON 怎么组织，nested groups + defaults 继承
-- [检测流程](./detection-flow) — 从 webRequest / 页面注入到弹窗渲染走过哪些环节
-- [贡献规则](./contribute-rules) — 怎么往内置规则集合加新技术
-- [构建与发布](./release) — 本地构建、打包、签 crx、release workflow
+- [架构概览](./architecture.md) — 项目目录结构、各模块职责、数据流
+- [规则文件格式](./rule-format.md) — `public/rules/` 下 JSON 怎么组织，nested groups + defaults 继承
+- [检测流程](./detection-flow.md) — 从 webRequest / 页面注入到弹窗渲染走过哪些环节
+- [贡献规则](./contribute-rules.md) — 怎么往内置规则集合加新技术
+- [构建与发布](./release.md) — 本地构建、打包、签 crx、release workflow
 
 ## 一句话技术栈
 

docs/guide/basic-usage.md

@@ -64,7 +64,7 @@ React                                         [高置信度]
 [🔍 搜索]  [📄 原始线索]                           GitHub
 ```
 
-左侧两个工具按钮，详情见 [辅助工具](./tools)。点击后会从底部滑出抽屉式面板，再点同个按钮 / 点抽屉里的 X 关闭。
+左侧两个工具按钮，详情见 [辅助工具](./tools.md)。点击后会从底部滑出抽屉式面板，再点同个按钮 / 点抽屉里的 X 关闭。
 
 ## 滚动行为
 

docs/guide/index.md

@@ -4,10 +4,10 @@
 
 ## 章节
 
-- [安装与启用](./install) — 三种安装方式（Chrome Web Store、Edge 商店、本地加载）
-- [基本使用](./basic-usage) — 弹窗里五个区域是干什么的
-- [结果解读](./results) — 置信度、证据、来源、纠正按钮怎么看
-- [辅助工具](./tools) — 网页源代码搜索、原始线索面板、复制检测 JSON
+- [安装与启用](./install.md) — 三种安装方式（Chrome Web Store、Edge 商店、本地加载）
+- [基本使用](./basic-usage.md) — 弹窗里五个区域是干什么的
+- [结果解读](./results.md) — 置信度、证据、来源、纠正按钮怎么看
+- [辅助工具](./tools.md) — 网页源代码搜索、原始线索面板、复制检测 JSON
 
 ## 一句话上手
 

docs/index.md

@@ -45,10 +45,10 @@ StackPrism 是一个 Chrome MV3 扩展。打开任意网页，点击插件弹窗
 
 ## 怎么用
 
-- 第一次使用？看 [安装与启用](/guide/install)
-- 想添加自己的识别规则？看 [自定义规则](/config/custom-rules)
-- 想知道 28000 条规则怎么组织？看 [规则文件格式](/dev/rule-format)
-- 想给项目贡献规则？看 [贡献规则](/dev/contribute-rules)
+- 第一次使用？看 [安装与启用](/guide/install.md)
+- 想添加自己的识别规则？看 [自定义规则](/config/custom-rules.md)
+- 想知道 28000 条规则怎么组织？看 [规则文件格式](/dev/rule-format.md)
+- 想给项目贡献规则？看 [贡献规则](/dev/contribute-rules.md)
 
 ## 为什么