vite-plugin-scriptcat-auto-icon

Vite 插件，自动为 UserScript 元数据块补充 @icon 属性，从 @match URL 中获取站点的 favicon。

安装

pnpm add -D @yiero/vite-plugin-scriptcat-auto-icon

使用

import { defineConfig } from 'vite';
import autoIconPlugin from '@yiero/vite-plugin-scriptcat-auto-icon';

export default defineConfig({
    plugins: [
        autoIconPlugin({
            defaultIcon: 'https://example.com/default-icon.png',
        }),
    ],
});

配置选项

| 选项 | 类型 | 说明 | | --- | --- | --- | | defaultIcon | string | 所有 @match 均失败时使用的默认图标 URL |

工作原理

1. 从 UserScript 元数据块中提取 @match 值
2. 依次尝试从各 @match URL 的 origin 获取 /favicon.ico
3. 若获取成功，在 // ==/UserScript== 之前插入 @icon 行
4. 若所有 @match 均失败，使用配置的 defaultIcon

配套插件

建议与 vite-plugin-scriptcat-meta-banner 配合使用，可自动解析 UserScript 元数据。

开发

# 安装依赖
pnpm install

# 构建
pnpm run build

# 监听模式构建
pnpm run dev