create-koishi-ce 1.3.0 → 1.4.0

package/lib/bin.mjs

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

package/lib/index.d.ts

@@ -1,7 +1,12 @@
-//#region src/index.d.ts
+//#region src/manifest.d.ts
+/**
+ * 模板项目 package.json 的类型与改写（纯函数域，无副作用）：定义本流程
+ * 触碰字段的类型并提供渲染函数。内置模板（index.ts 的 scaffoldBuiltin
+ * 直接渲染写入）与远程模板（remote.ts 读回解包产物后改写）共用这里。
+ */
 /**
- * 模板项目的 package.json（改写目标）：只需要类型化本流程触碰的字段，
- * 其余字段经 index signature 原样保留。
+ * 模板项目的 package.json（改写源 / 目标）：只需要类型化本流程触碰的
+ * 字段，其余字段经 index signature 原样保留。
  */
 interface Manifest {
   name?: string;
@@ -13,11 +18,12 @@ interface Manifest {
   [key: string]: unknown;
 }
 /**
- * 探测后续安装/启动使用的包管理器（Bun-first）：yarn / pnpm 用户跟随其
- * 生态习惯；其余场景（npm、bun 及探测不到 user-agent）一律走 bun——
- * 本 CLI 自身以 bun 为运行时（bin shebang），能执行即已具备 bun 环境。
+ * 改写模板的 package.json（纯函数，导出供单测）：替换项目名、标记
+ * private、版本归零。
  */
-declare function detectAgent(): string;
+declare function renderManifest(source: Manifest, project: string, prod: boolean): string;
+//#endregion
+//#region src/registry.d.ts
 /**
  * 从单个 .npmrc 文件提取 registry 配置项（非注释、非 scoped 的 registry= 行）。
  * 文件不存在或未配置时返回 undefined，读文件异常一律静默吞掉。
@@ -25,22 +31,24 @@ declare function detectAgent(): string;
 declare function readNpmrcRegistry(file: string): string | undefined;
 /**
  * 读取本机 npm registry 配置（优先级对齐 npm 自身：环境变量 > 项目
- * .npmrc > 用户 ~/.npmrc）。刻意不 spawn 子进程探测——既有实现按
- * user-agent 选 `bun config get registry`，而 Bun 没有 config 子命令，
- * bunx 场景下子进程退出码 1 直接炸掉脚手架；读 npmrc 是零依赖、零
- * 子进程的等价路径。任何一步都拿不到时返回 undefined，由调用方回落
- * 官方源。
+ * .npmrc > 用户 ~/.npmrc）。任何一步都拿不到时返回 undefined，由调用方
+ * 回落官方源。
  */
 declare function getLocalRegistry(cwd?: string, userHome?: string): string | undefined;
+//#endregion
+//#region src/utils.d.ts
 /**
- * 改写模板的 package.json（纯函数，导出供单测）：替换项目名、标记
- * private、版本归零。
+ * 探测后续安装/启动使用的包管理器（Bun-first）：yarn / pnpm 用户跟随其
+ * 生态习惯；其余场景（npm、bun 及探测不到 user-agent）一律走 bun——
+ * 本 CLI 自身以 bun 为运行时（bin shebang），能执行即已具备 bun 环境。
  */
-declare function renderManifest(source: Manifest, project: string, prod: boolean): string;
+declare function detectAgent(): string;
+//#endregion
+//#region src/index.d.ts
 /**
  * CLI 主流程：--help 打印用法后即返回；否则依次执行
  * 项目名询问 → prepare（目录准备）→ scaffold（模板解包）→ initGit → install。
  */
 declare function start(): Promise<void>;
 //#endregion
-export { Manifest, detectAgent, getLocalRegistry, readNpmrcRegistry, renderManifest, start };
+export { type Manifest, detectAgent, getLocalRegistry, readNpmrcRegistry, renderManifest, start };

package/lib/index.mjs

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

package/lib/{src-DiZgIQu5.mjs → src-B1-ko5wA.mjs}

@@ -1,18 +1,17 @@
 import { spawnSync } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
 import { basename, dirname, join, relative } from "node:path";
-import { Readable } from "node:stream";
-import kleur from "kleur";
-import prompts from "prompts";
-import { extract } from "tar";
-import parse from "yargs-parser";
+import { parseArgs } from "node:util";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { homedir } from "node:os";
+import { downloadTemplate } from "giget";
 import { fileURLToPath } from "node:url";
 //#region package.json
 var package_default = {
 	name: "create-koishi-ce",
 	description: "Setup a Koishi application",
-	version: "1.3.0",
+	version: "1.4.0",
 	type: "module",
 	main: "./lib/index.mjs",
 	module: "./lib/index.mjs",
@@ -41,15 +40,10 @@ var package_default = {
 		"generator",
 		"boilerplate"
 	],
-	devDependencies: {
-		"@types/prompts": "^2.4.9",
-		"@types/yargs-parser": "^21.0.3"
-	},
 	dependencies: {
-		"kleur": "^4.1.5",
-		"prompts": "^2.4.2",
-		"tar": "^7.5.22",
-		"yargs-parser": "^22.0.0"
+		"@clack/prompts": "^1.7.0",
+		"picocolors": "^1.1.1",
+		"giget": "^3.3.1"
 	},
 	exports: {
 		".": {
@@ -62,6 +56,123 @@ var package_default = {
 	}
 };
 //#endregion
+//#region src/manifest.ts
+/**
+* 改写模板的 package.json（纯函数，导出供单测）：替换项目名、标记
+* private、版本归零。
+*/
+function renderManifest(source, project, prod) {
+	const meta = { ...source };
+	meta["name"] = project;
+	meta["private"] = true;
+	meta["version"] = "0.0.0";
+	if (prod) {
+		delete meta["workspaces"];
+		delete meta["devDependencies"];
+	}
+	return `${JSON.stringify(meta, null, 2)}\n`;
+}
+//#endregion
+//#region src/registry.ts
+/**
+* 本机 npm registry 配置探测（纯函数域，零子进程、零网络）：优先级对齐
+* npm 自身（环境变量 > 项目 .npmrc > 用户 ~/.npmrc）。刻意不 spawn 子进程
+* 探测——既有实现按 user-agent 选 `bun config get registry`，而 Bun 没有
+* config 子命令，bunx 场景下子进程退出码 1 直接炸掉脚手架；读 npmrc 是
+* 零依赖、零子进程的等价路径。远程模板下载流程见 remote.ts，不在本文件。
+*/
+/**
+* 从单个 .npmrc 文件提取 registry 配置项（非注释、非 scoped 的 registry= 行）。
+* 文件不存在或未配置时返回 undefined，读文件异常一律静默吞掉。
+*/
+function readNpmrcRegistry(file) {
+	try {
+		for (const line of readFileSync(file, "utf8").split(/\r?\n/)) {
+			const value = /^\s*registry\s*=\s*(\S+)\s*$/.exec(line)?.[1];
+			if (value) return value;
+		}
+	} catch {}
+}
+/**
+* 读取本机 npm registry 配置（优先级对齐 npm 自身：环境变量 > 项目
+* .npmrc > 用户 ~/.npmrc）。任何一步都拿不到时返回 undefined，由调用方
+* 回落官方源。
+*/
+function getLocalRegistry(cwd = process.cwd(), userHome = homedir()) {
+	const candidates = [
+		process.env["npm_config_registry"],
+		readNpmrcRegistry(join(cwd, ".npmrc")),
+		readNpmrcRegistry(join(userHome, ".npmrc"))
+	];
+	for (const candidate of candidates) if (candidate?.startsWith("https://") || candidate?.startsWith("http://")) return candidate;
+}
+//#endregion
+//#region src/remote.ts
+/**
+* 远程模板分支（--template <包名>）的下载-解包-改写全流程：拉取 npm
+* registry 包元数据解析目标版本，经 giget 下载 tarball 并解包到目标
+* 目录，最后改写 package.json。HttpError 与 RegistryMeta 只在本流程
+* 消费，就近定义不另立文件；本机 registry 配置探测见 registry.ts。
+*
+* 运行期状态（argv / project / rootDir）不跨文件共享——它们留在
+* index.ts 顶层（e2e 测试以模块 query 隔离实例）；本模块所需字段一律
+* 经 RemoteOptions 显式传入，由 index.ts 的 scaffold 组装，避免子模块
+* 与顶层状态的隐式耦合。
+*/
+/** fetch 请求非 2xx 时抛出的错误，携带 HTTP 状态码与状态文本 */
+var HttpError = class extends Error {
+	status;
+	statusText;
+	constructor(status, statusText) {
+		super(`HTTP ${status} ${statusText}`);
+		this.status = status;
+		this.statusText = statusText;
+	}
+};
+/**
+* 远程模板下载与解包：
+* 1. 拉取模板包元数据，按 dist-tags 解析目标版本（ref，默认 latest）；
+* 2. 下载 tarball 并解包到目标目录（解包走 giget，其按 npm tarball 惯例
+*    剥离顶层 package/ 目录，等价于 strip: 1），网络错误统一以 HttpError
+*    提示后退出；
+* 3. 最后改写 package.json。
+*/
+async function scaffoldRemote({ registry, template, ref, prod, project, rootDir }) {
+	try {
+		const metaRes = await fetch(`${registry}/${template}`);
+		if (!metaRes.ok) throw new HttpError(metaRes.status, metaRes.statusText);
+		const remote = await metaRes.json();
+		const version = remote["dist-tags"][ref];
+		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
+		});
+	} catch (err) {
+		if (!(err instanceof HttpError)) throw err;
+		console.log(`${pc.red("error")} 请求失败：HTTP ${err.status} ${err.statusText}`);
+		process.exit(1);
+	}
+	writePackageJson(rootDir, project, prod);
+}
+/** 把改写结果写回下载解包出的 package.json */
+function writePackageJson(rootDir, project, prod) {
+	const filename = join(rootDir, "package.json");
+	const meta = JSON.parse(readFileSync(filename, "utf8"));
+	writeFileSync(filename, renderManifest(meta, project, prod));
+}
+//#endregion
 //#region src/template.ts
 /**
 * 内置项目模板（create-koishi-ce 的默认模板）。
@@ -70,7 +181,7 @@ var package_default = {
 * 生成项目，产物依赖全是 npm 官方包（koishi / @koishijs/*），完全绕开了
 * 本仓的 @koishi-ce 再分发生态（官方 market 还带 Bun 下必炸的 get-registry）。
 * 默认模板改为内置的纯 @koishi-ce 依赖集；确需上游官方模板时用
-* --template <包名> 走 npm 远程下载（见 index.ts 的 scaffoldRemote）。
+* --template <包名> 走 npm 远程下载（见 remote.ts 的 scaffoldRemote）。
 *
 * 模板的静态文本一律放在 src/template/ 下的真实文件里（本模块只负责
 * 定位与读取，不再内嵌字符串常量）。npm 包的 files 含 src，因此 lib
@@ -88,8 +199,10 @@ var package_default = {
 *   （installer 的 isGuardedRequest 护栏将 npm:@koishi-ce alias 与
 *   workspace: 同等保护）；
 * - koishi.yml 对齐官方实例的预写策略：控制台与基础插件全量预装（依赖
-*   数据库的保持 ~ 禁用）；本仓不再分发的 adapter / database 官方插件只以
-*   ~ 禁用条目预写、不预装——loader 跳过禁用条目，装好后在控制台启用；
+*   数据库的保持 ~ 禁用）；database-sqlite 已随模板预装，去掉 ~ 即用；
+*   本仓不再分发的 adapter 官方插件与未再分发的 database（mongo / mysql
+*   / postgres）只以 ~ 禁用条目预写、不预装——loader 跳过禁用条目，装
+*   好后在控制台启用；
 * - 依赖版本统一 ^1.0.0 区间（安装时取最新 1.x），shim 版本例外（冻结线）。
 */
 /**
@@ -136,10 +249,14 @@ function baseManifest() {
 			"@koishi-ce/plugin-assets-local": "^1.0.0",
 			"@koishi-ce/plugin-auth": "^1.0.0",
 			"@koishi-ce/plugin-bind": "^1.0.0",
+			"@koishi-ce/plugin-broadcast": "^1.0.0",
+			"@koishi-ce/plugin-callme": "^1.0.0",
 			"@koishi-ce/plugin-commands": "^1.0.0",
 			"@koishi-ce/plugin-config": "^1.0.0",
 			"@koishi-ce/plugin-console": "^1.0.0",
+			"@koishi-ce/plugin-database-sqlite": "^1.0.0",
 			"@koishi-ce/plugin-dataview": "^1.0.0",
+			"@koishi-ce/plugin-echo": "^1.0.0",
 			"@koishi-ce/plugin-explorer": "^1.0.0",
 			"@koishi-ce/plugin-help": "^1.0.0",
 			"@koishi-ce/plugin-http": "^1.0.0",
@@ -165,50 +282,21 @@ function baseManifest() {
 		devDependencies: {
 			"@koishi-ce/client": "^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"
 		}
 	};
 }
 //#endregion
-//#region src/index.ts
+//#region src/utils.ts
 /**
-* create-koishi-ce 脚手架（npm 包名 create-koishi-ce，目录名为
-* apps/koishi-create，二者不一致是历史遗留，以目录名为准）。
-*
-* 通过 `bunx create-koishi-ce [name]`（npx 亦可）交互式创建 Koishi 机器人
-* 应用项目：确定项目名 → 准备目标目录 → 写入内置 @koishi-ce 模板（默认，
-* 见 src/template.ts；--template <包名> 可改用 npm registry 远程模板，如
-* 上游官方 @koishijs/boilerplate）→ 按需初始化 git → 询问是否立即安装
-* 依赖并启动。CLI 可执行入口在 src/bin.ts（构建产物 lib/bin.mjs，bin 字段
-* 指向它）；本文件只承载主流程与可单测的纯函数（范式对齐
-* @koishi-ce/scripts）。
+* 平台小工具（无业务状态、不触碰 CLI 全局状态的零散函数）：包管理器
+* 探测（detectAgent）、git 可用性与配置读取（supports / gitConfig）、
+* 目录清空（emptyDir）。分别被 index.ts 主流程的 install / initGit /
+* prepare 步骤调用，也是除 manifest.ts / registry.ts 之外可脱离交互
+* 直接单测的函数集合。
 */
-const { version } = package_default;
-/** fetch 请求非 2xx 时抛出的错误，携带 HTTP 状态码与状态文本 */
-var HttpError = class extends Error {
-	status;
-	statusText;
-	constructor(status, statusText) {
-		super(`HTTP ${status} ${statusText}`);
-		this.status = status;
-		this.statusText = statusText;
-	}
-};
-const argv = parse(process.argv.slice(2), { alias: {
-	ref: ["r"],
-	forced: ["f"],
-	git: ["g"],
-	prod: ["p"],
-	template: ["t"],
-	yes: ["y"],
-	help: ["h"]
-} });
-/** 项目目录名（rootDir 的最后一段，写入生成项目的 package.json 的 name） */
-let project;
-/** 目标目录的绝对路径（由用户输入的项目名拼接 cwd 得到） */
-let rootDir;
-const cwd = process.cwd();
 /**
 * 探测后续安装/启动使用的包管理器（Bun-first）：yarn / pnpm 用户跟随其
 * 生态习惯；其余场景（npm、bun 及探测不到 user-agent）一律走 bun——
@@ -220,34 +308,6 @@ function detectAgent() {
 	if (ua.startsWith("pnpm")) return "pnpm";
 	return "bun";
 }
-/**
-* 从单个 .npmrc 文件提取 registry 配置项（非注释、非 scoped 的 registry= 行）。
-* 文件不存在或未配置时返回 undefined，读文件异常一律静默吞掉。
-*/
-function readNpmrcRegistry(file) {
-	try {
-		for (const line of readFileSync(file, "utf8").split(/\r?\n/)) {
-			const value = /^\s*registry\s*=\s*(\S+)\s*$/.exec(line)?.[1];
-			if (value) return value;
-		}
-	} catch {}
-}
-/**
-* 读取本机 npm registry 配置（优先级对齐 npm 自身：环境变量 > 项目
-* .npmrc > 用户 ~/.npmrc）。刻意不 spawn 子进程探测——既有实现按
-* user-agent 选 `bun config get registry`，而 Bun 没有 config 子命令，
-* bunx 场景下子进程退出码 1 直接炸掉脚手架；读 npmrc 是零依赖、零
-* 子进程的等价路径。任何一步都拿不到时返回 undefined，由调用方回落
-* 官方源。
-*/
-function getLocalRegistry(cwd = process.cwd(), userHome = homedir()) {
-	const candidates = [
-		process.env["npm_config_registry"],
-		readNpmrcRegistry(join(cwd, ".npmrc")),
-		readNpmrcRegistry(join(userHome, ".npmrc"))
-	];
-	for (const candidate of candidates) if (candidate?.startsWith("https://") || candidate?.startsWith("http://")) return candidate;
-}
 /** 静默执行命令探测其是否可用（如 git --version），失败即视为不可用 */
 function supports(command) {
 	return spawnSync(command[0] ?? "", command.slice(1), { stdio: "ignore" }).status === 0;
@@ -261,36 +321,105 @@ function gitConfig(key) {
 	], { encoding: "utf8" });
 	return res.status === 0 ? res.stdout?.trim() ?? "" : "";
 }
