feat(theme): 支持按需开启 group-icons 插件

Author: ATQQ

packages/theme/CHANGELOG.md

@@ -4,6 +4,7 @@
 
 ### Patch Changes
 
+- feat: 支持按需开启 group-icons 插件
 - fix: 一些 SVG 图标 iOS 不渲染
 - fix: 日期在 iOS 上显示 NaN
 - fix: 作品页样式塌陷

packages/theme/docs/.vitepress/blog-theme.ts

@@ -15,6 +15,7 @@ export const blogTheme = getThemeConfig({
   locales: {
     en: themeEN
   },
+  // groupIcon: false,
   // formatShowDate: {
   //   justNow: '不久前',
   //   minutesAgo: ' minutes ago',

packages/theme/docs/changelog.md

@@ -1,6 +1,6 @@
 ---
 title: 更新日志
-description: 最近更新（v0.5.5） ⏰ 2025/07/01：系列bug修复
+description: 最近更新（v0.5.5） ⏰ 2025/07/03：系列bug修复
 author: 粥里有勺糖
 top: 3
 tag: 日志
@@ -27,10 +27,11 @@ bun install vitepress@latest
 ```
 :::
 
-## 0.5.5 (2025/07/01)
+## 0.5.5 (2025/07/03)
 
 ### Patch Changes
 
+- feat: 支持按需开启 group-icons 插件
 - fix: 一些 SVG 图标 iOS 不渲染
 - fix: 日期在 iOS 上显示 NaN
 - fix: 作品页样式塌陷

packages/theme/docs/config/component.md

@@ -47,6 +47,14 @@ const blogTheme = getThemeConfig({
 })
 ```
 
+也可以关闭这个功能
+
+```ts
+const blogTheme = getThemeConfig({
+  groupIcon: false
+})
+```
+
 ## oml2d - 看板娘集成
 * Type：[oml2dOptions](https://oml2d.hacxy.cn/api/interfaces/Options.html)
 

packages/theme/src/composables/config/index.ts

@@ -467,7 +467,7 @@ export namespace Theme {
     imageStyle?: ImageStyleConfig
     groupIcon?: {
       customIcon: Record<string, string>
-    }
+    } | false
   }
 
   export type FormatShowDate = {

packages/theme/src/index.ts

@@ -35,8 +35,8 @@ import UserWorksPage from './components/UserWorks.vue'
 // 内置一些特殊的主题色
 import './styles/theme/inline-theme.var.css'
 
-// 导入group icons
-import 'virtual:group-icons.css'
+// 导入group icons，改由自定义插件导入
+// import 'virtual:group-icons.css'
 
 export const BlogTheme: Theme = {
   ...DefaultTheme,

packages/theme/src/utils/node/mdPlugins.ts

@@ -32,7 +32,9 @@ export function getMarkdownPlugins(cfg?: Partial<Theme.BlogConfig>) {
     markdownPlugin.push(timeline)
   }
 
-  markdownPlugin.push(groupIconMdPlugin)
+  if (cfg?.groupIcon !== false) {
+    markdownPlugin.push(groupIconMdPlugin)
+  }
 
   return markdownPlugin
 }

packages/theme/src/utils/node/vitePlugins.ts

@@ -56,12 +56,29 @@ export function getVitePlugins(cfg: Partial<Theme.BlogConfig> = {}) {
   }
 
   // 内置支持 group icon
-
-  plugins.push(groupIconVitePlugin(cfg?.groupIcon))
+  if (cfg?.groupIcon !== false) {
+    plugins.push(patchGroupIconPlugin())
+    plugins.push(groupIconVitePlugin(cfg?.groupIcon))
+  }
 
   return plugins
 }
 
+export function patchGroupIconPlugin() {
+  return {
+    name: '@sugarat/theme-plugin-patch-group-icon',
+    enforce: 'pre',
+    transform(code: string, id: string) {
+      // 匹配 theme/index.ts 或 theme/index.js 文件
+      if (id.match(/[\/\\]theme[\/\\]index\.(ts|js)$/)) {
+        // 在文件顶部插入 import 语句
+        return `import 'virtual:group-icons.css'\n${code}`
+      }
+      return code
+    }
+  }
+}
+
 export function registerVitePlugins(vpCfg: any, plugins: any[]) {
   vpCfg.vite = {
     plugins,

template/vitepress-plugin-slot-inject-template/package.json

@@ -1,6 +1,7 @@
 {
   "name": "vitepress-plugin-slot-inject-template",
   "version": "0.1.0",
+  "private": true,
   "description": "vitepress plugin, slot template",
   "author": "sugar",
   "license": "MIT",