@koishi-ce/client 1.0.2 → 1.0.4

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.
+
 /**
  * 内置组件库的总装模块：
  *
@@ -11,10 +15,16 @@
 // 无法解析(无 paths),故直接相对导入工作区内该包的浏览器端入口,
 // 与构建器 collectWorkspaceAliases 的映射目标一致
 
-import Element, { ElLoading, ElMessage, ElMessageBox } from "element-plus";
+import Element, {
+	ElLoading,
+	ElMessage,
+	ElMessageBox,
+} from "element-plus";
 import Markdown from "marked-vue";
 import type { App } from "vue";
-import components, { SchemaBase } from "../../../components/client/index.ts";
+import components, {
+	SchemaBase,
+} from "../../../components/client/index.ts";
 
 import { store } from "../data";
 import ChatImage from "./chat/image.vue";

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";
@@ -17,7 +21,9 @@ const KActivityLink = defineComponent({
 	setup(props, { slots }) {
 		const ctx = useContext();
 		return () => {
-			const activity = props.id ? ctx.$router.pages[props.id] : undefined;
+			const activity = props.id
+				? ctx.$router.pages[props.id]
+				: undefined;
 			return h(
 				RouterLink,
 				{
@@ -26,7 +32,8 @@ const KActivityLink = defineComponent({
 						activity?.path.replace(/:.+/, "")) as string,
 				},
 				{
-					default: () => slots["default"]?.() ?? activity?.name,
+					default: () =>
+						slots["default"]?.() ?? activity?.name,
 				},
 			);
 		};

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"）按 ":" 逐级拆分，
@@ -28,7 +32,10 @@
 // schemastery-vue 链接(它是 components 的依赖,Bun 隔离布局下不跨包可见)
 
 import { store } from "@koishi-ce/client";
-import { type Schema, SchemaBase } from "@koishi-ce/components";
+import {
+	type Schema,
+	SchemaBase,
+} from "@koishi-ce/components";
 import type { CascaderOption } from "element-plus";
 import { computed, type PropType } from "vue";
 
@@ -49,15 +56,29 @@ const config = SchemaBase.useModel();
  * 逐段查找/创建级联节点；中间段（还有下级时）标记为 disabled，
  * 因为 el-cascader 的父节点勾选会影响子级，而中间段并非真实权限。
  */