+/** 递归清空目录内容（目录本身保留）。 */
+function emptyDir(root) {
+	for (const file of readdirSync(root)) rmSync(join(root, file), {
+		recursive: true,
+		force: true
+	});
+}
+//#endregion
+//#region src/index.ts
+/**
+* create-koishi-ce 脚手架（npm 包名 create-koishi-ce，目录名为
+* apps/koishi-create，二者不一致是历史遗留，以目录名为准）。
+*
+* 通过 `bunx create-koishi-ce [name]`（npx 亦可）交互式创建 Koishi 机器人
+* 应用项目：确定项目名 → 准备目标目录 → 写入内置 @koishi-ce 模板（默认，
+* 见 src/template.ts；--template <包名> 可改用 npm registry 远程模板，如
+* 上游官方 @koishijs/boilerplate）→ 按需初始化 git → 询问是否立即安装
+* 依赖并启动。CLI 可执行入口在 src/bin.ts（构建产物 lib/bin.mjs，bin 字段
+* 指向它）。
+*
+* 本文件是 CLI 的编排层：承载参数解析与运行期状态（argv / cwd /
+* project / rootDir —— 它们被 e2e 测试以模块 query 隔离实例，必须留在
+* 顶层模块内）与交互主流程。纯函数与单一职责的子流程按域拆到同目录
+* 子模块，公共导出面在文件尾原样 re-export（bin 与测试的导入路径不变）：
+* - manifest.ts   package.json 改写（Manifest / renderManifest）
+* - registry.ts   本机 npm registry 配置探测
+* - utils.ts      平台小工具（包管理器 / git 探测、清空目录）
+* - remote.ts     --template 远程模板的下载-解包-改写全流程
+* - template.ts   内置 @koishi-ce 模板（静态文件与 baseManifest）
+*/
+const { version } = package_default;
+const { values, positionals } = parseArgs({
+	args: process.argv.slice(2),
+	options: {
+		registry: { type: "string" },
+		ref: {
+			type: "string",
+			short: "r"
+		},
+		forced: {
+			type: "boolean",
+			short: "f"
+		},
+		git: {
+			type: "boolean",
+			short: "g"
+		},
+		prod: {
+			type: "boolean",
+			short: "p"
+		},
+		template: {
+			type: "string",
+			short: "t"
+		},
+		yes: {
+			type: "boolean",
+			short: "y"
+		},
+		help: {
+			type: "boolean",
+			short: "h"
+		}
+	},
+	allowPositionals: true
+});
+const argv = {
+	...values,
+	_: positionals
+};
+/** 项目目录名（rootDir 的最后一段，写入生成项目的 package.json 的 name） */
+let project;
+/** 目标目录的绝对路径（由用户输入的项目名拼接 cwd 得到） */
+let rootDir;
+const cwd = process.cwd();
 /**
 * 获取项目名：优先取第一个位置参数，否则交互式询问（默认 koishi-app）。
-* 用户取消或输入为空时直接退出（不强行兜底默认值）。
+* 用户取消（Ctrl+C）或输入为空时直接退出（不强行兜底默认值）。
 */
 async function getName() {
 	if (argv._[0]) return `${argv._[0]}`;
-	const trimmed = (await prompts({
-		type: "text",
-		name: "name",
+	const answer = await p.text({
 		message: "项目名：",
-		initial: "koishi-app"
-	})).name?.trim();
+		initialValue: "koishi-app",
+		validate: (value) => value?.trim() ? void 0 : "项目名不能为空"
+	});
+	if (p.isCancel(answer)) process.exit(0);
+	const trimmed = answer.trim();
 	if (!trimmed) process.exit(0);
 	return trimmed;
 }
