@koishi-ce/client 1.0.2 → 1.0.3

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 实例，独立于全局语言包），

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 总装构建的主入口）。
  *

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. -->
+
 <!--
   布局顶栏：左侧标题（默认取当前路由名）、右侧菜单区，
   移动端额外提供侧栏开关按钮与溢出菜单（"..."）按钮。

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 + 主区域。

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。

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），

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 结尾），

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）展示。

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>" 文本供落点组件识别。

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）同时充当拖拽排序的落点。

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 中列出组内成员。条目本身也是拖拽落点——

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. -->
+
 <!--
   活动栏条目间的分隔槽：平时不可见，拖拽悬停时显示横线提示，
   松手即把被拖项移动到该位置（拖拽排序的核心落点组件）。

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

package/app/theme/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.
+
 /**
  * 主题插件（控制台外壳）：
  * - 向 "root" 插槽注册应用根组件（活动栏 + 路由视图 + 状态栏 + 全局菜单层）；

package/app/theme/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. -->
+
 <!--
   控制台根组件：活动栏 + 路由页面（keep-alive 缓存） + 状态栏 + 全局菜单层。
   路由声明了所需 store 字段（route.meta.activity.fields）时，

package/app/theme/menu/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. -->
+
 <!--
   全局菜单层：渲染当前处于活动状态的所有上下文菜单（activeMenus）。
   任意 click / contextmenu 事件都视为点击了菜单外区域，关闭全部活动菜单。

package/app/theme/menu/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. -->
+
 <!--
   上下文菜单的单个菜单项：点击时调用对应 action。
   id 支持两种特殊写法："!" 前缀会被去除（兼容旧的否定式 id），

package/app/theme/menu/menu.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-menu> 的内置实现）：
   依据触发点的锚点矩形（props.relative）与自身实际尺寸，

package/app/theme/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. -->
+
 <!--
   底部状态栏容器：左右两组插槽（status-left / status-right），
   移动端（<=768px）整条隐藏。

package/client/components/chat/image.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. -->
+
 <!--
   chat-image：聊天消息中的图片。
   普通点击打开内置大图查看器（overlay.vue，经 global 插槽全局挂载）；

package/client/components/chat/overlay.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. -->
+
 <!--
   overlay.vue：全屏图片查看器（经 router 的 global 插槽挂载）。
   打开时把图片从原位"飞入"屏幕中心（appear 阶段从原坐标过渡到居中），

package/client/components/chat/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 { reactive } from "vue";
 
 /** chat 子模块的跨组件共享状态：当前在大图查看器（overlay）中展示的图片 */

package/client/components/common/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 Button from "./k-button.vue";
 import Hint from "./k-hint.vue";

package/client/components/common/k-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. -->
+
 <!--
   k-button：通用按钮组件。
   通过 type（primary / warning / success / error）着色，支持 solid（实心）、

package/client/components/common/k-hint.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-hint：带悬浮提示（tooltip）的问号图标。
   默认是纯展示的提示图标；当传入 v-model（modelValue 有值）时变为

package/client/components/common/k-tab.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：水平选项卡（文字式切换器）。
   data 为 "键 → 文案" 映射，点击某项时通过 v-model 更新选中键；

package/client/components/dynamic.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. -->
+
 <!--
   dynamic.vue：动态 schema 表单控件（any + dynamic 角色）。
   适用于"具体结构由服务端决定"的配置项：本地 schema 只带 meta.extra.name，

package/client/components/icons/activity/default.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. -->
+
 <!-- activity 侧栏页面默认图标（注册名 "activity:default"）：仪表盘样式 -->
 <template>
   <svg class="k-icon" viewBox="0 0 448 512" xmlns="http://www.w3.org/2000/svg">

package/client/components/icons/activity/ellipsis.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. -->
+
 <!-- activity 侧栏"更多"图标（注册名 "activity:ellipsis"）：三点省略号 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512">

package/client/components/icons/activity/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. -->
+
 <!-- activity 侧栏主页图标（注册名 "activity:home"）：田字格仪表盘 -->
 <template>
   <svg class="k-icon" viewBox="-64 0 1152 1024" xmlns="http://www.w3.org/2000/svg">

package/client/components/icons/activity/moon.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. -->
+
 <!-- activity 侧栏夜间模式图标（注册名 "activity:moon"）：弯月 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/activity/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. -->
+
 <!-- activity 侧栏设置页图标（注册名 "activity:settings"）：三组滑杆 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/activity/sun.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. -->
+
 <!-- activity 侧栏日间模式图标（注册名 "activity:sun"）：太阳 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/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.
+
 /**
  * 图标中心：所有内置图标的注册表与 <k-icon> 组件。
  *

package/client/components/icons/style.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.
+
 .k-icon {
   height: 1em;
 }

package/client/components/icons/svg/arrow-left.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. -->
+
 <!-- 左箭头图标（注册名 "arrow-left"），用于返回上一步 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512">

package/client/components/icons/svg/arrow-right.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. -->
+
 <!-- 右箭头图标（注册名 "arrow-right"），用于前进到下一步 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512">

package/client/components/icons/svg/box-open.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. -->
+
 <!-- 打开的收纳盒图标（注册名 "box-open"），用于插件市场类页面 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 640 512">

package/client/components/icons/svg/check-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. -->
+
 <!-- 实心圆形对勾图标（注册名 "check-full"），用于成功/已选状态 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/chevron-down.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. -->
+
 <!-- 向下的尖角箭头图标（注册名 "chevron-down"），用于展开/下拉 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512">

package/client/components/icons/svg/chevron-left.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. -->
+
 <!-- 向左的尖角箭头图标（注册名 "chevron-left"），用于折叠侧栏/上一张 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512">

package/client/components/icons/svg/chevron-right.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. -->
+
 <!-- 向右的尖角箭头图标（注册名 "chevron-right"），用于展开侧栏/下一张 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512">

package/client/components/icons/svg/chevron-up.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. -->
+
 <!-- 向上的尖角箭头图标（注册名 "chevron-up"），用于收起/上拉 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512">

package/client/components/icons/svg/clipboard-list.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. -->
+
 <!-- 带列表的写字板图标（注册名 "clipboard-list"），用于日志/列表类页面 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 384 512">

package/client/components/icons/svg/edit.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. -->
+
 <!-- 铅笔编辑图标（注册名 "edit"），用于编辑入口 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">

package/client/components/icons/svg/exclamation-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. -->
+
 <!-- 实心圆形感叹号图标（注册名 "exclamation-full"），用于错误/警告状态 -->
 <template>
   <svg class="k-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">