-function addNode(nodes: CascaderOption[], path: string[], prefix = "") {
+function addNode(
+	nodes: CascaderOption[],
+	path: string[],
+	prefix = "",
+) {
 	const name = path.shift();
-	let node = nodes.find((node) => node.value === prefix + name);
+	let node = nodes.find(
+		(node) => node.value === prefix + name,
+	);
 	if (!node) {
-		node = { value: prefix + name, label: name, disabled: !!path.length };
+		node = {
+			value: prefix + name,
+			label: name,
+			disabled: !!path.length,
+		};
 		nodes.push(node);
 	}
 	if (!path.length) return;
-	addNode((node.children ||= []), path, `${prefix + name}:`);
+	addNode(
+		(node.children ||= []),
+		path,
+		`${prefix + name}:`,
+	);
 }
 
 // 由全部权限名构建级联选项树

package/client/components/slot.ts

@@ -1,4 +1,13 @@
-import { type App, type Component, defineComponent, h } from "vue";
+// 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";
 
 /** 插槽条目的基础形状：参与排序的组件 */
@@ -43,10 +52,15 @@ export const KSlot = defineComponent({
 				? []
 				: [...(slots["default"]?.() || [])]
 						.filter((node) => node.type === KSlotItem)
-						.map((node) => ({ node, order: node.props?.["order"] || 0 }));
+						.map((node) => ({
+							node,
+							order: node.props?.["order"] || 0,
+						}));
 			// external：ctx.slot() 注册的视图，disabled 的不渲染
 			const external = [
-				...(props.name ? ctx.$router.views[props.name] || [] : []),
+				...(props.name
+					? ctx.$router.views[props.name] || []
+					: []),
 			]
 				.filter((item) => !item.disabled?.())
 				.map((item) => ({
@@ -81,7 +95,12 @@ function defineSlotComponent(name: string) {
 	return defineComponent({
 		inheritAttrs: false,
 		setup(_, { slots, attrs }) {
-			return () => h(KSlot, { name, data: attrs, single: true }, slots);
+			return () =>
+				h(
+					KSlot,
+					{ name, data: attrs, single: true },
+					slots,
+				);
 		},
 	});
 }

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,
@@ -22,7 +26,8 @@ import ThemeService from "./plugins/theme";
 // —— 布局相关的 Context 类型扩展 ——
 
 /** 前端侧事件表：在 cordis 事件的基础上扩展本库自定义事件 */
-export interface Events<C extends Context = Context> extends cordis.Events<C> {}
+export interface Events<C extends Context = Context>
+	extends cordis.Events<C> {}
 
 /**
  * 前端 Context 接口：各服务插件通过 `declare module "../context"`
@@ -80,7 +85,10 @@ export class Context extends cordis.Context {
 		this.app = createApp(
 			defineComponent({
 				setup: () => () => [
-					h(resolveComponent("k-slot"), { name: "root", single: true }),
+					h(resolveComponent("k-slot"), {
+						name: "root",
+						single: true,
+					}),
 					h(resolveComponent("k-slot"), { name: "global" }),
 				],
 			}),
@@ -111,12 +119,16 @@ export class Context extends cordis.Context {
 	 */
 	addEventListener<K extends keyof WindowEventMap>(
 		type: K,
-		listener: (this: Window, ev: WindowEventMap[K]) => unknown,
+		listener: (
+			this: Window,
+			ev: WindowEventMap[K],
+		) => unknown,
 		options?: boolean | AddEventListenerOptions,
 	) {
 		return this.effect(() => {
 			window.addEventListener(type, listener, options);
-			return () => window.removeEventListener(type, listener, options);
+			return () =>
+				window.removeEventListener(type, listener, options);
 		});
 	}
 

package/client/data.ts

@@ -1,5 +1,12 @@
+// 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 {
+	Promisify,
+	Universal,
+} from "@koishi-ce/koishi";
 import type {
 	ClientConfig,
 	Console,
@@ -39,7 +46,8 @@ export function withProxy(url: string) {
 /** 当前与服务端的 WebSocket 连接（未连接时为 null） */
 export const socket = ref<Universal.WebSocket | null>(null);
 /** 按事件名登记的推送监听器（receive 注册） */
-const listeners: Record<string, (data: unknown) => void> = {};
+const listeners: Record<string, (data: unknown) => void> =
+	{};
 /** 按报文 id 暂存的 RPC 应答钩子 [resolve, reject]（send 写入） */
 const responseHooks: Record<
 	string,
@@ -89,19 +97,26 @@ type StoreValue = Store[keyof Store];
 
 // 服务端整表推送：直接覆盖 store 中对应键
 // （key 为联合类型时直写 store[key] 会被要求交叉类型，故经 Record 视图写入）
-receive<{ key: keyof Store; value: unknown }>("data", ({ key, value }) => {
-	(store as Record<keyof Store, StoreValue>)[key] = value as StoreValue;
-});
+receive<{ key: keyof Store; value: unknown }>(
+	"data",
+	({ key, value }) => {
+		(store as Record<keyof Store, StoreValue>)[key] =
+			value as StoreValue;
+	},
+);
 
 // 服务端增量推送：数组做追加，对象做浅合并
-receive<{ key: keyof Store; value: unknown }>("patch", ({ key, value }) => {
-	const current = store[key];
-	if (Array.isArray(current)) {
-		(current as unknown[]).push(...(value as unknown[]));
-	} else if (current) {
-		Object.assign(current, value);
-	}
-});
+receive<{ key: keyof Store; value: unknown }>(
+	"patch",
+	({ key, value }) => {
+		const current = store[key];
+		if (Array.isArray(current)) {
+			(current as unknown[]).push(...(value as unknown[]));
+		} else if (current) {
+			Object.assign(current, value);
+		}
+	},
+);
 
 // RPC 应答分发：按报文 id 找到 send() 留下的 resolve/reject 并结算
 receive<{ id: string; value?: unknown; error?: unknown }>(
@@ -127,7 +142,10 @@ receive<{ id: string; value?: unknown; error?: unknown }>(
  * @param ctx 根 Context，用于把消息转发为 cordis 事件
  * @param callback 创建 WebSocket 实例的工厂函数
  */
-export function connect(ctx: Context, callback: () => Universal.WebSocket) {
+export function connect(
+	ctx: Context,
+	callback: () => Universal.WebSocket,
+) {
 	const value = callback();
 
 	let sendTimer: number;
@@ -138,8 +156,14 @@ export function connect(ctx: Context, callback: () => Universal.WebSocket) {
 		if (!global.heartbeat) return;
 		clearTimeout(sendTimer);
 		clearTimeout(closeTimer);
-		sendTimer = +setTimeout(() => send("ping"), global.heartbeat.interval);
-		closeTimer = +setTimeout(() => value?.close(), global.heartbeat.timeout);
+		sendTimer = +setTimeout(
+			() => send("ping"),
+			global.heartbeat.interval,
+		);
+		closeTimer = +setTimeout(
+			() => value?.close(),
+			global.heartbeat.timeout,
+		);
 	};
 
 	const reconnect = () => {
@@ -148,10 +172,14 @@ export function connect(ctx: Context, callback: () => Universal.WebSocket) {
 		for (const key in store) {
 			(store as Record<string, unknown>)[key] = undefined;
 		}
-		console.log("[koishi] websocket disconnected, will retry in 1s...");
+		console.log(
+			"[koishi] websocket disconnected, will retry in 1s...",
+		);
 		setTimeout(() => {
 			connect(ctx, callback).then(location.reload, () => {
-				console.log("[koishi] websocket disconnected, will retry in 1s...");
+				console.log(
+					"[koishi] websocket disconnected, will retry in 1s...",
+				);
 			});
 		}, 1000);
 	};
@@ -159,7 +187,12 @@ export function connect(ctx: Context, callback: () => Universal.WebSocket) {
 	value.addEventListener("message", (ev) => {
 		refresh();
 		const data = JSON.parse(ev.data);
-		console.debug("↓%c", "color:purple", data.type, data.body);
+		console.debug(
+			"↓%c",
+			"color:purple",
+			data.type,
+			data.body,
+		);
 		if (data.type in listeners) {
 			listeners[data.type]?.(data.body);
 		}
@@ -168,11 +201,13 @@ export function connect(ctx: Context, callback: () => Universal.WebSocket) {
 
 	value.addEventListener("close", reconnect);
 
-	return new Promise<Universal.WebSocket.Event>((resolve, reject) => {
-		value.addEventListener("open", (event) => {
-			socket.value = markRaw(value);
-			resolve(event);
-		});
-		value.addEventListener("error", reject);
-	});
+	return new Promise<Universal.WebSocket.Event>(
+		(resolve, reject) => {
+			value.addEventListener("open", (event) => {
+				socket.value = markRaw(value);
+				resolve(event);
+			});
+			value.addEventListener("error", reject);
+		},
+	);
 }

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 控制台前端组件库）。
  *
@@ -33,7 +37,8 @@ export const ScopeStatus = {
 	DISPOSED: 4,
 } as const;
 
-export type ScopeStatus = (typeof ScopeStatus)[keyof typeof ScopeStatus];
+export type ScopeStatus =
+	(typeof ScopeStatus)[keyof typeof ScopeStatus];
 export * from "./components";
 export * from "./context";
 export * from "./data";

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）与菜单服务：控制台的快捷键、右键菜单、
  * 作用域变量的统一管理。
@@ -7,7 +11,11 @@
  * 绑定右键菜单。作用域变量支持 "a.b" 点分键，经 Flatten 类型
  * 与运行时代理呈现为嵌套对象。
  */
-import { type Dict, type Intersect, remove } from "cosmokit";
+import {
+	type Dict,
+	type Intersect,
+	remove,
+} from "cosmokit";
 import {
 	type MaybeRefOrGetter,
 	markRaw,
@@ -54,7 +62,8 @@ export interface ActionOptions {
 }
 
 /** 旧版菜单项写法（字段与 ActionOptions 部分重叠），仅为兼容保留 */
-export type LegacyMenuItem = Partial<ActionOptions> & Omit<MenuItem, "id">;
+export type LegacyMenuItem = Partial<ActionOptions> &
+	Omit<MenuItem, "id">;
 
 /** 菜单项：label / type / icon 均支持写成随作用域变化的 getter */
 export interface MenuItem {
@@ -66,10 +75,14 @@ export interface MenuItem {
 }
 
 /** 值或（以作用域为参数的）取值函数 */
-export type MaybeGetter<T> = T | ((scope: Flatten<ActionContext>) => T);
+export type MaybeGetter<T> =
+	| T
+	| ((scope: Flatten<ActionContext>) => T);
 
 /** 作用域存储：扁平键到「值或 ref 或 getter」的映射 */
-type Store<S extends {}> = { [K in keyof S]?: MaybeRefOrGetter<S[K]> };
+type Store<S extends {}> = {
+	[K in keyof S]?: MaybeRefOrGetter<S[K]>;
+};
 
 /**
  * 把 "a.b.c" 形式的扁平键名归并为 { a: { b: { c } } } 的嵌套结构，
@@ -99,9 +112,14 @@ export interface ActiveMenu {
  * 触发时把附加值写入作用域，并在鼠标位置弹出自定义菜单（由 global 插槽渲染）。
  * @param id 菜单标识，menu() 注册的条目将展示在该菜单中
  */
-export function useMenu<K extends keyof ActionContext>(id: K) {
+export function useMenu<K extends keyof ActionContext>(
+	id: K,
+) {
 	const ctx = useContext();
-	return (event: MouseEvent, value: MaybeRefOrGetter<ActionContext[K]>) => {
+	return (
+		event: MouseEvent,
+		value: MaybeRefOrGetter<ActionContext[K]>,
+	) => {
 		ctx.define(id, value);
 		event.preventDefault();
 		const { clientX, clientY } = event;
@@ -129,7 +147,9 @@ export default class ActionService extends Service {
 		super(ctx, "$action", true);
 		ctx.mixin("$action", ["action", "menu", "define"]);
 
-		ctx.internal.scope = shallowReactive({} as Store<ActionContext>);
+		ctx.internal.scope = shallowReactive(
+			{} as Store<ActionContext>,
+		);
 		ctx.internal.menus = reactive({});
 		ctx.internal.actions = reactive({});
 		ctx.internal.activeMenus = reactive([]);
@@ -138,7 +158,9 @@ export default class ActionService extends Service {
 		// 与键盘事件逐项比对（ctrl 在 macOS 平台映射为 meta 键）
 		ctx.addEventListener("keydown", (event) => {
 			const scope = this.createScope();
-			for (const action of Object.values(ctx.internal.actions)) {
+			for (const action of Object.values(
+				ctx.internal.actions,
+			)) {
 				if (!action.shortcut) continue;
 				const keys = action.shortcut
 					.split("+")
@@ -154,7 +176,11 @@ export default class ActionService extends Service {
 							continue;
 						case "ctrl":
 							// macOS 没有 ctrl+字母 的快捷键惯例，改用 Cmd（meta）
-							if (navigator.platform.toLowerCase().includes("mac")) {
+							if (
+								navigator.platform
+									.toLowerCase()
+									.includes("mac")
+							) {
 								metaKey = true;
 							} else {
 								ctrlKey = true;
@@ -191,7 +217,8 @@ export default class ActionService extends Service {
 			items.forEach((item) => insert(list, item));
 			return () => {
 				items.forEach((item) => remove(list, item));
-				if (!list.length) delete this.ctx.internal.menus[id];
+				if (!list.length)
+					delete this.ctx.internal.menus[id];
 			};
 		});
 	}
@@ -218,7 +245,10 @@ export default class ActionService extends Service {
 	 * 可用 override 临时覆盖若干键值。
 	 */
 	createScope(override = {}) {
-		const scope = { ...this.ctx.internal.scope, ...override };
+		const scope = {
+			...this.ctx.internal.scope,
+			...override,
+		};
 		return createScope(scope);
 	}
 }
@@ -237,11 +267,18 @@ function createScope(
 			if (typeof key === "symbol")
 				return (target as Record<symbol, unknown>)[key];
 			key = prefix + key;
-			const source = scope as Record<string, MaybeRefOrGetter<unknown>>;
+			const source = scope as Record<
+				string,
+				MaybeRefOrGetter<unknown>
+			>;
 			if (key in scope) return toValue(source[key]);
 			// 键本身不存在，但存在以其为前缀的子键：返回子级作用域代理
 			const _prefix = `${key}.`;
-			if (Object.keys(scope).some((k) => k.startsWith(_prefix))) {
+			if (
+				Object.keys(scope).some((k) =>
+					k.startsWith(_prefix),
+				)
+			) {
 				return createScope(scope, `${key}.`);
 			}
 			// 完全未命中：显式返回 undefined（noImplicitReturns）

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";