@koishi-ce/client 1.0.3 → 1.1.0

package/client/plugins/router.ts

@@ -19,7 +19,11 @@ import {
 	ref,
 	toValue,
 } from "vue";
-import { createRouter, createWebHistory, START_LOCATION } from "vue-router";
+import {
+	createRouter,
+	createWebHistory,
+	START_LOCATION,
+} from "vue-router";
 import type { SlotOptions } from "../components";
 import Overlay from "../components/chat/overlay.vue";
 import type { Context } from "../context";
@@ -106,8 +110,15 @@ export class Activity {
 		this.options = options;
 		options.order ??= 0;
 		options.position ??= "top";
-		Object.assign(this, omit(options, ["icon", "name", "desc", "disabled"]));
-		const { path, id = getActivityId(path), component } = options;
+		Object.assign(
+			this,
+			omit(options, ["icon", "name", "desc", "disabled"]),
+		);
+		const {
+			path,
+			id = getActivityId(path),
+			component,
+		} = options;
 		// 路由挂载时把 activity 实例放进 meta，供导航守卫与标题栏取用
 		this._disposables.push(
 			ctx.$router.router.addRoute({
@@ -127,7 +138,9 @@ export class Activity {
 	/** 若存在待跳转目标且当前路由已能解析，则立即完成该跳转 */
 	handleUpdate() {
 		if (redirectTo.value) {
-			const location = this.ctx.$router.router.resolve(redirectTo.value);
+			const location = this.ctx.$router.router.resolve(
+				redirectTo.value,
+			);
 			if (location.matched.length) {
 				redirectTo.value = null;
 				this.ctx.$router.router.replace(location);
@@ -156,7 +169,8 @@ export class Activity {
 	 */
 	disabled() {
 		if (this.ctx.bail("activity", this)) return true;
-		if (!this.fields?.every((key) => store[key])) return true;
+		if (!this.fields?.every((key) => store[key]))
+			return true;
 		if (this.when && !this.when()) return true;
 		if (this.options.disabled?.()) return true;
 		return false;
@@ -165,10 +179,13 @@ export class Activity {
 	dispose() {
 		this._disposables.forEach((dispose) => dispose());
 		// 若被卸载的恰是当前展示的页面：暂存目标路由，退回缓存的首页
-		const current = this.ctx.$router.router.currentRoute.value;
+		const current =
+			this.ctx.$router.router.currentRoute.value;
 		if (current?.meta?.activity === this) {
 			redirectTo.value = current.fullPath;
-			this.ctx.$router.router.push(this.ctx.$router.cache["home"] || "/");
+			this.ctx.$router.router.push(
+				this.ctx.$router.cache["home"] || "/",
+			);
 		}
 		return delete this.ctx.$router.pages[this.id];
 	}
@@ -203,7 +220,8 @@ export default class RouterService extends Service {
 		const initialTitle = document.title;
 		ctx.effect(() =>
 			this.router.afterEach((route) => {
-				const { name, fullPath } = this.router.currentRoute.value;
+				const { name, fullPath } =
+					this.router.currentRoute.value;
 				if (name) {
 					// 本应用的路由名均为字符串;reactive 收窄了索引签名,不含 symbol
 					this.cache[name as string] = fullPath;
@@ -211,7 +229,8 @@ export default class RouterService extends Service {
 				// 进入 activity 页面时更新标签页标题为 "页面名 | 原标题"
 				if (route.meta.activity) {
 					document.title = `${route.meta.activity.name}`;
-					if (initialTitle) document.title += ` | ${initialTitle}`;
+					if (initialTitle)
+						document.title += ` | ${initialTitle}`;
 				}
 			}),
 		);
@@ -254,7 +273,9 @@ export default class RouterService extends Service {
 	 */
 	slot(options: SlotOptions) {
 		options.order ??= 0;
-		const component = this.ctx.wrapComponent(options.component);
+		const component = this.ctx.wrapComponent(
+			options.component,
+		);
 		if (component) options.component = component;
 		if (options.when) {
 			const { when } = options;
@@ -272,7 +293,9 @@ export default class RouterService extends Service {
 
 	/** 注册 activity 页面（自动挂到 vue-router 与侧栏）；返回取消注册函数 */
 	page(options: Activity.Options) {
-		const component = this.ctx.wrapComponent(options.component);
+		const component = this.ctx.wrapComponent(
+			options.component,
+		);
 		if (component) options.component = component;
 		return this.ctx.effect(() => {
 			const activity = new Activity(this.ctx, options);

package/client/plugins/setting.ts

@@ -9,13 +9,28 @@
  * （经所有插件 schema 补全后的完整配置），二者双向同步（见文末类注释）。
  * 插件通过 `ctx.settings()` 注册设置分区、`ctx.schema()` 注册自定义控件。
  */
-import { type RemovableRef, useLocalStorage } from "@vueuse/core";
+import {
+	type RemovableRef,
+	useLocalStorage,
+} from "@vueuse/core";
 import { type Dict, remove } from "cosmokit";
-import { type Component, computed, markRaw, reactive, ref, watch } from "vue";
-import { Schema, SchemaBase } from "../../../components/client/index.ts";
+import {
+	type Component,
+	computed,
+	type MaybeRefOrGetter,
+	markRaw,
+	reactive,
+	ref,
+	watch,
+} from "vue";
+import {
+	Schema,
+	SchemaBase,
+} from "../../../components/client/index.ts";
 import type { Config } from "..";
 import type { Context } from "../context";
 import { insert, type Ordered, Service } from "../utils";
+import { pickMessages } from "./i18n";
 
 declare module "../context" {
 	interface Context {
@@ -33,8 +48,8 @@ declare module "../context" {
 interface SettingOptions extends Ordered {
 	/** 所属设置分区 id（空串为通用设置） */
 	id: string;
-	/** 分区标题 */
-	title?: string;
+	/** 分区标题（支持 getter，随界面语言实时切换） */
+	title?: MaybeRefOrGetter<string>;
 	disabled?: () => boolean;
 	/** 该分区的配置 schema（渲染为表单） */
 	schema?: Schema;
@@ -56,7 +71,10 @@ export let useStorage = <T extends object>(
 		__version__?: number | undefined;
 	};
 	initial.__version__ = version;
-	const storage = useLocalStorage(`koishi.console.${key}`, initial);
+	const storage = useLocalStorage(
+		`koishi.console.${key}`,
+		initial,
+	);
 	if (storage.value.__version__ !== version) {
 		storage.value = initial;
 	}
@@ -87,7 +105,10 @@ export function createStorage<T extends object>(
 	if (storage.value.version !== version) {
 		storage.value = { version, data: initial };
 	} else if (!Array.isArray(storage.value.data)) {
-		storage.value.data = { ...initial, ...storage.value.data };
+		storage.value.data = {
+			...initial,
+			...storage.value.data,
+		};
 	}
 	return reactive<T>(storage.value["data"]);
 }
@@ -138,17 +159,31 @@ export default class SettingService extends Service {
 
 		this.settings({
 			id: "",
-			title: "通用设置",
+			title: () => this.ctx.$i18n.t("settings.general"),
 			order: 1000,
 			schema: Schema.object({
-				locale: Schema.union(["zh-CN", "en-US"]).description("语言设置。"),
-			}).description("通用设置"),
+				// 语言列表覆盖宿主词典支持的全部语种；
+				// 显示名采用各语言的本地名称（CLDR 惯例），无需翻译
+				locale: Schema.union([
+					Schema.const("zh-CN").description("简体中文"),
+					Schema.const("zh-TW").description("繁體中文"),
+					Schema.const("en-US").description("English"),
+					Schema.const("ja-JP").description("日本語"),
+					Schema.const("fr-FR").description("Français"),
+					Schema.const("de-DE").description("Deutsch"),
+					Schema.const("ru-RU").description("Русский"),
+				]).description("语言设置。"),
+			})
+				.description("通用设置")
+				.i18n(pickMessages("schema", "settings")),
 		});
 
 		// 汇总所有分区 schema 为一个相交对象，作为 resolved 的解释器
 		const schema = computed(() => {
 			const list: Schema[] = [];
-			for (const settings of Object.values(ctx.internal.settings)) {
+			for (const settings of Object.values(
+				ctx.internal.settings,
+			)) {
 				for (const options of settings) {
 					if (options.schema) {
 						list.push(options.schema);
@@ -186,7 +221,9 @@ export default class SettingService extends Service {
 		ctx.effect(() => () => stop?.());
 
 		// 原始存储或 schema 集合任一变化，都重新生成 resolved
-		ctx.effect(() => watch(original, update, { deep: true }));
+		ctx.effect(() =>
+			watch(original, update, { deep: true }),
+		);
 		ctx.effect(() => watch(schema, update));
 	}
 
@@ -195,7 +232,9 @@ export default class SettingService extends Service {
 	 * 返回取消注册函数。
 	 */
 	extendSchema(extension: SchemaBase.Extension) {
-		const component = this.ctx.wrapComponent(extension.component);
+		const component = this.ctx.wrapComponent(
+			extension.component,
+		);
 		if (component) extension.component = component;
 		return this.ctx.effect(() => {
 			SchemaBase.extensions.add(extension);
@@ -207,14 +246,19 @@ export default class SettingService extends Service {
 	settings(options: SettingOptions) {
 		markRaw(options);
 		options.order ??= 0;
-		const component = this.ctx.wrapComponent(options.component);
+		const component = this.ctx.wrapComponent(
+			options.component,
+		);
 		if (component) options.component = component;
 		return this.ctx.effect(() => {
-			const list = (this.ctx.internal.settings[options.id] ||= []);
+			const list = (this.ctx.internal.settings[
+				options.id
+			] ||= []);
 			insert(list, options);
 			return () => {
 				remove(list, options);
-				if (!list.length) delete this.ctx.internal.settings[options.id];
+				if (!list.length)
+					delete this.ctx.internal.settings[options.id];
 			};
 		});
 	}

package/client/plugins/theme.ts

@@ -11,10 +11,17 @@
  */
 import { usePreferredDark } from "@vueuse/core";
 import type { Dict } from "cosmokit";
-import { type Component, computed, markRaw, reactive, watchEffect } from "vue";
+import {
+	type Component,
+	computed,
+	markRaw,
+	reactive,
+	watchEffect,
+} from "vue";
 import { Schema } from "../../../components/client/index.ts";
 import type { Context } from "../context";
 import { Service } from "../utils";
+import { pickMessages } from "./i18n";
 import { useConfig } from "./setting";
 
 declare module "../context" {
@@ -73,14 +80,38 @@ export default class ThemeService extends Service {
 
 		ctx.settings({
 			id: "appearance",
-			title: "外观设置",
+			title: () => this.ctx.$i18n.t("settings.appearance"),
 			order: 900,
 			schema: Schema.object({
 				theme: Schema.object({
+					// const 选项的显示名不受 .i18n() 递归覆盖（其词典
+					// 递归会滤掉 $ 键），故以 Dict 形态经 extra 写入
+					// meta.description（description() 方法仅收 string）
 					mode: Schema.union([
-						Schema.const("auto").description("跟随系统"),
-						Schema.const("dark").description("深色"),
-						Schema.const("light").description("浅色"),
+						Schema.const("auto").extra(
+							"description",
+							pickMessages<string>(
+								"schema",
+								"theme",
+								"mode-auto",
+							),
+						),
+						Schema.const("dark").extra(
+							"description",
+							pickMessages<string>(
+								"schema",
+								"theme",
+								"mode-dark",
+							),
+						),
+						Schema.const("light").extra(
+							"description",
+							pickMessages<string>(
+								"schema",
+								"theme",
+								"mode-light",
+							),
+						),
 					])
 						.default("auto")
 						.description("主题偏好。"),
@@ -93,18 +124,22 @@ export default class ThemeService extends Service {
 						.default("default-light")
 						.description("浅色主题。"),
 				}).description("主题设置"),
-			}),
+			}).i18n(pickMessages("schema", "theme")),
 		});
 
 		ctx.effect(() =>
 			watchEffect(
 				() => {
 					if (!config.value.theme) return;
-					const root = window.document.querySelector("html");
+					const root =
+						window.document.querySelector("html");
 					if (!root) return;
 					// 把当前主题名写到 <html theme="...">，并同步 dark 类；
 					// 主题样式与深色变量均由 CSS 依据这两个标记选择
-					root.setAttribute("theme", config.value.theme[colorMode.value]);
+					root.setAttribute(
+						"theme",
+						config.value.theme[colorMode.value],
+					);
 					if (colorMode.value === "dark") {
 						root.classList.add("dark");
 					} else {
@@ -123,16 +158,21 @@ export default class ThemeService extends Service {
 	 */
 	theme(options: ThemeOptions) {
 		markRaw(options);
-		for (const [type, component] of Object.entries(options.components || {})) {
+		for (const [type, component] of Object.entries(
+			options.components || {},
+		)) {
 			this.ctx.slot({
 				type,
-				disabled: () => config.value.theme[colorMode.value] !== options.id,
+				disabled: () =>
+					config.value.theme[colorMode.value] !==
+					options.id,
 				component,
 			});
 		}
 		return this.ctx.effect(() => {
 			this.ctx.internal.themes[options.id] = options;
-			return () => delete this.ctx.internal.themes[options.id];
+			return () =>
+				delete this.ctx.internal.themes[options.id];
 		});
 	}
 }

package/client/utils.ts

@@ -24,13 +24,18 @@ export interface Ordered {
  * 按 order 升序将条目插入有序列表（相同 order 的后者排在后面）。
  * 同时 markRaw 标记条目，避免其被 Vue 深度代理。
  */
-export function insert<T extends Ordered>(list: T[], item: T) {
+export function insert<T extends Ordered>(
+	list: T[],
+	item: T,
+) {
 	markRaw(item);
 	// order 为可选属性：任一侧缺失（undefined）时数值比较结果恒为 false，
 	// 与原实现（直接比较）在所有输入下的求值结果一致，这里显式判空以通过严格空检查
 	const index = list.findIndex(
 		(a) =>
-			a.order !== undefined && item.order !== undefined && a.order < item.order,
+			a.order !== undefined &&
+			item.order !== undefined &&
+			a.order < item.order,
 	);
 	if (index >= 0) {
 		list.splice(index, 0, item);

package/lib/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as build } from "./src-DXaM1Kgh.mjs";
+import { t as build } from "./src-BOakssV3.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.3",
+	version: "1.1.0",
 	type: "module",
 	main: "client/index.ts",
 	exports: {
@@ -104,7 +104,7 @@ async function main() {
 			await build(resolve(process.cwd(), target));
 			return;
 		}
-		await (await import("./client-CaTn_gVG.mjs")).default();
+		await (await import("./client-C97iYPCr.mjs")).default();
 		return;
 	}
 	console.error(`Unknown command ${JSON.stringify(command)}.`);

package/lib/{client-CaTn_gVG.mjs → client-C97iYPCr.mjs}

@@ -70,7 +70,7 @@ async function build(root, config = {}, isClient = false) {
 			}
 		},
 		plugins: [
-			vue(),
+			vue({ template: { compilerOptions: { comments: false } } }),
 			yaml(),
 			...config.plugins || []
 		],

package/lib/index.d.ts

@@ -6,7 +6,7 @@ import * as vite from "vite";
  * @param root 插件目录（无 `client/` 子目录时视为该插件没有前端，直接跳过）
  * @param config 额外的 vite 配置，逐层合并覆盖下方默认值
  */
-declare function build(root: string, config?: vite.UserConfig): Promise<void>;
+export declare function build(root: string, config?: vite.UserConfig): Promise<void>;
 /**
  * 创建开发模式下的 vite dev server（middlewareMode，不监听独立端口，
  * 由宿主 HTTP 服务挂载到 `/vite/` 前缀下）。
@@ -15,6 +15,5 @@ declare function build(root: string, config?: vite.UserConfig): Promise<void>;
  * @param config 额外的 vite 配置
  * @returns vite 的 ViteDevServer 实例
  */
-declare function createServer(baseDir: string, config?: vite.InlineConfig): Promise<vite.ViteDevServer>;
-//#endregion
-export { build, createServer };
+export declare function createServer(baseDir: string, config?: vite.InlineConfig): Promise<vite.ViteDevServer>;
+//#endregion

package/lib/index.mjs

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

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

@@ -82,7 +82,7 @@ async function build(root, config = {}) {
 			}
 		},
 		plugins: [
-			vue(),
+			vue({ template: { compilerOptions: { comments: false } } }),
 			yaml(),
 			(await import("unocss/vite")).default({ presets: [(await import("unocss/preset-mini")).default({ preflight: false })] })
 		],
@@ -130,7 +130,7 @@ async function createServer(baseDir, config = {}) {
 			fs: { allow: [vite.searchForWorkspaceRoot(baseDir)] }
 		},
 		plugins: [
-			vue(),
+			vue({ template: { compilerOptions: { comments: false } } }),
 			yaml(),
 			(await import("unocss/vite")).default({ presets: [(await import("unocss/preset-mini")).default({ preflight: false })] })
 		],

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@koishi-ce/client",
     "description": "Koishi Console Client",
-    "version": "1.0.3",
+    "version": "1.1.0",
     "type": "module",
     "main": "client/index.ts",
     "exports": {
@@ -64,7 +64,7 @@
         "vue-router": "^5.2.0"
     },
     "devDependencies": {
-        "@koishi-ce/koishi": "^1.0.4",
-        "@koishi-ce/plugin-console": "^1.0.3"
+        "@koishi-ce/koishi": "^1.0.8",
+        "@koishi-ce/plugin-console": "^1.1.0"
     }
 }

package/src/bin.ts

@@ -36,7 +36,11 @@ Options:
 
 async function main() {
 	const [command, ...args] = process.argv.slice(2);
-	if (command === undefined || command === "-h" || command === "--help") {
+	if (
+		command === undefined ||
+		command === "-h" ||
+		command === "--help"
+	) {
 		console.log(help);
 		return;
 	}
@@ -47,7 +51,8 @@ async function main() {
 	if (command === "build") {
 		// root 缺省时：cwd 是插件目录则构建它，否则视为宿主总装
 		const root = args.find((arg) => !arg.startsWith("-"));
-		const target = root ?? (existsSync("client") ? "." : undefined);
+		const target =
+			root ?? (existsSync("client") ? "." : undefined);
 		if (target !== undefined) {
 			await build(resolve(process.cwd(), target));
 			return;
@@ -56,7 +61,9 @@ async function main() {
 		await host.default();
 		return;
 	}
-	console.error(`Unknown command ${JSON.stringify(command)}.`);
+	console.error(
+		`Unknown command ${JSON.stringify(command)}.`,
+	);
 	console.log(help);
 	process.exitCode = 1;
 }

package/src/index.ts

@@ -33,21 +33,32 @@ interface BuildResult {
 // 将全部工作区包名映射到其源码目录,行为对齐根 tsconfig 的 paths 别名。
 // 没有被任何工作区包依赖的插件(如 plugin-logger)不会出现在 node_modules
 // 的链接里,bundler 无法按包名解析,必须显式提供这层映射。
-async function collectWorkspaceAliases(): Promise<Record<string, string>> {
+async function collectWorkspaceAliases(): Promise<
+	Record<string, string>
+> {
 	// 源码形态(src/)与产物形态(lib/)都在包根下一级,上跳四级到仓库根一致
-	const repoRoot = resolve(import.meta.dir, "../../../..").replace(/\\/g, "/");
-	const manifest = await Bun.file(`${repoRoot}/package.json`).json();
+	const repoRoot = resolve(
+		import.meta.dir,
+		"../../../..",
+	).replace(/\\/g, "/");
+	const manifest = await Bun.file(
+		`${repoRoot}/package.json`,
+	).json();
 	const aliases: Record<string, string> = {};
 	for (const pattern of manifest.workspaces ?? []) {
 		// scanSync 产出的相对路径在 Windows 上是反斜杠,统一归一化为正斜杠
-		const files = new Bun.Glob(`${pattern}/package.json`).scanSync({
+		const files = new Bun.Glob(
+			`${pattern}/package.json`,
+		).scanSync({
 			cwd: repoRoot,
 		});
 		for (const file of files) {
 			const rel = file.replaceAll("\\", "/");
 			const dir = `${repoRoot}/${rel.slice(0, -"/package.json".length)}`;
 			try {
-				const { name } = await Bun.file(`${dir}/package.json`).json();
+				const { name } = await Bun.file(
+					`${dir}/package.json`,
+				).json();
 				if (!name) continue;
 				// 控制台前端语境下,裸包名对到浏览器端入口(替代上游 lib 的 browser
 				// 导出条件);`<name>/src` 子路径对到源码目录,供共享代码引用;
@@ -56,9 +67,13 @@ async function collectWorkspaceAliases(): Promise<Record<string, string>> {
 				// 上游与 npm 产物的 exports 均未声明它,同样靠仓库内别名解析)。
 				// 子路径键必须先插入——别名解析按插入序取首个命中项
 				const clientEntry = `${dir}/client/index.ts`;
-				if (existsSync(`${dir}/src`)) aliases[`${name}/src`] = `${dir}/src`;
-				if (existsSync(clientEntry)) aliases[`${name}/client`] = clientEntry;
-				aliases[name] = existsSync(clientEntry) ? clientEntry : `${dir}/src`;
+				if (existsSync(`${dir}/src`))
+					aliases[`${name}/src`] = `${dir}/src`;
+				if (existsSync(clientEntry))
+					aliases[`${name}/client`] = clientEntry;
+				aliases[name] = existsSync(clientEntry)
+					? clientEntry
+					: `${dir}/src`;
 			} catch {}
 		}
 	}
@@ -72,7 +87,10 @@ const workspaceAliases = await collectWorkspaceAliases();
 // 类型面由根 tsconfig.client.json 的 paths 解析到 schemastery-vue-client.ts
 const runtimeShimPath = (
 	workspaceAliases["@koishi-ce/components"] ?? ""
-).replace(/client\/index\.ts$/, "client/schemastery-vue-runtime.ts");
+).replace(
+	/client\/index\.ts$/,
+	"client/schemastery-vue-runtime.ts",
+);
 
 /**
  * 构建单个 webui 插件的前端产物。
@@ -80,7 +98,10 @@ const runtimeShimPath = (
  * @param root 插件目录（无 `client/` 子目录时视为该插件没有前端，直接跳过）
  * @param config 额外的 vite 配置，逐层合并覆盖下方默认值
  */
-export async function build(root: string, config: vite.UserConfig = {}) {
+export async function build(
+	root: string,
+	config: vite.UserConfig = {},
+) {
 	if (!existsSync(`${root}/client`)) return;
 
 	// 插件可自带 `build/client.ts` 导出额外的 vite 配置覆盖下方默认值
@@ -88,7 +109,9 @@ export async function build(root: string, config: vite.UserConfig = {}) {
 	// 如 analytics 的 fuck-echarts 符号遮蔽修补
 	const overridePath = `${root}/build/client.ts`;
 	if (existsSync(overridePath)) {
-		const mod = await import(pathToFileURL(overridePath).href);
+		const mod = await import(
+			pathToFileURL(overridePath).href
+		);
 		config = vite.mergeConfig(config, mod.default ?? mod);
 	}
 
@@ -124,7 +147,9 @@ export async function build(root: string, config: vite.UserConfig = {}) {
 						// 仓库侧无法根治，直接静默
 						onwarn(warning, warn) {
 							if (
-								warning.message.includes("is being imported multiple times")
+								warning.message.includes(
+									"is being imported multiple times",
+								)
 							) {
 								return;
 							}
@@ -144,7 +169,16 @@ export async function build(root: string, config: vite.UserConfig = {}) {
 					},
 				},
 				plugins: [
-					vue(),
+					// 钉死剥离模板注释：注释写在 template 根元素之前时，SFC 会被
+					// 编译成多根 fragment，Vue 随之禁用 attribute 透传（外部传入的
+					// class 落不到 svg 上，侧栏图标因此丢掉尺寸类）；生产语义本就
+					// 应剥注释，这里显式钉死，避免随 NODE_ENV 漂移。dev server
+					// 同步钉死，保证开发态与产物行为一致
+					vue({
+						template: {
+							compilerOptions: { comments: false },
+						},
+					}),
 					yaml(),
 					(
 						await import("unocss/vite")
@@ -171,7 +205,8 @@ export async function build(root: string, config: vite.UserConfig = {}) {
 						// 源码发布的组件库），其内部以 npm 名引用组件库；重定向到
 						// 本仓库同版本（1.5.22）components 源码，避免 npm 版整套
 						// 组件库被打进插件产物
-						"@koishijs/components": workspaceAliases["@koishi-ce/components"],
+						"@koishijs/components":
+							workspaceAliases["@koishi-ce/components"],
 						// 虚拟子路径的运行时载体（补齐真实包缺失的 SchemaBase
 						// 具名导出）；类型面由 tsconfig.client.json 的 paths
 						// 解析到 schemastery-vue-client.ts
@@ -242,7 +277,16 @@ export async function createServer(
 					},
 				},
 				plugins: [
-					vue(),
+					// 钉死剥离模板注释：注释写在 template 根元素之前时，SFC 会被
+					// 编译成多根 fragment，Vue 随之禁用 attribute 透传（外部传入的
+					// class 落不到 svg 上，侧栏图标因此丢掉尺寸类）；生产语义本就
+					// 应剥注释，这里显式钉死，避免随 NODE_ENV 漂移。dev server
+					// 同步钉死，保证开发态与产物行为一致
+					vue({
+						template: {
+							compilerOptions: { comments: false },
+						},
+					}),
 					yaml(),
 					(await import("unocss/vite")).default({
 						presets: [

package/app/home/welcome.en-US.yml

@@ -1,13 +0,0 @@
-# SPDX-License-Identifier: AGPL-3.0-only
-# Copyright (c) 2019-present Shigma and Koishijs contributors.
-# Copyright (c) 2026-present Koishi-CE contributors.
-
-title: Welcome to Koishi！
-description: Your chatbot is ready to go. 点击下面的任一选项，开启你的 Koishi 之旅吧。
-action:
-  docs:
-    title: Documentation
-    description: The official documentation contains everything you want to know.
-  forum:
-    title: Forum
-    description: If you run into problems, you can always ask for help on the forum.