create-koishi-ce 1.6.1 → 1.6.3

package/lib/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env bun
-import { t as start } from "./src-Dekgnxqt.mjs";
+import { t as start } from "./src-C4V0N-Vc.mjs";
 //#region src/bin.ts
 /**
 * create-koishi-ce 的 CLI 可执行入口：shebang 由 rolldown 原样保留到

package/lib/index.mjs

@@ -1,2 +1,2 @@
-import { a as renderManifest, i as readNpmrcRegistry, n as detectAgent, r as getLocalRegistry, t as start } from "./src-Dekgnxqt.mjs";
+import { a as renderManifest, i as readNpmrcRegistry, n as detectAgent, r as getLocalRegistry, t as start } from "./src-C4V0N-Vc.mjs";
 export { detectAgent, getLocalRegistry, readNpmrcRegistry, renderManifest, start };

package/lib/{src-Dekgnxqt.mjs → src-C4V0N-Vc.mjs}

@@ -9,7 +9,7 @@ import { downloadTemplate } from "giget";
 var package_default = {
 	name: "create-koishi-ce",
 	description: "Setup a Koishi application",
-	version: "1.6.1",
+	version: "1.6.3",
 	type: "module",
 	main: "./lib/index.mjs",
 	module: "./lib/index.mjs",
@@ -235,12 +235,17 @@ function baseManifest() {
 	return {
 		type: "module",
 		packageManager: `bun@${Bun.version}`,
-		workspaces: ["plugins/*", "external/*"],
+		workspaces: [
+			"plugins/*",
+			"external/**",
+			"!external/**/node_modules/**"
+		],
 		scripts: {
 			start: "koishi start",
 			dev: "NODE_ENV=development koishi start",
 			new: "koishi-scripts setup",
 			clone: "koishi-scripts clone",
+			update: "koishi-scripts update",
 			build: "koishi-scripts build",
 			"release:version": "koishi-scripts version",
 			"release:dryrun": "bun run release:version && bun run build && koishi-scripts publish --dry-run",

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "create-koishi-ce",
     "description": "Setup a Koishi application",
-    "version": "1.6.1",
+    "version": "1.6.3",
     "type": "module",
     "main": "./lib/index.mjs",
     "module": "./lib/index.mjs",

package/src/__tests__/run-default.test.ts

@@ -231,9 +231,12 @@ function expectTemplateFiles(dir: string): void {
 	) as Record<string, unknown>;
 	expect(manifest["private"]).toBe(true);
 	expect(manifest["version"]).toBe("0.0.0");
+	// globstar + 负向排除形态：external 任意深度（含克隆的 monorepo
+	// 子包）都是成员，node_modules 残留被排除（与 template.test.ts 同步）
 	expect(manifest["workspaces"]).toEqual([
 		"plugins/*",
-		"external/*",
+		"external/**",
+		"!external/**/node_modules/**",
 	]);
 }
 

package/src/__tests__/template.test.ts

@@ -56,6 +56,8 @@ test("内置模板提供插件开发全链脚本入口（koishi-scripts 子命
 	// new 用主命令名 setup（new/create/init 是 koishi-scripts 的别名）
 	expect(scripts["new"]).toBe("koishi-scripts setup");
 	expect(scripts["clone"]).toBe("koishi-scripts clone");
+	// update 是白名单安全更新（只碰 @koishi-ce/*，替代裸 bun update）
+	expect(scripts["update"]).toBe("koishi-scripts update");
 	expect(scripts["build"]).toBe("koishi-scripts build");
 	expect(scripts["release:version"]).toBe(
 		"koishi-scripts version",
@@ -222,6 +224,14 @@ test("renderManifest 渲染内置模板：常规改写生效，prod 模式保留
 	expect(output.dependencies.koishi).toBe(
 		"npm:@koishi-ce/koishi-shim@^4.18.11",
 	);
+	// workspaces 是 globstar + 负向排除形态：external 任意深度（含克隆的
+	// monorepo 子包）都是成员，node_modules 排除搬迁残留——配置页的
+	// 「添加插件」列表按同一份声明展开收录，写法回退即嵌套不可见
+	expect(output.workspaces).toEqual([
+		"plugins/*",
+		"external/**",
+		"!external/**/node_modules/**",
+	]);
 
 	const prod = JSON.parse(
 		renderManifest(baseManifest(), "my-app", true),

package/src/template/README.md

@@ -28,6 +28,14 @@ bun run dev          # 启动（开发模式，启用 HMR 热更新）
 
 根依赖中的四行 npm alias——`"koishi": "npm:@koishi-ce/koishi-shim@^4.18.11"`、`"@koishijs/plugin-console": "npm:@koishi-ce/console-shim@^5.30.11"`、`"@koishijs/core": "npm:@koishi-ce/koishi-shim@4.18.11"`、`"@koishijs/loader": "npm:@koishi-ce/koishi-shim@^4.18.11"`——已把上游生态的 peer 依赖全部钉回 @koishi-ce 框架（前两行与后两行分别只涉及 koishi-shim / console-shim 两个包；**请勿删除或改写这四行**），不会形成第二份框架 / console / loader 副本。
 
+## 更新依赖
+
+```bash
+bun run update        # 安全更新：只更新 @koishi-ce/* 生态位依赖
+```
+
+**请勿裸跑 `bun update`**：那是全树更新语义，会连带给市场安装的第三方插件与全部传递依赖重新求解，任一上游漂移都可能破坏运行时。`bun run update` 只显式更新 `@koishi-ce/*` 依赖（alias 冻结线不受影响）；第三方插件的版本请经控制台「插件市场」操作。
+
 ## 自定义插件
 
 手动在 `plugins/` 目录下创建插件包，或经脚手架进入 `external/` 工作区：
@@ -35,7 +43,7 @@ bun run dev          # 启动（开发模式，启用 HMR 热更新）
 - `bun run new <名称>` —— 生成插件骨架到 `external/`（`--console` 附带控制台前端扩展）
 - `bun run clone <仓库>` —— 克隆已有插件源码到 `external/` 本地联动调试
 
-两种来源的插件都在 `koishi.yml` 中以相对路径引用（如 `./plugins/my-plugin`、`./external/my-plugin`）即可启用；Bun 直接加载 TypeScript 源码，无需预编译。
+两种来源的插件都在 `koishi.yml` 中以相对路径引用（如 `./plugins/my-plugin`、`./external/my-plugin`）即可启用；Bun 直接加载 TypeScript 源码，无需预编译。克隆来的 **monorepo 形态插件仓库**（插件在 `packages/` 等子目录）无需平铺——`workspaces` 声明的 `external/**` 通配任意深度，控制台「添加插件」列表同样按此声明收录，子包直接可见可启用（搬迁自其它包管理器的仓库若带着旧 `node_modules`，负向声明已将其排除，建议顺手删除节省空间）。
 
 ## 插件构建与发布
 

package/src/template.ts

@@ -92,7 +92,16 @@ export function baseManifest(): Manifest {
 		type: "module",
 		// 本项目只用 Bun：钉住创建时的 Bun 版本（bun run 亦据此选择解释器）
 		packageManager: `bun@${Bun.version}`,
-		workspaces: ["plugins/*", "external/*"],
+		// globstar + 负向排除（Bun workspaces 支持完整 glob 语法）：external
+		// 下任意深度的插件包（含克隆来的 monorepo 形态 packages/ 子包）都是
+		// workspace 成员；node_modules 排除搬迁残留的依赖目录（包管理器
+		// 对其另有管理，混入成员会污染解析）。配置页的「添加插件」列表按
+		// 同一份声明展开收录，声明写多深列表就能看多深
+		workspaces: [
+			"plugins/*",
+			"external/**",
+			"!external/**/node_modules/**",
+		],
 		scripts: {
 			start: "koishi start",
 			// bun run 走 Bun Shell，`NODE_ENV=...` 前缀天然跨平台，无需 cross-env
@@ -101,10 +110,13 @@ export function baseManifest(): Manifest {
 			// 本工作区 plugins/ 与 external/；纯运行 bot 的项目用不到这些入口，
 			// prod 模式删 devDependencies 后它们自然失效）：
 			// new 生成插件骨架到 external/，clone 克隆已有插件仓库本地联动，
+			// update 白名单更新本项目的 @koishi-ce/* 依赖（裸 bun update 是
+			// 全树更新语义，会拉动第三方插件与全部传递依赖，勿用），
 			// build / release* 构建并发布 external/ 下的插件（version → build
 			// → publish 三环，dry-run 为演练形态）
 			new: "koishi-scripts setup",
 			clone: "koishi-scripts clone",
+			update: "koishi-scripts update",
 			build: "koishi-scripts build",
 			"release:version": "koishi-scripts version",
 			"release:dryrun":