@koishi-ce/client 1.0.2 → 1.0.3

package/client/components/icons/svg/expand.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 四角外扩图标（注册名 "expand"），用于复原/全屏切换 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512">

package/client/components/icons/svg/file-archive.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 压缩包文件图标（注册名 "file-archive"），用于导出/备份文件 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 384 512">

package/client/components/icons/svg/filter.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 漏斗筛选图标（注册名 "filter"），用于列表过滤开关 -->
 <template>
   <svg class="k-icon k-icon-filter" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/github.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- GitHub 品牌图标（注册名 "github"），用于源码/Issue 链接 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 496 512">

package/client/components/icons/svg/gitlab.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- GitLab 品牌图标（注册名 "gitlab"），用于 GitLab 相关链接 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/info-full.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 实心圆形信息图标（注册名 "info-full"），用于提示/说明状态 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/koishi.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- Koishi 官方徽标图标（注册名 "koishi"），用于品牌展示与空状态占位 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/link.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 双环链条图标（注册名 "link"），用于链接/关联 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/paper-plane.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 纸飞机图标（注册名 "paper-plane"），用于发送消息/指令 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/question-empty.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 空心圆形问号图标（注册名 "question-empty"），k-hint 提示图标的默认图标 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/redo.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 顺时针旋转箭头图标（注册名 "redo"），用于向右旋转/重做 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/search-minus.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 带减号的放大镜图标（注册名 "search-minus"），用于缩小视图 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/search-plus.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 带加号的放大镜图标（注册名 "search-plus"），用于放大视图 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/search.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 放大镜图标（注册名 "search"），用于搜索入口 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/star-empty.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 空心五角星图标（注册名 "star-empty"），用于未收藏/未订阅状态 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512">

package/client/components/icons/svg/star-full.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 实心五角星图标（注册名 "star-full"），用于已收藏/已订阅状态 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512">

package/client/components/icons/svg/start.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 播放（三角）图标（注册名 "start"），用于启动/运行 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 384 512">

package/client/components/icons/svg/tag.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 标签图标（注册名 "tag"），用于标签/标记 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/times-full.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 实心圆形叉号图标（注册名 "times-full"），用于失败/关闭状态 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/tools.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 扳手与螺丝刀工具图标（注册名 "tools"），用于维护/调试功能 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/undo.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 逆时针旋转箭头图标（注册名 "undo"），用于向左旋转/撤销 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/user.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!-- 用户人形图标（注册名 "user"），用于用户/登录相关界面 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512">

package/client/components/index.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * 内置组件库的总装模块：
  *

package/client/components/layout/card.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!--
   k-card：通用卡片容器。
   可选 header（标题文字或 header 插槽）与 footer 插槽；

package/client/components/layout/content.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!--
   k-content：页面主内容区容器。
   水平居中、限宽 55rem，自带垂直滚动（el-scrollbar），

package/client/components/layout/empty.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!--
   k-empty：空状态占位组件。
   居中展示 Koishi 徽标图标与默认插槽文案，用于无数据 / 无权限等场景。

package/client/components/layout/index.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import type { App } from "vue";
 import Card from "./card.vue";
 import Content from "./content.vue";

package/client/components/layout/tab-group.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!--
   k-tab-group：侧栏式选项卡分组。
   遍历 data（键 → 条目对象），filter 可按条目过滤显示；

package/client/components/layout/tab-item.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!--
   k-tab-item：选项卡条目（配合 k-tab-group 使用）。
   label 为条目标识兼默认文案，点击时 emit update:modelValue；

package/client/components/link.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import { type App, defineComponent, h } from "vue";
 import { RouterLink } from "vue-router";
 import { useContext } from "../context";

package/client/components/perms.vue

@@ -1,3 +1,7 @@
+<!-- SPDX-License-Identifier: AGPL-3.0-only -->
+<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
+<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
+
 <!--
   perms.vue：权限选择控件（array + perms 角色）。
   把服务端下发的扁平权限名（如 "channel.xxx"）按 ":" 逐级拆分，

package/client/components/slot.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import { type App, type Component, defineComponent, h } from "vue";
 import { useContext } from "../context";
 

