@koishi-ce/client 1.0.4 → 1.1.0

package/README.md

@@ -25,7 +25,7 @@ Koishi 控制台的浏览器端运行时与组件基座，移植自上游 [koish
 
 - 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 解析。
+- `collectWorkspaceAliases()`（内部机制，未从包导出）：读取根 package.json 的 workspaces，为每个工作区包名建立指向其 `client/index.ts` 的别名——未被依赖的 workspace 包不会出现在 node_modules 链接里，必须显式映射才能被 bundler 解析。
 
 ## 许可证
 
@@ -49,7 +49,7 @@ The package is consumed as source code rather than shipped as a standalone runti
 
 - 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.
+- `collectWorkspaceAliases()` (an internal mechanism, not exported from the package) — 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
 

package/app/home/home.vue

@@ -16,14 +16,17 @@
       </k-slot>
     </el-scrollbar>
     <div v-else>
-      <k-card class="connect">正在连接到 Koishi 服务器……</k-card>
+      <k-card class="connect">{{ t('home.connecting') }}</k-card>
     </div>
   </k-layout>
 </template>
 
 <script lang="ts" setup>
 import { global, socket } from "@koishi-ce/client";
+import { useI18n } from "vue-i18n";
 import Welcome from "./welcome.vue";
+
+const { t } = useI18n();
 </script>
 
 <style lang="scss">

package/app/home/index.ts

@@ -14,7 +14,8 @@ export default function (ctx: Context) {
 	ctx.page({
 		id: "home",
 		path: "/",
-		name: "欢迎",
+		// name 传 getter：渲染层解析（MaybeRefOrGetter），随界面语言切换
+		name: () => ctx.$i18n.t("pages.home"),
 		icon: "activity:home",
 		order: 1000,
 		component: Home,

package/app/home/welcome.vue

@@ -4,25 +4,25 @@
 
 <!--
   欢迎卡片：文档 / 社区论坛等入口链接。
-  自带 zh-CN 与 en-US 两套文案（局部 vue-i18n 实例，独立于全局语言包），
+  文案走宿主全局词典（client/locales/，7 语种），
   其余扩展可通过 "welcome-choice" 插槽追加自定义入口。
 -->
 <template>
   <div class="k-card welcome">
-    <h1>{{ t('title') }}</h1>
-    <p>{{ t('description') }}</p>
+    <h1>{{ t('welcome.title') }}</h1>
+    <p>{{ t('welcome.description') }}</p>
     <div class="choices">
       <k-slot name="welcome-choice">
         <k-slot-item :order="1000">
           <a class="choice" href="https://koishi.chat" rel="noopener noreferer" target="_blank">
-            <h2>{{ t('action.docs.title') }}</h2>
-            <p>{{ t('action.docs.description') }}</p>
+            <h2>{{ t('welcome.docs.title') }}</h2>
+            <p>{{ t('welcome.docs.description') }}</p>
           </a>
         </k-slot-item>
         <k-slot-item :order="500">
           <a class="choice" href="https://k.ilharp.cc" rel="noopener noreferer" target="_blank">
-            <h2>{{ t('action.forum.title') }}</h2>
-            <p>{{ t('action.forum.description') }}</p>
+            <h2>{{ t('welcome.forum.title') }}</h2>
+            <p>{{ t('welcome.forum.description') }}</p>
           </a>
         </k-slot-item>
       </k-slot>
@@ -32,32 +32,9 @@
 
 <script lang="ts" setup>
 import { useI18n } from "vue-i18n";
-import enUS from "./welcome.en-US.yml";
-import zhCN from "./welcome.zh-CN.yml";
 
-// 组件私有的双语文案：不依赖全局 i18n，确保欢迎页在任何语言环境下可用
-const { t, setLocaleMessage } = useI18n({
-	messages: {
-		"zh-CN": zhCN,
-		"en-US": enUS,
-	},
-});
-
-// 开发模式下 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);
-		},
-	);
-}
+// 全局 composer：词典由宿主 $i18n 服务在挂载前注入
+const { t } = useI18n();
 </script>
 
 <style lang="scss">

package/app/settings/index.ts

@@ -16,7 +16,8 @@ import Theme from "./theme.vue";
 export default function (ctx: Context) {
 	ctx.page({
 		path: "/settings/:name*",
-		name: "用户设置",
+		// name / title 传 getter：渲染层解析，随界面语言切换
+		name: () => ctx.$i18n.t("pages.settings"),
 		icon: "activity:settings",
 		position: "bottom",
 		order: -100,
@@ -31,7 +32,7 @@ export default function (ctx: Context) {
 
 	ctx.settings({
 		id: "status",
-		title: "状态栏设置",
+		title: () => ctx.$i18n.t("settings.status"),
 		order: 800,
 	});
 

package/app/settings/settings.vue

@@ -5,12 +5,12 @@
 <!--
   用户设置页：左侧 el-tree 分组导航 + 右侧当前分组的内容。
   分组内的条目三种形态二选一渲染：组件型（component）、表单型（schema），
-  disabled 的条目直接跳过。
+  disabled 的条目直接跳过。分区标题支持 getter（随界面语言实时切换）。
 -->
 <template>
   <k-layout main="page-settings">
     <template #header>
-      {{ ctx.internal.settings[path][0]?.title }}
+      {{ toValue(ctx.internal.settings[path][0]?.title) }}
     </template>
 
     <template #left>
@@ -38,7 +38,7 @@
 
 <script lang="ts" setup>
 import { useConfig, useContext } from "@koishi-ce/client";
-import { computed } from "vue";
+import { computed, toValue } from "vue";
 import { useRoute, useRouter } from "vue-router";
 
 const route = useRoute();
@@ -59,7 +59,7 @@ const data = computed(() =>
 	Object.entries(ctx.internal.settings).map<Tree>(
 		([id, [{ title }]]) => ({
 			id,
-			label: title,
+			label: toValue(title),
 		}),
 	),
 );

package/app/status/loading.vue

@@ -9,7 +9,7 @@
 <template>
   <k-status v-if="progress < 1">
     <el-progress :indeterminate="!store.entry" :percentage="progress * 100">
-      正在加载页面组件
+      {{ t('loading.page') }}
     </el-progress>
   </k-status>
 </template>
@@ -17,8 +17,10 @@
 <script lang="ts" setup>
 import { store, useContext } from "@koishi-ce/client";
 import { computed } from "vue";
+import { useI18n } from "vue-i18n";
 
 const ctx = useContext();
+const { t } = useI18n();
 
 const progress = computed(() => {
 	const states = Object.values(ctx.$loader.extensions);

package/app/theme/blank.vue

@@ -6,10 +6,16 @@
 <template>
   <div class="blank">
     <h1>404</h1>
-    <p>如果你看到了这个页面，说明控制台插件已经加载成功，但你尚未安装任何控制台扩展。</p>
+    <p>{{ t('blank.hint') }}</p>
   </div>
 </template>
 
+<script lang="ts" setup>
+import { useI18n } from "vue-i18n";
+
+const { t } = useI18n();
+</script>
+
 <style lang="scss" scoped>
 
 .blank {

package/app/theme/index.ts

@@ -39,7 +39,8 @@ export default function (ctx: Context) {
 			//   label: '活动栏设置',
 			// }, {
 			id: ".reset",
-			label: "重置活动栏",
+			// label 支持 getter（menu-item 渲染层 toValue 解析），随界面语言切换
+			label: () => ctx.$i18n.t("menu.resetActivity"),
 		},
 	]);
 }

package/app/theme/index.vue

@@ -14,7 +14,7 @@
       <component :is="Component"></component>
     </keep-alive>
   </router-view>
-  <div class="loading" v-else v-loading="true" element-loading-text="正在加载数据……"></div>
+  <div class="loading" v-else v-loading="true" :element-loading-text="t('loading.data')"></div>
   <status-bar></status-bar>
   <menu-list></menu-list>
 </template>
@@ -22,11 +22,13 @@
 <script lang="ts" setup>
 import { store } from "@koishi-ce/client";
 import { computed } from "vue";
+import { useI18n } from "vue-i18n";
 import { useRoute } from "vue-router";
 import ActivityBar from "./activity/index.vue";
 import MenuList from "./menu/index.vue";
 import StatusBar from "./status.vue";
 
+const { t } = useI18n();
 const route = useRoute();
 
 // 页面就绪判定：未声明所需字段的页面恒为已就绪；

package/client/components/chat/overlay.vue

@@ -18,19 +18,19 @@
         <k-icon name="chevron-right"/>
       </span>
       <span class="button bottom" @click.stop>
-        <el-tooltip placement="top" content="缩小" :offset="20">
+        <el-tooltip placement="top" :content="t('overlay.zoomOut')" :offset="20">
           <k-icon name="search-minus" @click="scale -= 0.2"/>
         </el-tooltip>
-        <el-tooltip placement="top" content="放大" :offset="20">
+        <el-tooltip placement="top" :content="t('overlay.zoomIn')" :offset="20">
           <k-icon name="search-plus" @click="scale += 0.2"/>
         </el-tooltip>
-        <el-tooltip placement="top" content="复原" :offset="20">
+        <el-tooltip placement="top" :content="t('overlay.reset')" :offset="20">
           <k-icon name="expand" @click="scale = 1, rotate = 0"/>
         </el-tooltip>
-        <el-tooltip placement="top" content="逆时针旋转" :offset="20">
+        <el-tooltip placement="top" :content="t('overlay.rotateLeft')" :offset="20">
           <k-icon name="undo" @click="rotate -= 90"/>
         </el-tooltip>
-        <el-tooltip placement="top" content="逆时针旋转" :offset="20">
+        <el-tooltip placement="top" :content="t('overlay.rotateRight')" :offset="20">
           <k-icon name="redo" @click="rotate += 90"/>
         </el-tooltip>
       </span>
@@ -49,8 +49,11 @@ import {
 	ref,
 	watch,
 } from "vue";
+import { useI18n } from "vue-i18n";
 import { shared } from "./utils";
 
+const { t } = useI18n();
+
 // 用户手动调整的缩放与旋转量（复原即回到 1 / 0）
 const scale = ref(1);
 const rotate = ref(0);

package/client/locales/de-DE.yml

@@ -0,0 +1,47 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+# Copyright (c) 2026-present Koishi-CE contributors.
+
+pages:
+  home: Willkommen
+  settings: Benutzereinstellungen
+home:
+  connecting: Verbindung zum Koishi-Server wird hergestellt...
+welcome:
+  title: Willkommen bei Koishi!
+  description: Ihr Chatbot ist einsatzbereit. Wählen Sie eine der Optionen unten, um Ihre Koishi-Reise zu beginnen.
+  docs:
+    title: Dokumentation
+    description: Lesen Sie die offizielle Dokumentation. Sie enthält alles, was Sie wissen möchten.
+  forum:
+    title: Forum
+    description: Tauschen Sie sich im Forum mit anderen Nutzern aus. Wenn Probleme auftreten, finden Sie dort Hilfe.
+settings:
+  general: Allgemeine Einstellungen
+  appearance: Erscheinungsbild
+  status: Statusleisten-Einstellungen
+loading:
+  page: Seitenkomponenten werden geladen
+  data: Daten werden geladen...
+blank:
+  hint: Wenn Sie diese Seite sehen, wurde das Konsolen-Plugin erfolgreich geladen, aber es sind noch keine Konsolen-Erweiterungen installiert.
+menu:
+  resetActivity: Aktivitätsleiste zurücksetzen
+overlay:
+  zoomOut: Verkleinern
+  zoomIn: Vergrößern
+  reset: Zurücksetzen
+  rotateLeft: Gegen den Uhrzeigersinn drehen
+  rotateRight: Im Uhrzeigersinn drehen
+schema:
+  settings:
+    $description: Allgemeine Einstellungen
+    locale: Spracheinstellungen.
+  theme:
+    $description: Design-Einstellungen
+    mode: Design-Präferenz.
+    mode-auto: System folgen
+    mode-dark: Dunkel
+    mode-light: Hell
+    dark: Dunkles Design.
+    light: Helles Design.

package/client/locales/en-US.yml

@@ -0,0 +1,47 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+# Copyright (c) 2026-present Koishi-CE contributors.
+
+pages:
+  home: Welcome
+  settings: User Settings
+home:
+  connecting: Connecting to the Koishi server...
+welcome:
+  title: Welcome to Koishi!
+  description: Your chatbot is ready to go. Pick any option below to start your Koishi journey.
+  docs:
+    title: Documentation
+    description: Read the official documentation, which contains everything you want to know.
+  forum:
+    title: Forum
+    description: Talk with other users on the forum. If you run into problems, you can always ask for help there.
+settings:
+  general: General Settings
+  appearance: Appearance
+  status: Status Bar Settings
+loading:
+  page: Loading page components
+  data: Loading data...
+blank:
+  hint: If you are seeing this page, the console plugin has loaded successfully, but no console extensions are installed yet.
+menu:
+  resetActivity: Reset Activity Bar
+overlay:
+  zoomOut: Zoom out
+  zoomIn: Zoom in
+  reset: Reset
+  rotateLeft: Rotate counterclockwise
+  rotateRight: Rotate clockwise
+schema:
+  settings:
+    $description: General Settings
+    locale: Language settings.
+  theme:
+    $description: Theme Settings
+    mode: Theme preference.
+    mode-auto: Follow system
+    mode-dark: Dark
+    mode-light: Light
+    dark: Dark theme.
+    light: Light theme.

package/client/locales/fr-FR.yml

@@ -0,0 +1,47 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+# Copyright (c) 2026-present Koishi-CE contributors.
+
+pages:
+  home: Accueil
+  settings: Paramètres utilisateur
+home:
+  connecting: Connexion au serveur Koishi...
+welcome:
+  title: Bienvenue sur Koishi !
+  description: Votre chatbot est prêt. Choisissez une option ci-dessous pour commencer votre aventure Koishi.
+  docs:
+    title: Documentation
+    description: "Lisez la documentation officielle : elle contient tout ce que vous voulez savoir."
+  forum:
+    title: Forum
+    description: Échangez avec d'autres utilisateurs sur le forum. Si vous rencontrez des problèmes, vous pouvez y demander de l'aide.
+settings:
+  general: Paramètres généraux
+  appearance: Apparence
+  status: Paramètres de la barre d'état
+loading:
+  page: Chargement des composants de la page
+  data: Chargement des données...
+blank:
+  hint: Si vous voyez cette page, le plugin console s'est chargé avec succès, mais aucune extension de console n'est installée.
+menu:
+  resetActivity: Réinitialiser la barre d'activités
+overlay:
+  zoomOut: Réduire
+  zoomIn: Agrandir
+  reset: Réinitialiser
+  rotateLeft: Pivoter dans le sens antihoraire
+  rotateRight: Pivoter dans le sens horaire
+schema:
+  settings:
+    $description: Paramètres généraux
+    locale: Paramètres de langue.
+  theme:
+    $description: Paramètres du thème
+    mode: Préférence de thème.
+    mode-auto: Suivre le système
+    mode-dark: Sombre
+    mode-light: Clair
+    dark: Thème sombre.
+    light: Thème clair.

package/client/locales/ja-JP.yml

@@ -0,0 +1,47 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+# Copyright (c) 2026-present Koishi-CE contributors.
+
+pages:
+  home: ホーム
+  settings: ユーザー設定
+home:
+  connecting: Koishi サーバーに接続しています……
+welcome:
+  title: Koishi へようこそ！
+  description: ボットの準備が整いました。以下の選択肢からどれかを選んで、Koishi の旅を始めましょう。
+  docs:
+    title: ドキュメントを読む
+    description: 公式ドキュメントを読み始めましょう。知りたいことがすべて書かれています。
+  forum:
+    title: フォーラムへ
+    description: フォーラムで他のユーザーと交流しましょう。問題が起きたときは、ここで助けを求めることができます。
+settings:
+  general: 一般設定
+  appearance: 外観設定
+  status: ステータスバー設定
+loading:
+  page: ページコンポーネントを読み込み中
+  data: データを読み込み中……
+blank:
+  hint: このページが表示されている場合、コンソールプラグインの読み込みには成功していますが、コンソール拡張がまだインストールされていません。
+menu:
+  resetActivity: アクティビティバーをリセット
+overlay:
+  zoomOut: 縮小
+  zoomIn: 拡大
+  reset: リセット
+  rotateLeft: 反時計回りに回転
+  rotateRight: 時計回りに回転
+schema:
+  settings:
+    $description: 一般設定
+    locale: 言語設定。
+  theme:
+    $description: テーマ設定
+    mode: テーマの設定。
+    mode-auto: システムに従う
+    mode-dark: ダーク
+    mode-light: ライト
+    dark: ダークテーマ。
+    light: ライトテーマ。

package/client/locales/ru-RU.yml

@@ -0,0 +1,47 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+# Copyright (c) 2026-present Koishi-CE contributors.
+
+pages:
+  home: Главная
+  settings: Настройки пользователя
+home:
+  connecting: Подключение к серверу Koishi...
+welcome:
+  title: Добро пожаловать в Koishi!
+  description: Ваш бот готов к работе. Выберите любой пункт ниже, чтобы начать путешествие по Koishi.
+  docs:
+    title: Документация
+    description: Начните читать официальную документацию — в ней есть всё, что вы хотите узнать.
+  forum:
+    title: Форум
+    description: Общайтесь с другими пользователями на форуме. Если возникнут проблемы, здесь можно обратиться за помощью.
+settings:
+  general: Общие настройки
+  appearance: Оформление
+  status: Настройки строки состояния
+loading:
+  page: Загрузка компонентов страницы
+  data: Загрузка данных...
+blank:
+  hint: Если вы видите эту страницу, плагин консоли загрузился успешно, но расширения консоли ещё не установлены.
+menu:
+  resetActivity: Сбросить панель активности
+overlay:
+  zoomOut: Уменьшить
+  zoomIn: Увеличить
+  reset: Сбросить
+  rotateLeft: Повернуть против часовой стрелки
+  rotateRight: Повернуть по часовой стрелке
+schema:
+  settings:
+    $description: Общие настройки
+    locale: Настройки языка.
+  theme:
+    $description: Настройки темы
+    mode: Предпочтительная тема.
+    mode-auto: Как в системе
+    mode-dark: Тёмная
+    mode-light: Светлая
+    dark: Тёмная тема.
+    light: Светлая тема.

package/client/locales/zh-CN.yml

@@ -0,0 +1,47 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+# Copyright (c) 2026-present Koishi-CE contributors.
+
+pages:
+  home: 欢迎
+  settings: 用户设置
+home:
+  connecting: 正在连接到 Koishi 服务器……
+welcome:
+  title: 欢迎使用 Koishi！
+  description: 你的机器人已经准备就绪。点击下面的任一选项，开启你的 Koishi 之旅吧。
+  docs:
+    title: 阅读文档
+    description: 开始阅读官方文档。官方文档里包含了你想要了解的全部内容。
+  forum:
+    title: 前往论坛
+    description: 前往论坛与其他用户交流。如果你遇到了问题，可以在这里寻求帮助。
+settings:
+  general: 通用设置
+  appearance: 外观设置
+  status: 状态栏设置
+loading:
+  page: 正在加载页面组件
+  data: 正在加载数据……
+blank:
+  hint: 如果你看到了这个页面，说明控制台插件已经加载成功，但你尚未安装任何控制台扩展。
+menu:
+  resetActivity: 重置活动栏
+overlay:
+  zoomOut: 缩小
+  zoomIn: 放大
+  reset: 复原
+  rotateLeft: 逆时针旋转
+  rotateRight: 顺时针旋转
+schema:
+  settings:
+    $description: 通用设置
+    locale: 语言设置。
+  theme:
+    $description: 主题设置
+    mode: 主题偏好。
+    mode-auto: 跟随系统
+    mode-dark: 深色
+    mode-light: 浅色
+    dark: 深色主题。
+    light: 浅色主题。

package/client/locales/zh-TW.yml

@@ -0,0 +1,47 @@
+# SPDX-License-Identifier: AGPL-3.0-only
+# Copyright (c) 2019-present Shigma and Koishijs contributors.
+# Copyright (c) 2026-present Koishi-CE contributors.
+
+pages:
+  home: 歡迎
+  settings: 使用者設定
+home:
+  connecting: 正在連線到 Koishi 伺服器……
+welcome:
+  title: 歡迎使用 Koishi！
+  description: 你的機器人已經準備就緒。點擊下面的任一選項，開啟你的 Koishi 之旅吧。
+  docs:
+    title: 閱讀文件
+    description: 開始閱讀官方文件。官方文件裡包含了你想要了解的全部內容。
+  forum:
+    title: 前往論壇
+    description: 前往論壇與其他使用者交流。如果你遇到了問題，可以在這裡尋求幫助。
+settings:
+  general: 一般設定
+  appearance: 外觀設定
+  status: 狀態列設定
+loading:
+  page: 正在載入頁面元件
+  data: 正在載入資料……
+blank:
+  hint: 如果你看到了這個頁面，說明控制檯插件已經載入成功，但你尚未安裝任何控制檯擴充功能。
+menu:
+  resetActivity: 重置活動欄
+overlay:
+  zoomOut: 縮小
+  zoomIn: 放大
+  reset: 復原
+  rotateLeft: 逆時針旋轉
+  rotateRight: 順時針旋轉
+schema:
+  settings:
+    $description: 一般設定
+    locale: 語言設定。
+  theme:
+    $description: 主題設定
+    mode: 主題偏好。
+    mode-auto: 跟隨系統
+    mode-dark: 深色
+    mode-light: 淺色
+    dark: 深色主題。
+    light: 淺色主題。

package/client/plugins/i18n.ts

@@ -2,9 +2,17 @@
 // Copyright (c) 2019-present Shigma and Koishijs contributors.
 // Copyright (c) 2026-present Koishi-CE contributors.
 
+import { type Dict, valueMap } from "cosmokit";
 import { watchEffect } from "vue";
 import { createI18n } from "vue-i18n";
 import type { Context } from "../context";
+import deDE from "../locales/de-DE.yml";
+import enUS from "../locales/en-US.yml";
+import frFR from "../locales/fr-FR.yml";
+import jaJP from "../locales/ja-JP.yml";
+import ruRU from "../locales/ru-RU.yml";
+import zhCN from "../locales/zh-CN.yml";
+import zhTW from "../locales/zh-TW.yml";
 import { Service } from "../utils";
 import { useConfig } from "./setting";
 
@@ -14,22 +22,69 @@ declare module "../context" {
 	}
 }
 
-// 客户端本地配置（未与服务端同步前的原始值）
-const config = useConfig();
+/** 宿主自身的全局词典：随服务启动注入，键结构见 client/locales/zh-CN.yml */
+export const localeMessages: Dict<Dict> = {
+	"de-DE": deDE,
+	"en-US": enUS,
+	"fr-FR": frFR,
+	"ja-JP": jaJP,
+	"ru-RU": ruRU,
+	"zh-CN": zhCN,
+	"zh-TW": zhTW,
+};
+
+/**
+ * 从一组 `{ locale: 词典 }` 映射中按路径摘取各语种的同一子树，
+ * 构造 Schemastery `.i18n()` 的入参形态（`{ locale: 子树 }`）。
+ * 宿主与扩展的 schema 词典均可经此摘取；yaml 为动态数据，
+ * 收窄集中在这一处。
+ */
+export function pickFrom(
+	messages: Dict<unknown>,
+	...path: string[]
+): Dict {
+	return valueMap(messages, (data) => {
+		let node: unknown = data;
+		for (const key of path) {
+			node = (node as Dict<unknown> | undefined)?.[key];
+		}
+		return node;
+	});
+}
+
+/**
+ * 从宿主词典中按路径摘取各语种的同一子树（`pickFrom` 的宿主词典
+ * 专用便捷形式），叶节点上亦可取得 `Dict<string>`（const 选项的
+ * 显示名直接传 description）。
+ */
+export function pickMessages<T = unknown>(
+	...path: string[]
+): Dict<T> {
+	return pickFrom(localeMessages, ...path) as Dict<T>;
+}
 
 /**
  * 国际化服务：持有 vue-i18n 实例（默认回退语言 zh-CN），
  * 并监听本地配置中的 locale 变化实时切换界面语言。
- * 各扩展自身的语言包由 loader 加载时注入该实例。
+ *
+ * 宿主词典在实例创建时整体传入；各扩展自身的语言包由其 client
+ * 入口调用 `ctx.$i18n.extend()` 深合并注入（vue-i18n 已被构建别名
+ * 钉到宿主单实例，扩展与宿主共享同一 composer）。
  */
 export default class I18nService extends Service {
 	public i18n = createI18n({
 		legacy: false,
 		fallbackLocale: "zh-CN",
+		messages: localeMessages,
 	});
 
 	constructor(ctx: Context) {
 		super(ctx, "$i18n", true);
+		instance = this;
+
+		// 客户端本地配置（在构造期获取而非模块顶层，避免与
+		// setting.ts 的循环依赖在模块求值顺序上踩 TDZ）
+		const config = useConfig();
 
 		// flush: "post" 确保在语言切换引起重渲染前完成 locale 写入
 		ctx.effect(() =>
@@ -44,4 +99,64 @@ export default class I18nService extends Service {
 			),
 		);
 	}
+
+	/**
+	 * 注入扩展语言包：按 locale 深合并进全局词典。
+	 * 扩展应把自身的键收纳在独立命名空间（如 `explorer.*`）下，
+	 * 避免与其他扩展或宿主词典冲突。
+	 */
+	extend(locale: string, messages: Dict) {
+		this.i18n.global.mergeLocaleMessage(locale, messages);
+	}
+
+	/**
+	 * 全局翻译函数（非组件上下文使用，如 activity 名的 getter 与
+	 * echarts 等纯 ts 模块）。可携带位置插值参数。
+	 */
+	t(key: string, args?: unknown[]) {
+		return this.i18n.global.t(key, args ?? []);
+	}
+}
+
+// 服务实例的模块级引用：仅用于开发期 HMR 回调中定位热替换目标
+let instance: I18nService | undefined;
+
+// 开发模式下宿主词典 yml 改动即时热替换（accept 的路径须为静态字面量）；
+// 用 merge 而非 set，以免覆盖扩展此前经 extend() 注入的同语种词条
+if (import.meta.hot) {
+	const replace = (locale: string) => (module: unknown) => {
+		// 热替换模块的 default 导出即该语种的完整词典
+		const messages = (
+			module as { default?: Dict } | undefined
+		)?.default;
+		instance?.extend(locale, messages ?? {});
+	};
+	import.meta.hot.accept(
+		"../locales/de-DE.yml",
+		replace("de-DE"),
+	);
+	import.meta.hot.accept(
+		"../locales/en-US.yml",
+		replace("en-US"),
+	);
+	import.meta.hot.accept(
+		"../locales/fr-FR.yml",
+		replace("fr-FR"),
+	);
+	import.meta.hot.accept(
+		"../locales/ja-JP.yml",
+		replace("ja-JP"),
+	);
+	import.meta.hot.accept(
+		"../locales/ru-RU.yml",
+		replace("ru-RU"),
+	);
+	import.meta.hot.accept(
+		"../locales/zh-CN.yml",
+		replace("zh-CN"),
+	);
+	import.meta.hot.accept(
+		"../locales/zh-TW.yml",
+		replace("zh-TW"),
+	);
 }

package/client/plugins/setting.ts

@@ -17,6 +17,7 @@ import { type Dict, remove } from "cosmokit";
 import {
 	type Component,
 	computed,
+	type MaybeRefOrGetter,
 	markRaw,
 	reactive,
 	ref,
@@ -29,6 +30,7 @@ import {
 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 {
@@ -46,8 +48,8 @@ declare module "../context" {
 interface SettingOptions extends Ordered {
 	/** 所属设置分区 id（空串为通用设置） */
 	id: string;
-	/** 分区标题 */
-	title?: string;
+	/** 分区标题（支持 getter，随界面语言实时切换） */
+	title?: MaybeRefOrGetter<string>;
 	disabled?: () => boolean;
 	/** 该分区的配置 schema（渲染为表单） */
 	schema?: Schema;
@@ -157,14 +159,23 @@ export default class SettingService extends Service {
 
 		this.settings({
 			id: "",
-			title: "通用设置",
+			title: () => this.ctx.$i18n.t("settings.general"),
 			order: 1000,
 			schema: Schema.object({
+				// 语言列表覆盖宿主词典支持的全部语种；
+				// 显示名采用各语言的本地名称（CLDR 惯例），无需翻译
 				locale: Schema.union([
-					"zh-CN",
-					"en-US",
+					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("通用设置"),
+			})
+				.description("通用设置")
+				.i18n(pickMessages("schema", "settings")),
 		});
 
 		// 汇总所有分区 schema 为一个相交对象，作为 resolved 的解释器

package/client/plugins/theme.ts

@@ -21,6 +21,7 @@ import {
 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" {
@@ -79,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("主题偏好。"),
@@ -99,7 +124,7 @@ export default class ThemeService extends Service {
 						.default("default-light")
 						.description("浅色主题。"),
 				}).description("主题设置"),
-			}),
+			}).i18n(pickMessages("schema", "theme")),
 		});
 
 		ctx.effect(() =>

package/lib/bin.mjs

@@ -16,7 +16,7 @@ import { resolve } from "node:path";
 const { version } = {
 	name: "@koishi-ce/client",
 	description: "Koishi Console Client",
-	version: "1.0.4",
+	version: "1.1.0",
 	type: "module",
 	main: "client/index.ts",
 	exports: {

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/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@koishi-ce/client",
     "description": "Koishi Console Client",
-    "version": "1.0.4",
+    "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.6",
-        "@koishi-ce/plugin-console": "^1.0.4"
+        "@koishi-ce/koishi": "^1.0.8",
+        "@koishi-ce/plugin-console": "^1.1.0"
     }
 }

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.

package/app/home/welcome.zh-CN.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: 欢迎使用 Koishi！
-description: 你的机器人已经准备就绪。点击下面的任一选项，开启你的 Koishi 之旅吧。
-action:
-  docs:
-    title: 阅读文档
-    description: 开始阅读官方文档。官方文档里包含了你想要了解的全部内容。
-  forum:
-    title: 前往论坛
-    description: 前往论坛与其他用户交流。如果你遇到了问题，可以在这里寻求帮助。