create-koishi-ce 1.9.1 → 1.9.2

package/lib/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env bun
-import { t as start } from "./src-B2UEAnHe.mjs";
+import { t as start } from "./src-BuWh9uz0.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-B2UEAnHe.mjs";
+import { a as renderManifest, i as readNpmrcRegistry, n as detectAgent, r as getLocalRegistry, t as start } from "./src-BuWh9uz0.mjs";
 export { detectAgent, getLocalRegistry, readNpmrcRegistry, renderManifest, start };

package/lib/{src-B2UEAnHe.mjs → src-BuWh9uz0.mjs}

@@ -9,7 +9,7 @@ import { tmpdir } from "node:os";
 var package_default = {
 	name: "create-koishi-ce",
 	description: "Setup a Koishi application",
-	version: "1.9.1",
+	version: "1.9.2",
 	type: "module",
 	main: "./lib/index.mjs",
 	module: "./lib/index.mjs",
@@ -212,6 +212,7 @@ const templateFiles = Object.fromEntries(readdirSync(templateDir).filter((file)
 *   作用域）；
 * - plugin-welcome / plugin-theme-vanilla 不在列（CE 原创，上游无此名）；
 * - plugin-assets 的 CE 对应物是 @koishi-ce/assets（无 plugin 前缀）。
+* 裸名社区包另见 RENAMED_COMMUNITY_OVERRIDES（按需收录，非机械生成）。
 * 新增 CE 再分发包时须同步本表与 sandbox 生成器的同款清单
 * （tooling/sandbox/manifest.ts，对账测试防漂移）。
 */
@@ -260,9 +261,32 @@ for (const name of [
 	"server-temp",
 	"status"
 ]) UPSTREAM_OVERRIDES[`@koishijs/plugin-${name}`] = `@koishi-ce/plugin-${name}`;
+/**
+* 裸名社区包 → CE 改名再分发的 overrides 兜底映射（包装方式同上）。
+*
+* 与 UPSTREAM_OVERRIDES 的区别：上游是裸名社区包（不在 @koishijs 作用域
+* 内），CE 以改名包 `@koishi-ce/plugin-<名>` 再分发，落盘版本永远满足不了
+* 第三方插件的 `koishi-plugin-<名>` 声明——没有归属时包管理器会自动装下
+* 官方实现，同一份服务就有了第二个实现（CE 宿主里凭空多出官方包）。
+*
+* 收录条件是「有第三方插件把该裸名写进 peer / dependencies」，故本表按需
+* 增补而非按 CE 再分发清单机械生成：puppeteer 的直接证据是
+* koishi-plugin-market-tracker 的 peerDependencies（CE 对应物
+* @koishi-ce/plugin-puppeteer 提供同名 puppeteer 服务）；无此证据的裸名
+* 社区包（如 koishi-plugin-cron）不入列，不无谓拦下官方生态的真实依赖。
+*
+* 代价须知（2026-10-07 实测）：overrides 是包管理器级强制重写，Bun 遇到
+* 与用户显式直连依赖冲突时既不报错也不提示（npm 会抛 EOVERRIDE），会把
+* `koishi-plugin-puppeteer` 静默替换为 CE 包——即本模板项目里装不上官方
+* 同名实现。这是 CE 生态的取舍得当与否，改本表前须一并权衡。
+*/
+const RENAMED_COMMUNITY_OVERRIDES = { "koishi-plugin-puppeteer": "@koishi-ce/plugin-puppeteer" };
 /** 生成模板 overrides 块：键为上游名，值统一 npm:<CE 包>@^1.0.0。 */
 function buildUpstreamOverrides() {
-	return Object.fromEntries(Object.entries(UPSTREAM_OVERRIDES).map(([name, target]) => [name, `npm:${target}@^1.0.0`]));
+	return Object.fromEntries(Object.entries({
+		...UPSTREAM_OVERRIDES,
+		...RENAMED_COMMUNITY_OVERRIDES
+	}).map(([name, target]) => [name, `npm:${target}@^1.0.0`]));
 }
 /**
 * 内置模板的 package.json 基础内容（name/version 会被 renderManifest 覆写，

package/package.json

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

package/src/__tests__/template.test.ts

@@ -267,9 +267,9 @@ test("renderManifest 渲染内置模板：常规改写生效，prod 模式保留
 	);
 });
 
-test("内置模板 overrides 兜底层：41 个上游名强制重定向 CE 包", () => {
+test("内置模板 overrides 兜底层：42 个上游名/裸名强制重定向 CE 包", () => {
 	const table = baseManifest().overrides ?? {};
-	expect(Object.keys(table)).toHaveLength(41);
+	expect(Object.keys(table)).toHaveLength(42);
 	const keys = Object.keys(table);
 	// 核心九名（钉名六行之外由 overrides 补齐覆盖面）
 	expect(table["koishi"]).toBe(
@@ -299,7 +299,9 @@ test("内置模板 overrides 兜底层：41 个上游名强制重定向 CE 包",
 	expect(table["@koishijs/registry"]).toBe(
 		"npm:@koishi-ce/registry@^1.0.0",
 	);
-	// CE 原创与上游裸名社区对应物不进清单（不拦官方生态的真实依赖）
+	// CE 原创与无第三方声明证据的裸名社区对应物不进清单（不拦官方生态的
+	// 真实依赖）：welcome / theme-vanilla 是 CE 原创；cron 上游虽是裸名社区
+	// 包 koishi-plugin-cron，但未收进按需增补的裸名社区表
 	expect(keys.includes("@koishijs/plugin-welcome")).toBe(
 		false,
 	);
@@ -309,14 +311,25 @@ test("内置模板 overrides 兜底层：41 个上游名强制重定向 CE 包",
 	expect(keys.includes("@koishijs/plugin-cron")).toBe(
 		false,
 	);
+	expect(keys.includes("koishi-plugin-cron")).toBe(false);
+	// 裸名社区包按需收录：CE 以 @koishi-ce/plugin-<名> 改名再分发，第三方插件
+	// 的 peer 声明（market-tracker 声明了 koishi-plugin-puppeteer）无归属时
+	// 包管理器会自动装下官方实现，故须顶替
+	expect(table["koishi-plugin-puppeteer"]).toBe(
+		"npm:@koishi-ce/plugin-puppeteer@^1.0.0",
+	);
 	// plugin-assets 的 CE 对应物无 plugin 前缀
 	expect(table["@koishijs/plugin-assets"]).toBe(
 		"npm:@koishi-ce/assets@^1.0.0",
 	);
-	// 全部值为 npm:@koishi-ce/ 前缀，键全为 @koishijs/ 上游名或 koishi 裸名
+	// 全部值为 npm:@koishi-ce/ 前缀，键为 koishi 裸名、@koishijs/ 上游名，
+	// 或按需收录的裸名社区包（当前仅 koishi-plugin-puppeteer）
+	const renamedCommunityKeys = ["koishi-plugin-puppeteer"];
 	for (const key of keys) {
 		expect(
-			key === "koishi" || key.startsWith("@koishijs/"),
+			key === "koishi" ||
+				key.startsWith("@koishijs/") ||
+				renamedCommunityKeys.includes(key),
 		).toBe(true);
 		expect(table[key]).toMatch(/^npm:@koishi-ce\//);
 	}

package/src/template.ts

@@ -101,6 +101,7 @@ export const templateFiles: Record<string, string> =
  *   作用域）；
  * - plugin-welcome / plugin-theme-vanilla 不在列（CE 原创，上游无此名）；
  * - plugin-assets 的 CE 对应物是 @koishi-ce/assets（无 plugin 前缀）。
+ * 裸名社区包另见 RENAMED_COMMUNITY_OVERRIDES（按需收录，非机械生成）。
  * 新增 CE 再分发包时须同步本表与 sandbox 生成器的同款清单
  * （tooling/sandbox/manifest.ts，对账测试防漂移）。
  */
@@ -155,15 +156,44 @@ for (const name of [
 		`@koishi-ce/plugin-${name}`;
 }
 
+/**
+ * 裸名社区包 → CE 改名再分发的 overrides 兜底映射（包装方式同上）。
+ *
+ * 与 UPSTREAM_OVERRIDES 的区别：上游是裸名社区包（不在 @koishijs 作用域
+ * 内），CE 以改名包 `@koishi-ce/plugin-<名>` 再分发，落盘版本永远满足不了
+ * 第三方插件的 `koishi-plugin-<名>` 声明——没有归属时包管理器会自动装下
+ * 官方实现，同一份服务就有了第二个实现（CE 宿主里凭空多出官方包）。
+ *
+ * 收录条件是「有第三方插件把该裸名写进 peer / dependencies」，故本表按需
+ * 增补而非按 CE 再分发清单机械生成：puppeteer 的直接证据是
+ * koishi-plugin-market-tracker 的 peerDependencies（CE 对应物
+ * @koishi-ce/plugin-puppeteer 提供同名 puppeteer 服务）；无此证据的裸名
+ * 社区包（如 koishi-plugin-cron）不入列，不无谓拦下官方生态的真实依赖。
+ *
+ * 代价须知（2026-10-07 实测）：overrides 是包管理器级强制重写，Bun 遇到
+ * 与用户显式直连依赖冲突时既不报错也不提示（npm 会抛 EOVERRIDE），会把
+ * `koishi-plugin-puppeteer` 静默替换为 CE 包——即本模板项目里装不上官方
+ * 同名实现。这是 CE 生态的取舍得当与否，改本表前须一并权衡。
+ */
+const RENAMED_COMMUNITY_OVERRIDES: Record<string, string> =
+	{
+		"koishi-plugin-puppeteer":
+			"@koishi-ce/plugin-puppeteer",
+	};
+
 /** 生成模板 overrides 块：键为上游名，值统一 npm:<CE 包>@^1.0.0。 */
 export function buildUpstreamOverrides(): Record<
 	string,
 	string
 > {
 	return Object.fromEntries(
-		Object.entries(UPSTREAM_OVERRIDES).map(
-			([name, target]) => [name, `npm:${target}@^1.0.0`],
-		),
+		Object.entries({
+			...UPSTREAM_OVERRIDES,
+			...RENAMED_COMMUNITY_OVERRIDES,
+		}).map(([name, target]) => [
+			name,
+			`npm:${target}@^1.0.0`,
+		]),
 	);
 }
 
@@ -269,7 +299,8 @@ export function baseManifest(): Manifest {
 			"@koishijs/components":
 				"npm:@koishi-ce/components-shim@^1.5.22",
 		},
-		// overrides 兜底层（语义见 UPSTREAM_OVERRIDES 注释）：不看版本
+		// overrides 兜底层（语义见 UPSTREAM_OVERRIDES 与
+		// RENAMED_COMMUNITY_OVERRIDES 注释）：不看版本
 		// 满足性强制重写整棵依赖树，拦住钉名覆盖面之外的上游声明
 		overrides: buildUpstreamOverrides(),
 		devDependencies: {