package/client/context.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import * as cordis from "cordis";
 import {
 	type App,

package/client/data.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /// <reference path="./shims.d.ts" />
 import type { Promisify, Universal } from "@koishi-ce/koishi";
 import type {

package/client/index.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * @koishi_ce/client 包的主入口（Koishi 控制台前端组件库）。
  *

package/client/plugins/action.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * 动作（action）与菜单服务：控制台的快捷键、右键菜单、
  * 作用域变量的统一管理。

package/client/plugins/i18n.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import { watchEffect } from "vue";
 import { createI18n } from "vue-i18n";
 import type { Context } from "../context";

package/client/plugins/loader.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import type { EntryData } from "@koishi-ce/plugin-console";
 import type { EffectScope, Plugin } from "cordis";
 import type { Dict } from "cosmokit";

package/client/plugins/router.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * 路由服务：控制台页面（activity）与插槽视图的注册中心。
  *

package/client/plugins/setting.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * 设置服务：控制台本地配置（localStorage）与设置面板的管理。
  *

package/client/plugins/theme.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * 主题服务：管理控制台的深浅色模式与主题注册。
  *

package/client/shims.d.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * 浏览器端类型垫片(packages/web/client 自身使用;app 项目通过
  * app/shims.d.ts 引用本文件):

package/client/utils.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import * as cordis from "cordis";
 import { markRaw } from "vue";
 import type { Context } from "./context";

package/global.d.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /// <reference types="vue-i18n" />
 /// <reference types="vite/client" />
 /// <reference types="element-plus/global" />

package/lib/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as build } from "./src-lTfcJ1xA.mjs";
+import { t as build } from "./src-DXaM1Kgh.mjs";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 //#endregion
@@ -16,7 +16,7 @@ import { resolve } from "node:path";
 const { version } = {
 	name: "@koishi-ce/client",
 	description: "Koishi Console Client",
-	version: "1.0.2",
+	version: "1.0.3",
 	type: "module",
 	main: "client/index.ts",
 	exports: {
@@ -70,6 +70,10 @@ const { version } = {
 		"vue": "^3.5.42",
 		"vue-i18n": "^11.4.10",
 		"vue-router": "^5.2.0"
+	},
+	devDependencies: {
+		"@koishi-ce/koishi": "workspace:*",
+		"@koishi-ce/plugin-console": "workspace:*"
 	}
 };
 const help = `koishi-console/${version}

package/lib/index.mjs

@@ -1,2 +1,2 @@
-import { n as createServer, t as build } from "./src-lTfcJ1xA.mjs";
+import { n as createServer, t as build } from "./src-DXaM1Kgh.mjs";
 export { build, createServer };

package/lib/{src-lTfcJ1xA.mjs → src-DXaM1Kgh.mjs}

@@ -2,6 +2,7 @@ import { t as yaml } from "./yaml-UzQbvquH.mjs";
 import { existsSync } from "node:fs";
 import { mkdir, rm } from "node:fs/promises";
 import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
 import vue from "@vitejs/plugin-vue";
 import * as vite from "vite";
 //#region src/index.ts
@@ -43,6 +44,11 @@ const runtimeShimPath = (workspaceAliases["@koishi-ce/components"] ?? "").replac
 */
 async function build(root, config = {}) {
 	if (!existsSync(`${root}/client`)) return;
+	const overridePath = `${root}/build/client.ts`;
+	if (existsSync(overridePath)) {
+		const mod = await import(pathToFileURL(overridePath).href);
+		config = vite.mergeConfig(config, mod.default ?? mod);
+	}
 	const outDir = `${root}/dist`;
 	if (existsSync(outDir)) await rm(outDir, { recursive: true });
 	await mkdir(outDir, { recursive: true });

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@koishi-ce/client",
     "description": "Koishi Console Client",
-    "version": "1.0.2",
+    "version": "1.0.3",
     "type": "module",
     "main": "client/index.ts",
     "exports": {
@@ -48,7 +48,7 @@
         "build"
     ],
     "dependencies": {
-        "@koishi-ce/components": "^1.0.0",
+        "@koishi-ce/components": "^1.0.1",
         "@satorijs/protocol": "^1.7.0",
         "@vitejs/plugin-vue": "^6.0.8",
         "@vueuse/core": "^14.4.0",
@@ -62,5 +62,9 @@
         "vue": "^3.5.42",
         "vue-i18n": "^11.4.10",
         "vue-router": "^5.2.0"
+    },
+    "devDependencies": {
+        "@koishi-ce/koishi": "^1.0.4",
+        "@koishi-ce/plugin-console": "^1.0.3"
     }
 }

package/src/bin.ts

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
 
 /**
  * `koishi-console` CLI 入口（构建产物 lib/bin.mjs 由 package.json 的

package/src/index.ts

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2019-present Shigma and Koishijs contributors.
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * @koishi-ce/client 构建入口。
  *
@@ -10,6 +14,7 @@
 import { existsSync } from "node:fs";
 import { mkdir, rm } from "node:fs/promises";
 import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
 import vue from "@vitejs/plugin-vue";
 import * as vite from "vite";
 import { yaml } from "./yaml.ts";
@@ -78,6 +83,15 @@ const runtimeShimPath = (
 export async function build(root: string, config: vite.UserConfig = {}) {
 	if (!existsSync(`${root}/client`)) return;
 
+	// 插件可自带 `build/client.ts` 导出额外的 vite 配置覆盖下方默认值
+	// （vite 只自动发现 vite.config.*，不会加载该路径，须在此显式接线），
+	// 如 analytics 的 fuck-echarts 符号遮蔽修补
+	const overridePath = `${root}/build/client.ts`;
+	if (existsSync(overridePath)) {
+		const mod = await import(pathToFileURL(overridePath).href);
+		config = vite.mergeConfig(config, mod.default ?? mod);
+	}
+
 	// 产物约定：固定写入插件目录下的 dist/，清空后重建
 	const outDir = `${root}/dist`;
 	if (existsSync(outDir)) {

package/src/yaml.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import type { Plugin } from "vite";
 
 /**