create-koishi-ce 1.8.0 → 1.9.1

package/README.md

@@ -29,7 +29,7 @@ npm create koishi-ce my-app
 
 - **package.json**：`type: module`、`packageManager` 钉 Bun、workspaces 含 `plugins/*` 与 `external/*`；dependencies 预装全套 `@koishi-ce` 常用插件（console、config、market、auth、admin、help、sandbox、database-sqlite 等），并预置六行 npm alias 钉住上游名——`koishi` / `@koishijs/core` / `@koishijs/loader` 指向 `@koishi-ce/koishi-shim`、`@koishijs/plugin-console` 指向 `@koishi-ce/console-shim`、`@koishijs/client` / `@koishijs/components` 分别指向 `@koishi-ce/client-shim` / `@koishi-ce/components-shim`，社区插件（含把上游前端库写进 dependencies 的 webui 插件）由此全部解析到 CE 对应包；
 - **koishi.yml**：按 server（端口 5140-5149）/ basic / console（自动打开、市场指向 registry.koishi.chat 镜像）/ storage / adapter / develop（开发模式启用热重载）分组预写；官方 adapter 插件以 `~` 停用条目预写、不预装，装好后在控制台按需启用；数据库开箱即用——`database-sqlite` 默认启用，mongo / mysql / postgres 等其余 database 不预写占位条目，市场安装后自动出现；
-- **开发工具链**：devDependencies 预置 `@koishi-ce/client`、`@koishi-ce/plugin-hmr` 与 `@koishi-ce/scripts`（`koishi-scripts setup` 可在 external/ 下继续创建插件项目）。
+- **开发工具链**：devDependencies 预置 `@koishi-ce/client`、`@koishi-ce/console-app`（宿主 SPA 源码，devMode 的 vite root）、`@koishi-ce/console-builder`（控制台 devMode 的 Vite 开发服务器）、`@koishi-ce/plugin-hmr` 与 `@koishi-ce/scripts`（`koishi-scripts setup` 可在 external/ 下继续创建插件项目）。
 
 不预装任何 adapter——官方 adapter 可后续从市场安装，peer 已被 alias 钉住不会形成双实例；数据库已由默认启用的 `database-sqlite` 覆盖，其他官方 database 同样可从市场安装。
 
@@ -68,7 +68,7 @@ Interactive flow: project name; confirm cleaning a non-empty target directory; c
 
 - **package.json** — `type: module`, `packageManager` pinned to Bun, workspaces covering `plugins/*` and `external/*`; dependencies preinstall the common `@koishi-ce` plugin set (console, config, market, auth, admin, help, sandbox, database-sqlite, etc.) plus the four npm-alias lines pinning the upstream names (`koishi` / `@koishijs/core` / `@koishijs/loader` to `@koishi-ce/koishi-shim`, `@koishijs/plugin-console` to `@koishi-ce/console-shim`), so community plugins all resolve to the CE framework.
 - **koishi.yml** — grouped prewrites for server (ports 5140-5149), basic, console (auto-open, market pointed at the registry.koishi.chat mirror), storage, adapter and develop (HMR in development mode); official adapter plugins are prewritten as `~`-disabled entries without being installed — enable them in the console after installing; the database works out of the box (`database-sqlite` enabled by default), while other official databases (mongo / mysql / postgres, ...) leave no placeholder entries and appear automatically once installed from the market.
-- **Toolchain** — devDependencies include `@koishi-ce/client`, `@koishi-ce/plugin-hmr` and `@koishi-ce/scripts` (`koishi-scripts setup` scaffolds further plugin projects under external/).
+- **Toolchain** — devDependencies include `@koishi-ce/client`, `@koishi-ce/console-app` (the host SPA source serving as the devMode vite root), `@koishi-ce/console-builder` (the Vite dev server behind the console devMode), `@koishi-ce/plugin-hmr` and `@koishi-ce/scripts` (`koishi-scripts setup` scaffolds further plugin projects under external/).
 
 No adapter is preinstalled — official adapters can be installed from the market later, with their peers already pinned by the aliases; the database is covered by the default-enabled `database-sqlite`, and other official databases are equally one market install away.
 

package/lib/bin.mjs

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

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

@@ -1,15 +1,15 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { basename, join, relative } from "node:path";
 import { parseArgs } from "node:util";
 import * as p from "@clack/prompts";
 import pc from "picocolors";
 import { getLocalRegistry, readNpmrcRegistry } from "@koishi-ce/utils";
