@koishi-ce/client 1.1.1 → 1.2.0

package/app/home/home.vue

@@ -3,17 +3,14 @@
 <!-- Copyright (c) 2026-present Koishi-CE contributors. -->
 
 <!--
-  控制台首页：WebSocket 就绪后渲染 "home" 插槽内容（默认为欢迎卡片），
+  控制台首页：WebSocket 就绪后渲染 "home" 插槽内容（默认为空——欢迎卡
+  由 @koishi-ce/plugin-welcome 提供，统计面板由 plugin-analytics 提供），
   未连接时显示连接提示卡片。
 -->
 <template>
   <k-layout :main="`darker page-home${socket ? '' : ' loading'}`">
     <el-scrollbar v-if="socket">
-      <k-slot name="home">
-        <k-slot-item :order="1000">
-          <welcome></welcome>
-        </k-slot-item>
-      </k-slot>
+      <k-slot name="home"></k-slot>
     </el-scrollbar>
     <div v-else>
       <k-card class="connect">{{ t('home.connecting') }}</k-card>
@@ -24,7 +21,6 @@
 <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>
@@ -39,10 +35,6 @@ const { t } = useI18n();
     justify-content: center;
   }
 
-  .k-card.welcome {
-    margin: var(--card-margin);
-  }
-
   .k-card.connect {
     width: 400px;
     max-width: 400px;

package/app/home/index.ts

@@ -3,7 +3,8 @@
 // Copyright (c) 2026-present Koishi-CE contributors.
 
 /**
- * 首页插件：将 welcome 欢迎页注册为根路由 "/"。
+ * 首页插件：将首页注册为根路由 "/"，内容为 home 插槽
+ * （欢迎卡由 @koishi-ce/plugin-welcome 提供）。
  * order 取极大值（活动栏 top 组渲染时按 order 逆序输出，故首页位于最顶部）。
  */
 

package/client/locales/de-DE.yml

@@ -7,15 +7,6 @@ pages:
   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

package/client/locales/en-US.yml

@@ -7,15 +7,6 @@ pages:
   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

package/client/locales/fr-FR.yml

@@ -7,15 +7,6 @@ pages:
   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

package/client/locales/ja-JP.yml

@@ -7,15 +7,6 @@ pages:
   settings: ユーザー設定
 home:
   connecting: Koishi サーバーに接続しています……
-welcome:
-  title: Koishi へようこそ！
-  description: ボットの準備が整いました。以下の選択肢からどれかを選んで、Koishi の旅を始めましょう。
-  docs:
-    title: ドキュメントを読む
-    description: 公式ドキュメントを読み始めましょう。知りたいことがすべて書かれています。
-  forum:
-    title: フォーラムへ
-    description: フォーラムで他のユーザーと交流しましょう。問題が起きたときは、ここで助けを求めることができます。
 settings:
   general: 一般設定
   appearance: 外観設定

package/client/locales/ru-RU.yml

@@ -7,15 +7,6 @@ pages:
   settings: Настройки пользователя
 home:
   connecting: Подключение к серверу Koishi...
-welcome:
-  title: Добро пожаловать в Koishi!
-  description: Ваш бот готов к работе. Выберите любой пункт ниже, чтобы начать путешествие по Koishi.
-  docs:
-    title: Документация
-    description: Начните читать официальную документацию — в ней есть всё, что вы хотите узнать.
-  forum:
-    title: Форум
-    description: Общайтесь с другими пользователями на форуме. Если возникнут проблемы, здесь можно обратиться за помощью.
 settings:
   general: Общие настройки
   appearance: Оформление

package/client/locales/zh-CN.yml

@@ -7,15 +7,6 @@ pages:
   settings: 用户设置
 home:
   connecting: 正在连接到 Koishi 服务器……
-welcome:
-  title: 欢迎使用 Koishi！
-  description: 你的机器人已经准备就绪。点击下面的任一选项，开启你的 Koishi 之旅吧。
-  docs:
-    title: 阅读文档
-    description: 开始阅读官方文档。官方文档里包含了你想要了解的全部内容。
-  forum:
-    title: 前往论坛
-    description: 前往论坛与其他用户交流。如果你遇到了问题，可以在这里寻求帮助。
 settings:
   general: 通用设置
   appearance: 外观设置

package/client/locales/zh-TW.yml

@@ -7,15 +7,6 @@ pages:
   settings: 使用者設定
 home:
   connecting: 正在連線到 Koishi 伺服器……
-welcome:
-  title: 歡迎使用 Koishi！
-  description: 你的機器人已經準備就緒。點擊下面的任一選項，開啟你的 Koishi 之旅吧。
-  docs:
-    title: 閱讀文件
-    description: 開始閱讀官方文件。官方文件裡包含了你想要了解的全部內容。
-  forum:
-    title: 前往論壇
-    description: 前往論壇與其他使用者交流。如果你遇到了問題，可以在這裡尋求幫助。
 settings:
   general: 一般設定
   appearance: 外觀設定

package/lib/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as build } from "./src-HOy7ib_t.mjs";
+import { t as build } from "./src-C9CZhQz5.mjs";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 //#endregion
@@ -16,7 +16,7 @@ import { resolve } from "node:path";
 const { version } = {
 	name: "@koishi-ce/client",
 	description: "Koishi Console Client",
-	version: "1.1.1",
+	version: "1.2.0",
 	type: "module",
 	main: "client/index.ts",
 	exports: {
@@ -65,6 +65,7 @@ const { version } = {
 		"element-plus": "^2.14.5",
 		"marked-vue": "^1.3.0",
 		"sass-embedded": "^1.102.0",
+		"typescript": "^5.0.0",
 		"unocss": "^66.8.1",
 		"vite": "^8.2.2",
 		"vue": "^3.5.42",

package/lib/index.mjs

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

package/lib/{src-HOy7ib_t.mjs → src-C9CZhQz5.mjs}

@@ -34,7 +34,19 @@ async function collectWorkspaceAliases() {
 	return aliases;
 }
 const workspaceAliases = await collectWorkspaceAliases();
-const runtimeShimPath = (workspaceAliases["@koishi-ce/components"] ?? "").replace(/client\/index\.ts$/, "client/schemastery-vue-runtime.ts");
+function locateRuntimeShim() {
+	const fromAlias = (workspaceAliases["@koishi-ce/components"] ?? "").replace(/client\/index\.ts$/, "client/schemastery-vue-runtime.ts");
+	if (fromAlias) return fromAlias;
+	let dir = resolve(import.meta.dir, "..");
+	while (true) {
+		const candidate = `${dir}/node_modules/@koishi-ce/components/client/schemastery-vue-runtime.ts`;
+		if (existsSync(candidate)) return candidate.replace(/\\/g, "/");
+		const parent = resolve(dir, "..");
+		if (parent === dir) return "";
+		dir = parent;
+	}
+}
+const runtimeShimPath = locateRuntimeShim();
 /**
 * 构建单个 webui 插件的前端产物。
 *
@@ -90,7 +102,7 @@ async function build(root, config = {}) {
 			"vue-i18n": "@koishi-ce/client",
 			"@koishi-ce/components": "@koishi-ce/client",
 			"@koishijs/components": workspaceAliases["@koishi-ce/components"],
-			"schemastery-vue/client": runtimeShimPath
+			...runtimeShimPath ? { "schemastery-vue/client": runtimeShimPath } : {}
 		} },
 		define: { "process.env.NODE_ENV": "\"production\"" }
 	}, config));
@@ -149,18 +161,21 @@ async function createServer(baseDir, config = {}) {
 				"../vue.js": "vue",
 				"../vue-router.js": "vue-router",
 				"../vueuse.js": "@vueuse/core",
-				"schemastery-vue/client": runtimeShimPath
+				...runtimeShimPath ? { "schemastery-vue/client": runtimeShimPath } : {}
 			}
 		},
-		optimizeDeps: { include: [
-			"vue",
-			"vue-router",
-			"element-plus",
-			"@vueuse/core",
-			"@popperjs/core",
-			"marked",
-			"xss"
-		] },
+		optimizeDeps: {
+			include: [
+				"vue",
+				"vue-router",
+				"element-plus",
+				"@vueuse/core",
+				"@popperjs/core",
+				"marked",
+				"xss"
+			],
+			exclude: ["@koishi-ce/client", "@koishi-ce/components"]
+		},
 		build: { rollupOptions: { input: `${root}/index.html` } }
 	}, config));
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@koishi-ce/client",
     "description": "Koishi Console Client",
-    "version": "1.1.1",
+    "version": "1.2.0",
     "type": "module",
     "main": "client/index.ts",
     "exports": {
@@ -48,7 +48,7 @@
         "build"
     ],
     "dependencies": {
-        "@koishi-ce/components": "^1.0.2",
+        "@koishi-ce/components": "^1.0.3",
         "@satorijs/protocol": "^1.7.0",
         "@vitejs/plugin-vue": "^6.0.8",
         "@vueuse/core": "^14.4.0",
@@ -57,6 +57,7 @@
         "element-plus": "^2.14.5",
         "marked-vue": "^1.3.0",
         "sass-embedded": "^1.102.0",
+        "typescript": "^5.0.0",
         "unocss": "^66.8.1",
         "vite": "^8.2.2",
         "vue": "^3.5.42",
@@ -65,6 +66,6 @@
     },
     "devDependencies": {
         "@koishi-ce/koishi": "^1.0.11",
-        "@koishi-ce/plugin-console": "^1.2.0"
+        "@koishi-ce/plugin-console": "^1.3.0"
     }
 }

package/src/index.ts

@@ -82,14 +82,34 @@ async function collectWorkspaceAliases(): Promise<
 const workspaceAliases = await collectWorkspaceAliases();
 
 // 虚拟子路径 "schemastery-vue/client" 的运行时载体（补齐真实包缺失的
-// SchemaBase 具名导出）绝对路径，从 components 包的工作区别名推导；
-// 类型面由根 tsconfig.client.json 的 paths 解析到 schemastery-vue-client.ts
-const runtimeShimPath = (
-	workspaceAliases["@koishi-ce/components"] ?? ""
-).replace(
-	/client\/index\.ts$/,
-	"client/schemastery-vue-runtime.ts",
-);
+// SchemaBase 具名导出）绝对路径；类型面由根 tsconfig.client.json 的
+// paths 解析到 schemastery-vue-client.ts。
+// 优先从 components 包的工作区别名推导；下游（npm 安装）形态下工作区
+// 别名表为空，从本包根向父级逐级 node_modules 纯 fs 探测 components 包
+// （不走解析 API：Bun 会把失败的解析按父目录快照缓存，刚装好的包可能
+// 探不到）。两者都失败时返回空串，别名表须省略该键——空串值的 alias
+// 会让 vite/rolldown 以空 specifier 解析直接报错。
+function locateRuntimeShim(): string {
+	const fromAlias = (
+		workspaceAliases["@koishi-ce/components"] ?? ""
+	).replace(
+		/client\/index\.ts$/,
+		"client/schemastery-vue-runtime.ts",
+	);
+	if (fromAlias) return fromAlias;
+	// 源码形态（src/）与产物形态（lib/）都在包根下一级，先回到包根
+	let dir = resolve(import.meta.dir, "..");
+	while (true) {
+		const candidate = `${dir}/node_modules/@koishi-ce/components/client/schemastery-vue-runtime.ts`;
+		if (existsSync(candidate))
+			return candidate.replace(/\\/g, "/");
+		const parent = resolve(dir, "..");
+		if (parent === dir) return "";
+		dir = parent;
+	}
+}
+
+const runtimeShimPath = locateRuntimeShim();
 
 /**
  * 构建单个 webui 插件的前端产物。
@@ -208,8 +228,13 @@ export async function build(
 							workspaceAliases["@koishi-ce/components"],
 						// 虚拟子路径的运行时载体（补齐真实包缺失的 SchemaBase
 						// 具名导出）；类型面由 tsconfig.client.json 的 paths
-						// 解析到 schemastery-vue-client.ts
-						"schemastery-vue/client": runtimeShimPath,
+						// 解析到 schemastery-vue-client.ts。下游探测失败时
+						// 省略该键（空串值会炸 resolve）
+						...(runtimeShimPath
+							? {
+									"schemastery-vue/client": runtimeShimPath,
+								}
+							: {}),
 					},
 				},
 				define: {
@@ -314,8 +339,13 @@ export async function createServer(
 						"../vue.js": "vue",
 						"../vue-router.js": "vue-router",
 						"../vueuse.js": "@vueuse/core",
-						// 虚拟子路径的运行时载体（同 build 的别名说明）
-						"schemastery-vue/client": runtimeShimPath,
+						// 虚拟子路径的运行时载体（同 build 的别名说明）；
+						// 下游探测失败时省略该键（空串值会炸 resolve）
+						...(runtimeShimPath
+							? {
+									"schemastery-vue/client": runtimeShimPath,
+								}
+							: {}),
 					},
 				},
 				optimizeDeps: {
@@ -328,6 +358,16 @@ export async function createServer(
 						"marked",
 						"xss",
 					],
+					// 宿主与组件库以 TS 源码 + .yml 词典的形态发布，必须走
+					// dev transform 管道逐文件服务（yaml 插件在此生效）；
+					// 一旦落入依赖预打包，rolldown 会把 .yml 当 JS 解析，
+					// 直接报 PARSE_ERROR。工作区内两者经工作区别名映射为
+					// 绝对路径、天然不进 optimizer；下游 npm 安装形态下别名
+					// 表为空、以裸包名参与解析，须在此显式排除
+					exclude: [
+						"@koishi-ce/client",
+						"@koishi-ce/components",
+					],
 				},
 				build: {
 					rollupOptions: {

package/app/home/welcome.vue

@@ -1,98 +0,0 @@
-<!-- SPDX-License-Identifier: AGPL-3.0-only -->
-<!-- Copyright (c) 2019-present Shigma and Koishijs contributors. -->
-<!-- Copyright (c) 2026-present Koishi-CE contributors. -->
-
-<!--
-  欢迎卡片：文档 / 社区论坛等入口链接。
-  文案走宿主全局词典（client/locales/，7 语种），
-  其余扩展可通过 "welcome-choice" 插槽追加自定义入口。
--->
-<template>
-  <div class="k-card welcome">
-    <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('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('welcome.forum.title') }}</h2>
-            <p>{{ t('welcome.forum.description') }}</p>
-          </a>
-        </k-slot-item>
-      </k-slot>
-    </div>
-  </div>
-</template>
-
-<script lang="ts" setup>
-import { useI18n } from "vue-i18n";
-
-// 全局 composer：词典由宿主 $i18n 服务在挂载前注入
-const { t } = useI18n();
-</script>
-
-<style lang="scss">
-
-.page-home .welcome {
-  --welcome-title: 2.5rem;
-  --welcome-padding: 3rem 3rem;
-  --welcome-choice-padding: 0.5rem 1.5rem;
-  --welcome-gap: 2rem;
-
-  padding: var(--welcome-padding);
-
-  h1 {
-    font-size: var(--welcome-title);
-    margin-top: 0;
-  }
-
-  h1 + p {
-    margin: var(--welcome-gap) 0;
-  }
-
-  .choices {
-    display: flex;
-    flex-flow: row wrap;
-    gap: var(--welcome-gap);
-  }
-
-  .choice {
-    flex: 1 0 auto;
-    display: inline-block;
-    width: 280px;
-    box-sizing: border-box;
-    padding: var(--welcome-choice-padding);
-    border: 1px solid var(--k-color-divider);
-    border-radius: 6px;
-    cursor: pointer;
-    transition: var(--color-transition);
-
-    &:hover {
-      background-color: var(--k-side-color);
-    }
-
-    h2 {
-      font-size: 1.25rem;
-      margin-top: 1rem;
-    }
-
-    p {
-      font-size: 0.9375rem;
-    }
-  }
-
-  @media screen and (max-width: 768px) {
-    --welcome-title: 2rem;
-    --welcome-padding: 1.5rem 1.5rem;
-    --welcome-gap: 1.5rem;
-    --welcome-choice-padding: 0.5rem 1.5rem;
-  }
-}
-
-</style>