@koishi-ce/client 1.0.2 → 1.0.4

package/README.md

@@ -0,0 +1,56 @@
+# @koishi-ce/client
+
+**简体中文** | [English](#english)
+
+Koishi 控制台的浏览器端运行时与组件基座，移植自上游 [koishijs/webui](https://github.com/koishijs/webui) 的 `packages/client`。它承载控制台前端的全部基础设施——根 Context、服务与插件系统、路由与活动栏、状态管理、主题、动作与菜单——同时提供把各控制台插件的前端组装为可部署产物的编程式构建器。
+
+与 [`@koishi-ce/plugin-console`](https://github.com/Koishi-CE/koishi/tree/main/plugins/webui/console)（node 侧宿主）的分工：本包运行在浏览器，是前端基座；plugin-console 运行在 node，负责 WebSocket 通道与静态资源托管。宿主总装产物直接写入 plugin-console 的 `dist` 目录。
+
+## 主要导出
+
+- `root` 与 `Context`：唯一根上下文实例与其类型；
+- `defineExtension`：控制台插件前端扩展的定义入口；
+- `Service`：前端侧服务基类；
+- 路由与活动：`RouterService`、`Activity`、`redirectTo`；
+- 状态：`store`（reactive 全局状态）及 `socket` / `send` / `receive` / `connect`；
+- 设置与主题：`createStorage`、`useConfig`、`SettingService`、`useColorMode`、`ThemeService`；
+- 动作与菜单：`useMenu` 与 ActionService（动作面板、菜单注册、全局快捷键分发）；
+- 国际化：I18nService；
+- element-plus 的 `loading` / `message` / `messageBox` 服务封装；
+- `Satori` / `Universal` 命名空间与 `ScopeStatus` 常量。
+
+## 构建器
+
+本包没有独立的运行时发布形态，而是作为源码被各前端工程消费：
+
+- CLI：`koishi-console build [root]`（`src/bin.ts`）——带 root 时构建单个插件的前端，否则执行宿主控制台总装（产物硬编码到 `plugins/webui/console/dist`，含共享 chunk 与样式）；
+- 编程式：`build(root, config)` 构建单个插件前端，`createServer(baseDir)` 创建 Vite 开发中间件；
+- `collectWorkspaceAliases()`：读取根 package.json 的 workspaces，为每个工作区包名建立指向其 `client/index.ts` 的别名——未被依赖的 workspace 包不会出现在 node_modules 链接里，必须显式映射才能被 bundler 解析。
+
+## 许可证
+
+[AGPL-3.0](https://github.com/Koishi-CE/koishi/blob/main/LICENSES/AGPL-3.0.txt)。本包是上游 koishijs/webui 的社区再分发，版权归 Shigma 及 Koishijs 贡献者（上游）与 Koishi-CE 贡献者，见 [NOTICE](https://github.com/Koishi-CE/koishi/blob/main/NOTICE)。
+
+---
+
+## English
+
+The browser-side runtime and component foundation of the Koishi console, ported from `packages/client` of the upstream [koishijs/webui](https://github.com/koishijs/webui). It hosts the entire frontend infrastructure — the root Context, services and plugin system, router and activity bar, state management, themes, actions and menus — and ships a programmatic builder that assembles console plugin frontends into deployable bundles.
+
+Division of labor with [`@koishi-ce/plugin-console`](https://github.com/Koishi-CE/koishi/tree/main/plugins/webui/console) (the node-side host): this package runs in the browser as the frontend foundation, while plugin-console runs on node serving the WebSocket channel and static assets. Host assembly output is written straight into plugin-console's `dist` directory.
+
+## Key exports
+
+`root` and `Context` (the single root context), `defineExtension` (entry for console plugin frontends), the frontend `Service` base, `RouterService` / `Activity` / `redirectTo`, the reactive `store` with `socket` / `send` / `receive` / `connect`, settings and theming (`createStorage`, `useConfig`, `SettingService`, `useColorMode`, `ThemeService`), actions and menus (`useMenu`, ActionService with global shortcut dispatch), I18nService, element-plus service wrappers (`loading` / `message` / `messageBox`), plus the `Satori` / `Universal` namespaces and `ScopeStatus`.
+
+## Builder
+
+The package is consumed as source code rather than shipped as a standalone runtime:
+
+- CLI: `koishi-console build [root]` — builds a single plugin frontend when a root is given, otherwise performs the host console assembly (output hardcoded to `plugins/webui/console/dist`).
+- Programmatic: `build(root, config)` and `createServer(baseDir)` (a Vite dev middleware).
+- `collectWorkspaceAliases()` — maps every workspace package to its `client/index.ts`; workspace packages absent from node_modules links can only be resolved through this explicit alias map.
+
+## License
+
+[AGPL-3.0](https://github.com/Koishi-CE/koishi/blob/main/LICENSES/AGPL-3.0.txt). Community redistribution of upstream koishijs/webui; copyright Shigma and Koishijs contributors (upstream) and Koishi-CE contributors — see [NOTICE](https://github.com/Koishi-CE/koishi/blob/main/NOTICE).

package/app/home/home.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. -->
+
 <!--
   控制台首页：WebSocket 就绪后渲染 "home" 插槽内容（默认为欢迎卡片），
   未连接时显示连接提示卡片。

package/app/home/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.
+
 /**
  * 首页插件：将 welcome 欢迎页注册为根路由 "/"。
  * order 取极大值（活动栏 top 组渲染时按 order 逆序输出，故首页位于最顶部）。

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

@@ -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.
+
 title: Welcome to Koishi！
 description: Your chatbot is ready to go. 点击下面的任一选项，开启你的 Koishi 之旅吧。
 action:

package/app/home/welcome.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. -->
+
 <!--
   欢迎卡片：文档 / 社区论坛等入口链接。
   自带 zh-CN 与 en-US 两套文案（局部 vue-i18n 实例，独立于全局语言包），
@@ -41,12 +45,18 @@ const { t, setLocaleMessage } = useI18n({
 
 // 开发模式下 yml 文案改动即时热替换，无需整页刷新
 if (import.meta.hot) {
-	import.meta.hot.accept("./welcome.zh-CN.yml", (module) => {
-		setLocaleMessage("zh-CN", module.default);
-	});
-	import.meta.hot.accept("./welcome.en-US.yml", (module) => {
-		setLocaleMessage("en-US", module.default);
-	});
+	import.meta.hot.accept(
+		"./welcome.zh-CN.yml",
+		(module) => {
+			setLocaleMessage("zh-CN", module.default);
+		},
+	);
+	import.meta.hot.accept(
+		"./welcome.en-US.yml",
+		(module) => {
+			setLocaleMessage("en-US", module.default);
+		},
+	);
 }
 </script>
 

package/app/home/welcome.zh-CN.yml

@@ -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.
+
 title: 欢迎使用 Koishi！
 description: 你的机器人已经准备就绪。点击下面的任一选项，开启你的 Koishi 之旅吧。
 action:

package/app/index.scss

@@ -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.
+
 body {
   margin: 0;
   min-height: 100vh;

package/app/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.
+
 /**
  * 控制台前端宿主应用入口（scripts/client.ts 总装构建的主入口）。
  *
@@ -27,6 +31,12 @@ root.start();
 
 if (!global.static) {
 	// global.static 为真表示纯静态构建（无后端），跳过连接
-	const endpoint = new URL(global.endpoint, location.origin).toString();
-	connect(root, () => new WebSocket(endpoint.replace(/^http/, "ws")));
+	const endpoint = new URL(
+		global.endpoint,
+		location.origin,
+	).toString();
+	connect(
+		root,
+		() => new WebSocket(endpoint.replace(/^http/, "ws")),
+	);
 }

package/app/layout/header.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. -->
+
 <!--
   布局顶栏：左侧标题（默认取当前路由名）、右侧菜单区，
   移动端额外提供侧栏开关按钮与溢出菜单（"..."）按钮。
@@ -34,7 +38,10 @@
 </template>
 
 <script lang="ts" setup>
-import { type ActionContext, useMenu } from "@koishi-ce/client";
+import {
+	type ActionContext,
+	useMenu,
+} from "@koishi-ce/client";
 import { useRoute } from "vue-router";
 
 const props = defineProps<{
@@ -46,9 +53,14 @@ const props = defineProps<{
 
 // 溢出菜单按钮的点击触发器：打开 menuKey 对应的上下文菜单
 // （menuKey 为运行期字符串，这里断言为菜单键类型以复用字面量重载）
-const trigger = useMenu(props.menuKey as keyof ActionContext);
-
-defineEmits(["update:isLeftAsideOpen", "update:isRightAsideOpen"]);
+const trigger = useMenu(
+	props.menuKey as keyof ActionContext,
+);
+
+defineEmits([
+	"update:isLeftAsideOpen",
+	"update:isRightAsideOpen",
+]);
 
 const route = useRoute();
 </script>

package/app/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.
+
 /**
  * 布局插件：向全局 "layout" 插槽注册三栏布局组件。
  * order 取极小值保证它先于其它同插槽内容排序（作为页面骨架）。

package/app/layout/layout.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-layout> 的内置实现）：
   可选的左右侧栏 + 顶部 header + 主区域。
@@ -50,7 +54,10 @@
 </template>
 
 <script lang="ts" setup>
-import { type LegacyMenuItem, useContext } from "@koishi-ce/client";
+import {
+	type LegacyMenuItem,
+	useContext,
+} from "@koishi-ce/client";
 import { computed, ref, useSlots } from "vue";
 import { useRoute } from "vue-router";
 import LayoutHeader from "./header.vue";

package/app/layout/menu-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. -->
+
 <!--
   顶栏菜单按钮（图标型）：hidden/disabled/label/icon 均支持 getter，
   点击时以 action scope 为参调用对应 action。
@@ -50,7 +54,9 @@ const scope = computed(() =>
 function toValue<T>(getter: MaybeGetter<T>): T {
 	if (typeof getter !== "function") return getter;
 	// 收窄到 MaybeGetter 的函数分支（以作用域为参的 getter）
-	return (getter as (current: typeof scope.value) => T)(scope.value);
+	return (getter as (current: typeof scope.value) => T)(
+		scope.value,
+	);
 }
 
 function trigger() {

package/app/settings/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.
+
 /**
  * 设置插件：
  * - 注册用户设置页（/settings/:name*，活动栏底部）；

package/app/settings/settings.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. -->
+
 <!--
   用户设置页：左侧 el-tree 分组导航 + 右侧当前分组的内容。
   分组内的条目三种形态二选一渲染：组件型（component）、表单型（schema），
@@ -52,10 +56,12 @@ interface Tree {
 }
 
 const data = computed(() =>
-	Object.entries(ctx.internal.settings).map<Tree>(([id, [{ title }]]) => ({
-		id,
-		label: title,
-	})),
+	Object.entries(ctx.internal.settings).map<Tree>(
+		([id, [{ title }]]) => ({
+			id,
+			label: title,
+		}),
+	),
 );
 
 function handleClick(tree: Tree) {

package/app/settings/theme.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. -->
+
 <!--
   主题选择器：role 为 "theme" 的字符串 schema 的专用渲染组件。
   下拉选项按明 / 暗模式过滤（主题 id 以 -light / -dark 结尾），
@@ -31,7 +35,10 @@
 
 <script setup lang="ts">
 import { useContext, useI18nText } from "@koishi-ce/client";
-import { type Schema, SchemaBase } from "@koishi-ce/components";
+import {
+	type Schema,
+	SchemaBase,
+} from "@koishi-ce/components";
 import { computed, type PropType } from "vue";
 
 defineProps({

package/app/shims.d.ts

@@ -1 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /// <reference path="../client/shims.d.ts" />

package/app/status/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.
+
 /**
  * 状态栏插件：向全局 "status" 插槽注册状态栏主体（可悬停出 tooltip 的
  * 状态项容器），并向 "status-right" 插槽注册页面组件加载进度条。

package/app/status/loading.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. -->
+
 <!--
   页面组件按需加载进度条：按当前路由所需扩展（ctx.$loader.extensions）
   的完成比例显示进度；store.entry 尚未就绪时以不确定进度（indeterminate）展示。
@@ -18,6 +22,9 @@ const ctx = useContext();
 
 const progress = computed(() => {
 	const states = Object.values(ctx.$loader.extensions);
-	return states.filter((state) => state.done.value).length / states.length;
+	return (
+		states.filter((state) => state.done.value).length /
+		states.length
+	);
 });
 </script>

package/app/status/status.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-status> 的内置实现）：
   内容区 + 悬停时的 tooltip（内容经 el-scrollbar 限高滚动）。

package/app/styles/element.scss

@@ -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.
+
 :root {
   --el-text-color-regular: var(--fg1);
   --el-text-color-primary: var(--fg2);

package/app/styles/hc.scss

@@ -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.
+
 :root, .theme-root.light {
   &[theme=hc-light] {
     --bg0: white;

package/app/styles/index.scss

@@ -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.
+
 @use 'sass:color';
 @use './layout.scss';
 @use './element.scss';

package/app/styles/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.
+
 /**
  * 全局样式插件：引入 app 级 SCSS，并注册四套内置主题
  * （默认 / 高对比 × 明亮 / 暗色），供主题选择器列出与切换。

package/app/styles/layout.scss

@@ -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.
+
 :root {
   --aside-width: 17.5rem;
   --activity-width: 4rem;

package/app/theme/activity/button.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. -->
+
 <!--
   活动栏单个图标按钮，也是拖拽排序的拖拽源：
   拖起时向 dataTransfer 写入 "activity:<id>" 文本供落点组件识别。
@@ -29,7 +33,10 @@ const isDragging = ref(false);
 function handleDragStart(event: DragEvent) {
 	isDragging.value = true;
 	// 约定的拖拽协议：以 "activity:" 前缀 + 活动 id 标识被拖动的活动项
-	event.dataTransfer.setData("text/plain", `activity:${props.data.id}`);
+	event.dataTransfer.setData(
+		"text/plain",
+		`activity:${props.data.id}`,
+	);
 }
 
 function handleDragEnd(event: DragEvent) {

package/app/theme/activity/index.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. -->
+
 <!--
   活动栏（最左侧图标栏）：分 top / bottom 两区渲染活动项，
   项与项之间的分隔槽（activity-separator）同时充当拖拽排序的落点。
@@ -68,7 +72,9 @@ const groups = computed(() => {
 			delete available[id];
 		}
 	}
-	const list = Object.values(available).sort(([a], [b]) => a.order - b.order);
+	const list = Object.values(available).sort(
+		([a], [b]) => a.order - b.order,
+	);
 	// 放不下时：从头部取出溢出项折叠成一个组，top 位优先、同位再按 order 排，
 	// 并以 "..." 图标作为该组的展示入口
 	if (list.length * unit > total) {
@@ -82,11 +88,17 @@ const groups = computed(() => {
 				return scale;
 			})
 			.flat();
-		hidden.unshift({ icon: "activity:ellipsis" } as Activity);
+		hidden.unshift({
+			icon: "activity:ellipsis",
+		} as Activity);
 	}
 	// top 区按 order 逆序输出（order 大者靠上），bottom 区保持正序
-	const top = list.filter(([data]) => data.position !== "bottom").reverse();
-	const bottom = list.filter(([data]) => data.position === "bottom");
+	const top = list
+		.filter(([data]) => data.position !== "bottom")
+		.reverse();
+	const bottom = list.filter(
+		([data]) => data.position === "bottom",
+	);
 	return { top, bottom, hidden };
 });
 

package/app/theme/activity/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. -->
+
 <!--
   活动栏条目：children[0] 为组的主图标，其余为并入该组的子活动，
   悬停 tooltip 中列出组内成员。条目本身也是拖拽落点——
@@ -34,7 +38,11 @@
 </template>
 
 <script lang="ts" setup>
-import { type Activity, useConfig, useMenu } from "@koishi-ce/client";
+import {
+	type Activity,
+	useConfig,
+	useMenu,
+} from "@koishi-ce/client";
 import type { Placement } from "element-plus";
 import { computed, ref, watch } from "vue";
 import { useRoute } from "vue-router";
@@ -80,13 +88,23 @@ const config = useConfig();
 
 // 原型链保留键：这类键在普通对象上会触发原型链存取器，禁止作为配置键读写
 // （id 来自拖拽事件的 dataTransfer 文本，属外部输入）
-const UNSAFE_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+const UNSAFE_KEYS = new Set([
+	"__proto__",
+	"constructor",
+	"prototype",
+]);
 
 /** 取某活动的覆盖配置（不存在则创建）；保留键返回一次性空对象，防原型污染。
  * 守卫须用显式字符串比较（Set.has 形式 CodeQL 无法识别为阻断） */
-function ensureOverride(id: string): Record<string, unknown> {
+function ensureOverride(
+	id: string,
+): Record<string, unknown> {
 	const activities = (config.value.activities ??= {});
-	if (id === "__proto__" || id === "constructor" || id === "prototype") {
+	if (
+		id === "__proto__" ||
+		id === "constructor" ||
+		id === "prototype"
+	) {
 		return {};
 	}
 	return (activities[id] ??= {});

package/app/theme/activity/separator.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. -->
+
 <!--
   活动栏条目间的分隔槽：平时不可见，拖拽悬停时显示横线提示，
   松手即把被拖项移动到该位置（拖拽排序的核心落点组件）。
@@ -14,7 +18,11 @@
 </template>
 
 <script lang="ts" setup>
-import { type Activity, useConfig, useContext } from "@koishi-ce/client";
+import {
+	type Activity,
+	useConfig,
+	useContext,
+} from "@koishi-ce/client";
 import { type ComputedRef, inject, ref } from "vue";
 
 type Position = "top" | "bottom";
@@ -24,7 +32,9 @@ const props = defineProps<{
 	position: Position;
 }>();
 
-const groups = inject("groups") as ComputedRef<Record<Position, Activity[][]>>;
+const groups = inject("groups") as ComputedRef<
+	Record<Position, Activity[][]>
+>;
 
 const hasDragOver = ref(false);
 
@@ -41,13 +51,23 @@ const ctx = useContext();
 
 // 原型链保留键：这类键在普通对象上会触发原型链存取器，禁止作为配置键读写
 // （id 来自拖拽事件的 dataTransfer 文本，属外部输入）
-const UNSAFE_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+const UNSAFE_KEYS = new Set([
+	"__proto__",
+	"constructor",
+	"prototype",
+]);
 
 /** 取某活动的覆盖配置（不存在则创建）；保留键返回一次性空对象，防原型污染。
  * 守卫须用显式字符串比较（Set.has 形式 CodeQL 无法识别为阻断） */
-function ensureOverride(id: string): Record<string, unknown> {
+function ensureOverride(
+	id: string,
+): Record<string, unknown> {
 	const activities = (config.value.activities ??= {});
-	if (id === "__proto__" || id === "constructor" || id === "prototype") {
+	if (
+		id === "__proto__" ||
+		id === "constructor" ||
+		id === "prototype"
+	) {
 		return {};
 	}
 	return (activities[id] ??= {});
@@ -59,7 +79,9 @@ function handleDrop(event: DragEvent) {
 	// 只响应活动栏自身的拖拽协议
 	if (!text.startsWith("activity:")) return;
 	const id = text.slice(9);
-	const list = groups.value[props.position].map(([item]) => item);
+	const list = groups.value[props.position].map(
+		([item]) => item,
+	);
 	const oldIndex = list.findIndex((item) => item.id === id);
 	// 落点即原位（含紧邻原位的前一格）时无需移动
 	if (
@@ -95,10 +117,12 @@ function handleDrop(event: DragEvent) {
 	// 介于两锚点之间的项按线性插值重算 order；
 	// 只有一侧锚点时按步长 100 单向递增 / 递减；两侧都没有则恢复默认
 	const anchorL = list.findLastIndex(
-		(item, i) => i < index && item.order === item.options.order,
+		(item, i) =>
+			i < index && item.order === item.options.order,
 	);
 	const anchorR = list.findIndex(
-		(item, i) => i > index && item.order === item.options.order,
+		(item, i) =>
+			i > index && item.order === item.options.order,
 	);
 	if (anchorL === -1) {
 		if (anchorR === -1) {
@@ -113,24 +137,36 @@ function handleDrop(event: DragEvent) {
 	} else {
 		if (anchorR === -1) {
 			let order = list[anchorL].options.order;
-			for (let index = anchorL + 1; index < list.length; index++) {
+			for (
+				let index = anchorL + 1;
+				index < list.length;
+				index++
+			) {
 				const override = ensureOverride(list[index].id);
 				override.order = order -= 100;
 			}
 		} else {
 			let orderL = list[anchorL].options.order;
 			let orderR = list[anchorR].options.order;
-			for (let index = anchorL + 1; index < anchorR; index++) {
+			for (
+				let index = anchorL + 1;
+				index < anchorR;
+				index++
+			) {
 				const override = ensureOverride(list[index].id);
 				override.order =
 					orderL +
-					((orderR - orderL) * (index - anchorL)) / (anchorR - anchorL);
+					((orderR - orderL) * (index - anchorL)) /
+						(anchorR - anchorL);
 			}
 		}
 	}
 
 	// 覆盖配置为空对象时删除该键，避免残留无意义的配置项
-	if (!Object.keys(override).length && !UNSAFE_KEYS.has(id)) {
+	if (
+		!Object.keys(override).length &&
+		!UNSAFE_KEYS.has(id)
+	) {
 		delete config.value.activities[id];
 	}
 }

package/app/theme/activity/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.
+
 /**
  * 活动栏（activity bar）相关的类型扩充：
  * - 为 ActionContext 补充 "theme.activity" 菜单的求值上下文类型；

package/app/theme/blank.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. -->
+
 <!-- 404 空白页：控制台本体加载成功但没有任何扩展页面时的兜底展示 -->
 <template>
   <div class="blank">