-import { downloadTemplate } from "giget";
+import { tmpdir } from "node:os";
 //#region package.json
 var package_default = {
 	name: "create-koishi-ce",
 	description: "Setup a Koishi application",
-	version: "1.8.0",
+	version: "1.9.1",
 	type: "module",
 	main: "./lib/index.mjs",
 	module: "./lib/index.mjs",
@@ -41,8 +41,7 @@ var package_default = {
 	dependencies: {
 		"@clack/prompts": "^1.7.0",
 		"@koishi-ce/utils": "workspace:*",
-		"picocolors": "^1.1.1",
-		"giget": "^3.3.1"
+		"picocolors": "^1.1.1"
 	},
 	exports: {
 		".": {
@@ -75,7 +74,7 @@ function renderManifest(source, project, prod) {
 //#region src/remote.ts
 /**
 * 远程模板分支（--template <包名>）的下载-解包-改写全流程：拉取 npm
-* registry 包元数据解析目标版本，经 giget 下载 tarball 并解包到目标
+* registry 包元数据解析目标版本，经 Bun.Archive 下载 tarball 并解包到目标
 * 目录，最后改写 package.json。HttpError 与 RegistryMeta 只在本流程
 * 消费，就近定义不另立文件；本机 registry 配置探测见 registry.ts。
 *
@@ -97,9 +96,8 @@ var HttpError = class extends Error {
 /**
 * 远程模板下载与解包：
 * 1. 拉取模板包元数据，按 dist-tags 解析目标版本（ref，默认 latest）；
-* 2. 下载 tarball 并解包到目标目录（解包走 giget，其按 npm tarball 惯例
-*    剥离顶层 package/ 目录，等价于 strip: 1），网络错误统一以 HttpError
-*    提示后退出；
+* 2. 下载 tarball 并解包到目标目录（Bun.Archive 负责 tar/gzip 解包，按 npm
+*    tarball 惯例剥离顶层 package/ 目录），网络错误统一以 HttpError 提示后退出；
 * 3. 最后改写 package.json。
 */
 async function scaffoldRemote({ registry, template, ref, prod, project, rootDir }) {
@@ -111,19 +109,21 @@ async function scaffoldRemote({ registry, template, ref, prod, project, rootDir
 		if (version === void 0) throw new HttpError(404, `模板 ${template}@${ref} 不存在`);
 		const url = remote.versions[version]?.dist?.tarball;
 		if (url === void 0) throw new HttpError(404, `模板 ${template}@${ref} 不存在`);
-		await downloadTemplate(template, {
-			provider: "npm",
-			providers: { npm: async () => ({
-				name: template,
-				version,
-				tar: async () => {
-					const tarballRes = await fetch(url);
-					if (!tarballRes.ok || !tarballRes.body) throw new HttpError(tarballRes.status, tarballRes.statusText);
-					return tarballRes.body;
-				}
-			}) },
-			dir: rootDir
-		});
+		const tarballRes = await fetch(url);
+		if (!tarballRes.ok || !tarballRes.body) throw new HttpError(tarballRes.status, tarballRes.statusText);
+		const archive = new Bun.Archive(await tarballRes.blob());
+		const tempDir = mkdtempSync(join(tmpdir(), "create-koishi-ce-"));
+		try {
+			await archive.extract(tempDir);
+			const packageDir = join(tempDir, "package");
+			if (!existsSync(packageDir)) throw new Error("远程模板归档缺少 package/ 目录");
+			for (const entry of readdirSync(packageDir)) renameSync(join(packageDir, entry), join(rootDir, entry));
+		} finally {
+			rmSync(tempDir, {
+				recursive: true,
+				force: true
+			});
+		}
 	} catch (err) {
 		if (!(err instanceof HttpError)) throw err;
 		console.log(`${pc.red("error")} 请求失败：HTTP ${err.status} ${err.statusText}`);
@@ -332,10 +332,12 @@ function baseManifest() {
 		overrides: buildUpstreamOverrides(),
 		devDependencies: {
 			"@koishi-ce/client": "^1.0.0",
+			"@koishi-ce/console-app": "^1.0.0",
+			"@koishi-ce/console-builder": "^1.0.0",
 			"@koishi-ce/plugin-hmr": "^1.0.0",
 			"@koishi-ce/plugin-mock": "^1.0.0",
 			"@koishi-ce/scripts": "^1.0.0",
-			"bun-types": "^1.4.0"
+			"@types/bun": "^1.4.0"
 		}
 	};
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "create-koishi-ce",
     "description": "Setup a Koishi application",
-    "version": "1.8.0",
+    "version": "1.9.1",
     "type": "module",
     "main": "./lib/index.mjs",
     "module": "./lib/index.mjs",
@@ -44,9 +44,8 @@
     ],
     "dependencies": {
         "@clack/prompts": "^1.7.0",
-        "@koishi-ce/utils": "^1.1.0",
-        "picocolors": "^1.1.1",
-        "giget": "^3.3.1"
+        "@koishi-ce/utils": "^1.1.1",
+        "picocolors": "^1.1.1"
     },
     "exports": {
         ".": {

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

@@ -18,7 +18,7 @@ import {
 	rmSync,
 	writeFileSync,
 } from "node:fs";
-import { homedir, tmpdir } from "node:os";
+import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { tarPack } from "./tar-pack.ts";
 
@@ -29,7 +29,7 @@ import { tarPack } from "./tar-pack.ts";
  * 场景（正常 / 元数据 404 / dist-tag 缺失 / tarball 404 / tarball 损坏）；
  * tarball 由 __tests__/tar-pack.ts 的 tarPack 打包（ustar + gzip，与真实
  * npm tarball 同构），scaffoldRemote 的下载-解包-改写全链路真实执行
- * （解包走 giget，含超长名 pax 条目的端到端验证）。
+ * （解包走 Bun.Archive，含超长名 pax 条目的端到端验证）。
  *
  * 覆盖率口径说明：bun 的覆盖率对同一路径的多个 query 实例只统计最后
  * 求值的那份，本文件是 koishi-create 全部测试中最后加载的实例，因此
@@ -180,7 +180,7 @@ beforeAll(async () => {
 		},
 		{
 			// 124 字符 > ustar 的 100 字节 name 上限：tarPack 前置 pax
-			// 扩展头，giget（tar 库）经 pax 还原后同样能正确落盘
+			// 扩展头，Bun.Archive 经 pax 还原后同样能正确落盘
 			path: `package/${longName}.txt`,
 			data: encoder.encode("pax"),
 		},
@@ -203,19 +203,6 @@ function reset(sc: typeof scenario): void {
 		recursive: true,
 		force: true,
 	});
-	// giget 缓存位置随平台而异（win32 为 tmpdir()/giget，POSIX 跟随
-	// XDG_CACHE_HOME——默认 ~/.cache）；逐用例清理，避免上一场景的缓存
-	// （tarball-404 的缺失或 corrupt 的损坏归档）被 giget 的
-	// 「下载失败回退缓存」吞掉
-	const cacheRoot =
-		process.env["XDG_CACHE_HOME"] ??
-		join(homedir(), ".cache");
-	for (const dir of [
-		join(tmpdir(), "giget"),
-		join(cacheRoot, "giget"),
-	]) {
-		rmSync(dir, { recursive: true, force: true });
-	}
 }
 
 describe("create-koishi-ce 远程模板", () => {
@@ -224,7 +211,7 @@ describe("create-koishi-ce 远程模板", () => {
 		await start();
 		const dir = join(workspaceRoot, "myapp");
 		expect(existsSync(join(dir, "index.js"))).toBe(true);
-		// 超长名文件经 pax 扩展头正常落盘（tarPack 打包 → giget 解包全链路）
+		// 超长名文件经 pax 扩展头正常落盘（tarPack 打包 → Bun.Archive 解包全链路）
 		expect(
 			readFileSync(join(dir, `${longName}.txt`), "utf8"),
 		).toBe("pax");

package/src/__tests__/tar-pack.ts

@@ -4,10 +4,10 @@
 /**
  * 测试专用 .tgz fixture 构造器（ustar + 超长名 pax 兜底 + gzip）。
  *
- * 生产代码的远程模板解包已改走 giget（见 src/index.ts scaffoldRemote），
+ * 生产代码的远程模板解包已改走 Bun.Archive（见 src/index.ts scaffoldRemote），
  * 这里只保留「打包」一侧供测试构造伪 registry 的 tarball 响应。tar
  * 归档格式稳定，此工具不随业务演进，故不再单独维护解析逻辑与单测
- * ——其正确性由 __tests__/run-remote.test.ts 的「打包 → giget 解包」
+ * ——其正确性由 __tests__/run-remote.test.ts 的「打包 → Bun.Archive 解包」
  * 端到端链路间接验证。
  */
 

package/src/__tests__/template.test.ts

@@ -29,7 +29,7 @@ test("内置模板依赖纯度：不含任何 @koishijs / koishi-plugin 官方
 	}
 	for (const key of Object.keys(devDependencies ?? {})) {
 		expect(
-			key === "bun-types" || key.startsWith("@koishi-ce/"),
+			key === "@types/bun" || key.startsWith("@koishi-ce/"),
 		).toBe(true);
 	}
 });

package/src/remote.ts

@@ -3,7 +3,7 @@
 
 /**
  * 远程模板分支（--template <包名>）的下载-解包-改写全流程：拉取 npm
- * registry 包元数据解析目标版本，经 giget 下载 tarball 并解包到目标
+ * registry 包元数据解析目标版本，经 Bun.Archive 下载 tarball 并解包到目标
  * 目录，最后改写 package.json。HttpError 与 RegistryMeta 只在本流程
  * 消费，就近定义不另立文件；本机 registry 配置探测见 registry.ts。
  *
@@ -12,9 +12,17 @@
  * 经 RemoteOptions 显式传入，由 index.ts 的 scaffold 组装，避免子模块
  * 与顶层状态的隐式耦合。
  */
-import { readFileSync, writeFileSync } from "node:fs";
+import {
+	existsSync,
+	mkdtempSync,
+	readdirSync,
+	readFileSync,
+	renameSync,
+	rmSync,
+	writeFileSync,
+} from "node:fs";
+import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { downloadTemplate } from "giget";
 import pc from "picocolors";
 import {
 	type Manifest,
@@ -57,9 +65,8 @@ interface RemoteOptions {
 /**
  * 远程模板下载与解包：
  * 1. 拉取模板包元数据，按 dist-tags 解析目标版本（ref，默认 latest）；
- * 2. 下载 tarball 并解包到目标目录（解包走 giget，其按 npm tarball 惯例
- *    剥离顶层 package/ 目录，等价于 strip: 1），网络错误统一以 HttpError
- *    提示后退出；
+ * 2. 下载 tarball 并解包到目标目录（Bun.Archive 负责 tar/gzip 解包，按 npm
+ *    tarball 惯例剥离顶层 package/ 目录），网络错误统一以 HttpError 提示后退出；
  * 3. 最后改写 package.json。
  */
 export async function scaffoldRemote({
@@ -93,30 +100,34 @@ export async function scaffoldRemote({
 			);
 		}
 
-		// 解包交给 giget：provider 的 tar 字段是函数，giget 需要时才发起
-		// 下载（HttpError 在下载阶段抛出，不经 giget 包装可直接识别）；
-		// giget 先把 tarball 落入本地缓存再解压到 rootDir，解压失败
-		// （gzip 损坏 / 归档截断）走下方非 HttpError 分支原样上抛。
-		await downloadTemplate(template, {
-			provider: "npm",
-			providers: {
-				npm: async () => ({
-					name: template,
-					version,
-					tar: async () => {
-						const tarballRes = await fetch(url);
-						if (!tarballRes.ok || !tarballRes.body) {
-							throw new HttpError(
-								tarballRes.status,
-								tarballRes.statusText,
-							);
-						}
-						return tarballRes.body;
-					},
-				}),
-			},
-			dir: rootDir,
-		});
+		const tarballRes = await fetch(url);
+		if (!tarballRes.ok || !tarballRes.body) {
+			throw new HttpError(
+				tarballRes.status,
+				tarballRes.statusText,
+			);
+		}
+		const archive = new Bun.Archive(
+			await tarballRes.blob(),
+		);
+		const tempDir = mkdtempSync(
+			join(tmpdir(), "create-koishi-ce-"),
+		);
+		try {
+			await archive.extract(tempDir);
+			const packageDir = join(tempDir, "package");
+			if (!existsSync(packageDir)) {
+				throw new Error("远程模板归档缺少 package/ 目录");
+			}
+			for (const entry of readdirSync(packageDir)) {
+				renameSync(
+					join(packageDir, entry),
+					join(rootDir, entry),
+				);
+			}
+		} finally {
+			rmSync(tempDir, { recursive: true, force: true });
+		}
 	} catch (err) {
 		if (!(err instanceof HttpError)) throw err;
 		console.log(

package/src/template/tsconfig.json

@@ -1,16 +1,23 @@
 {
-  "compilerOptions": {
-    "target": "ESNext",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "lib": ["ESNext"],
-    "types": ["bun-types"],
-    "strict": true,
-    "skipLibCheck": true,
-    "noEmit": true,
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "erasableSyntaxOnly": true
-  },
-  "include": ["plugins/*/src", "external/*/src"]
-}
+    "compilerOptions": {
+        "target": "ESNext",
+        "module": "ESNext",
+        "moduleResolution": "bundler",
+        "lib": [
+            "ESNext"
+        ],
+        "types": [
+            "bun"
+        ],
+        "strict": true,
+        "skipLibCheck": true,
+        "noEmit": true,
+        "allowImportingTsExtensions": true,
+        "verbatimModuleSyntax": true,
+        "erasableSyntaxOnly": true
+    },
+    "include": [
+        "plugins/*/src",
+        "external/*/src"
+    ]
+}

package/src/template.ts

@@ -274,10 +274,12 @@ export function baseManifest(): Manifest {
 		overrides: buildUpstreamOverrides(),
 		devDependencies: {
 			"@koishi-ce/client": "^1.0.0",
+			"@koishi-ce/console-app": "^1.0.0",
+			"@koishi-ce/console-builder": "^1.0.0",
 			"@koishi-ce/plugin-hmr": "^1.0.0",
 			"@koishi-ce/plugin-mock": "^1.0.0",
 			"@koishi-ce/scripts": "^1.0.0",
-			"bun-types": "^1.4.0",
+			"@types/bun": "^1.4.0",
 		},
 	};
 }