-/** 递归清空目录内容（目录本身保留）。 */
-function emptyDir(root) {
-	for (const file of readdirSync(root)) rmSync(join(root, file), {
-		recursive: true,
-		force: true
-	});
-}
-/** 交互式确认框：返回用户是否选择了「是」（取消视为否） */
+/** 交互式确认框：返回用户是否选择了「是」（Ctrl+C 取消直接退出） */
 async function confirm(message) {
-	return (await prompts({
-		type: "confirm",
-		name: "yes",
-		initial: true,
-		message
-	})).yes === true;
+	const answer = await p.confirm({
+		message,
+		initialValue: true
+	});
+	if (p.isCancel(answer)) process.exit(0);
+	return answer === true;
 }
 /**
 * 准备目标目录：不存在则创建；已存在且非空时，未指定 --forced / --yes
@@ -303,33 +432,12 @@ async function prepare() {
 	}
 	if (!readdirSync(rootDir).length) return;
 	if (!argv.forced && !argv.yes) {
-		console.log(kleur.yellow(`  目标目录 "${project}" 非空。`));
+		console.log(pc.yellow(`  目标目录 "${project}" 非空。`));
 		if (!await confirm("清空现有文件并继续？")) process.exit(0);
 	}
 	emptyDir(rootDir);
 }
 /**
-* 改写模板的 package.json（纯函数，导出供单测）：替换项目名、标记
-* private、版本归零。
-*/
-function renderManifest(source, project, prod) {
-	const meta = { ...source };
-	meta["name"] = project;
-	meta["private"] = true;
-	meta["version"] = "0.0.0";
-	if (prod) {
-		delete meta["workspaces"];
-		delete meta["devDependencies"];
-	}
-	return `${JSON.stringify(meta, null, 2)}\n`;
-}
-/** 把改写结果写回生成项目的 package.json */
-function writePackageJson() {
-	const filename = join(rootDir, "package.json");
-	const meta = JSON.parse(readFileSync(filename, "utf8"));
-	writeFileSync(filename, renderManifest(meta, project, argv.prod === true));
-}
-/**
 * 写入内置模板（默认路径）：静态文件（src/template.ts 的 templateFiles）
 * 加上由 baseManifest() 渲染出的 package.json。纯本地写入，无网络请求。
 */
@@ -338,52 +446,25 @@ function scaffoldBuiltin() {
 	writeFileSync(join(rootDir, "package.json"), renderManifest(baseManifest(), project, argv.prod === true));
 }
 /**
-* 远程模板下载与解包（--template 指定时）：
-* 1. 拉取模板包元数据，按 dist-tags 解析目标版本（--ref，默认 latest）；
-* 2. 流式下载 tarball 并解包到目标目录（strip: 1 去掉包根目录层级），
-*    网络错误统一以 HttpError 提示后退出；
-* 3. 最后改写 package.json。
-*/
-async function scaffoldRemote(registry) {
-	const template = argv.template;
-	const ref = argv.ref || "latest";
-	try {
-		const metaRes = await fetch(`${registry}/${template}`);
-		if (!metaRes.ok) throw new HttpError(metaRes.status, metaRes.statusText);
-		const remote = await metaRes.json();
-		const version = remote["dist-tags"][ref];
-		const url = version === void 0 ? void 0 : remote.versions[version]?.dist?.tarball;
-		if (url === void 0) throw new HttpError(404, `模板 ${template}@${ref} 不存在`);
-		const tarballRes = await fetch(url);
-		const body = tarballRes.body;
-		if (!tarballRes.ok || !body) throw new HttpError(tarballRes.status, tarballRes.statusText);
-		await new Promise((resolve, reject) => {
-			Readable.fromWeb(body).pipe(extract({
-				cwd: rootDir,
-				newer: true,
-				strip: 1
-			})).on("finish", resolve).on("error", reject);
-		});
-	} catch (err) {
-		if (!(err instanceof HttpError)) throw err;
-		console.log(`${kleur.red("error")} 请求失败：HTTP ${err.status} ${err.statusText}`);
-		process.exit(1);
-	}
-	writePackageJson();
-}
-/**
 * 生成项目的主入口：默认写内置 @koishi-ce 模板（scaffoldBuiltin）；
-* --template <包名> 时改为从 npm registry 下载远程模板（scaffoldRemote），
-* registry 取值 --registry 参数 > 本机 npm 配置 > 官方源。
+* --template <包名> 时改为从 npm registry 下载远程模板（remote.ts 的
+* scaffoldRemote），registry 取值 --registry 参数 > 本机 npm 配置 > 官方源。
 */
 async function scaffold() {
-	console.log(kleur.dim("  正在 ") + project + kleur.dim(" 中生成项目 ..."));
+	console.log(pc.dim("  正在 ") + project + pc.dim(" 中生成项目 ..."));
 	if (argv.template) {
 		const registry = (argv.registry || getLocalRegistry() || "https://registry.npmjs.org").replace(/\/$/, "");
-		console.log(kleur.dim(`  使用 registry：${registry}\n`));
-		await scaffoldRemote(registry);
+		console.log(pc.dim(`  使用 registry：${registry}\n`));
+		await scaffoldRemote({
+			registry,
+			template: argv.template,
+			ref: argv.ref || "latest",
+			prod: argv.prod === true,
+			project,
+			rootDir
+		});
 	} else scaffoldBuiltin();
-	console.log(kleur.green("  完成。\n"));
+	console.log(pc.green("  完成。\n"));
 }
 /**
 * 初始化 git 仓库：仅在显式传入 --git 且本机装有 git 时执行，分支名取
@@ -400,7 +481,7 @@ async function initGit() {
 		stdio: "ignore",
 		cwd: rootDir
 	});
-	console.log(kleur.green(`  已初始化 git 仓库（分支 ${branch}）。\n`));
+	console.log(pc.green(`  已初始化 git 仓库（分支 ${branch}）。\n`));
 }
 /**
 * 收尾交互：询问是否立即安装依赖并启动，包管理器由 detectAgent()
@@ -415,7 +496,7 @@ async function install() {
 			stdio: "inherit",
 			cwd: rootDir
 		}).status !== 0) {
-			console.log(kleur.red("  依赖安装失败，请检查上方日志。"));
+			console.log(pc.red("  依赖安装失败，请检查上方日志。"));
 			return;
 		}
 		spawnSync(agent, startArgs, {
@@ -423,13 +504,13 @@ async function install() {
 			cwd: rootDir
 		});
 	} else {
-		console.log(kleur.dim("  稍后可以这样启动：\n"));
+		console.log(pc.dim("  稍后可以这样启动：\n"));
 		if (rootDir !== cwd) {
 			const related = relative(cwd, rootDir);
-			console.log(kleur.blue(`  cd ${kleur.bold(related)}`));
+			console.log(pc.blue(`  cd ${pc.bold(related)}`));
 		}
-		console.log(kleur.blue(`  ${agent === "yarn" ? "yarn" : `${agent} install`}`));
-		console.log(kleur.blue(`  ${agent === "yarn" ? "yarn" : `${agent} run`} start`));
+		console.log(pc.blue(`  ${agent === "yarn" ? "yarn" : `${agent} install`}`));
+		console.log(pc.blue(`  ${agent === "yarn" ? "yarn" : `${agent} run`} start`));
 		console.log();
 	}
 }
@@ -455,7 +536,7 @@ async function start() {
 		return;
 	}
 	console.log();
-	console.log(`  ${kleur.bold("Create Koishi")}  ${kleur.blue(`v${version}`)}`);
+	console.log(`  ${pc.bold("Create Koishi")}  ${pc.blue(`v${version}`)}`);
 	console.log();
 	const name = await getName();
 	rootDir = join(cwd, name);
@@ -466,4 +547,4 @@ async function start() {
 	await install();
 }
 //#endregion
-export { start as a, renderManifest as i, getLocalRegistry as n, readNpmrcRegistry as r, detectAgent as t };
+export { renderManifest as a, readNpmrcRegistry as i, detectAgent as n, getLocalRegistry as r, start as t };