create-napukettoqq 0.0.1 → 0.2.0

package/README.md

@@ -0,0 +1,12 @@
+# create-napukettoqq
+
+一键生成 NapukettoQQ 机器人项目（pnpm / yarn / npm 均可）。
+
+```bash
+pnpm create napukettoqq            # 交互输入部署目录名（回车取默认 NapukettoQQ）
+pnpm create napukettoqq my-bot     # 位置参数指定目录，跳过交互
+```
+
+生成 `package.json` / `napuketto.toml` / `readme.md` / `.gitignore` 骨架，用调用方包管理器自动安装依赖，并询问是否立即启动（默认 Y）。
+
+生成的用户项目依赖发布版的 `@napuketto/cli`，`pnpm start` 即启动。

package/dist/index.mjs

@@ -1,19 +1,52 @@
 #!/usr/bin/env node
-import process$1 from "node:process";
-import { createInterface } from "node:readline/promises";
-import { mkdir, readdir, writeFile } from "node:fs/promises";
+import { spawn } from "node:child_process";
+import { readFileSync } from "node:fs";
+import path, { relative } from "node:path";
+import process from "node:process";
+import { cancel, confirm, intro, isCancel, log, outro, spinner, text } from "@clack/prompts";
+import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import path from "node:path";
 //#region src/scaffold.ts
 /**
-* create-napukettoqq 脚手架核心：模板 + 目标目录创建 + 文件写入。
+* create-napukettoqq 脚手架核心：模板渲染 + 目标目录创建 + 文件写入。
 *
-* 零依赖（仅 node:fs/promises / node:os / node:path / node:process），
-* 一次性工具保持自包含。生成的用户项目依赖发布版的 @napuketto/cli，
-* 用户 install 后经 cli → loader 自建宿主启动。
+* 模板为独立文件（templates/ 目录，运行时读取），不硬编码在源码里；
+* 需要插值的占位符用 {{key}} 标记（见 renderTemplate）。
+* 依赖极轻（node:fs/promises / node:os / node:path / node:process）。
+* 生成的用户项目依赖发布版的 @napuketto/cli，用户 install 后经 cli → loader
+* 自建宿主启动。
 */
-/** 生成的用户项目所依赖的 @napuketto/cli 版本范围（发布新版时统一改）。 */
-const CLI_VERSION = "^0.0.1";
+/** 模板目录（相对本文件：src 与 dist 都在包根下，../templates 均指向包根/templates）。 */
+const TEMPLATES = new URL("../templates/", import.meta.url);
+/**
+* 生成的用户项目所依赖的 @napuketto/cli 版本范围。
+* 运行时从脚手架自身 package.json 读取（dependencies["@napuketto/cli"]）——
+* 发版时 changesets 升版本 + pnpm publish 把 workspace:* 替换为实际版本，
+* 模板版本自动跟随，无需手动同步（比硬编码常量可靠）。
+*/
+function cliVersionRange() {
+	try {
+		const range = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).dependencies?.["@napuketto/cli"];
+		if (range !== void 0 && range !== "workspace:*") return range;
+	} catch {}
+	return "^0.0.1";
+}
+/** 默认部署文件夹名（用户交互回车缺省值）。 */
+const DEFAULT_PROJECT_NAME = "NapukettoQQ";
+/**
+* 由 npm_config_user_agent 检测调用方包管理器（yarn create / npm create /
+* pnpm create 都会注入该变量）。兜底 pnpm（项目生态，或直接 node 运行）。
+*/
+function detectPackageManager() {
+	const ua = process.env["npm_config_user_agent"] ?? "";
+	if (ua.startsWith("yarn/")) return "yarn";
+	if (ua.startsWith("npm/")) return "npm";
+	return "pnpm";
+}
+/** Windows 下包管理器 bin 需带 .cmd 后缀（CreateProcess 不认无扩展名 shim）。 */
+function pmBin(pm) {
+	return process.platform === "win32" ? `${pm}.cmd` : pm;
+}
 /** Windows 路径非法字符（项目文件夹名校验用）。 */
 const ILLEGAL_NAME = /[\\/:*?"<>|]/;
 /** 校验文件夹名：非空、非 . / ..、不含 Windows 非法字符。 */
@@ -27,170 +60,65 @@ function validateProjectName(raw) {
 function derivePackageName(dirName) {
 	return dirName.toLowerCase().replace(/\s+/g, "-");
 }
-/** 生成 package.json（用户项目，JSON.stringify 保证合法）。 */
-function packageJsonTemplate(packageName) {
-	return `${JSON.stringify({
-		name: packageName,
-		version: "0.0.1",
-		private: true,
-		type: "module",
-		description: "NapukettoQQ 机器人项目（OneBot 11）",
-		scripts: { start: "napuketto" },
-		dependencies: { "@napuketto/cli": CLI_VERSION }
-	}, null, 4)}\n`;
+/** 解析目标目录绝对路径（校验名称后，基于 cwd）。 */
+function resolveTargetDir(dirName) {
+	return path.resolve(process.cwd(), validateProjectName(dirName));
+}
+/** 检测目标目录状态（供交互层决定是否询问清空）。 */
+async function checkDirStatus(dir) {
+	let entries = [];
+	try {
+		entries = await readdir(dir);
+	} catch {
+		return "missing";
+	}
+	return entries.length === 0 ? "empty" : "nonempty";
+}
+/** 清空目录内容（保留目录本身）。 */
+async function emptyDir(dir) {
+	for (const entry of await readdir(dir)) await rm(path.join(dir, entry), {
+		recursive: true,
+		force: true
+	});
+}
+/** 读取模板文件（templates/ 目录，UTF-8）。 */
+function readTemplate(file) {
+	return readFile(new URL(file, TEMPLATES), "utf8");
 }
 /**
-* 生成 napuketto.toml：与 cli configTemplate（apps/cli/src/config-cmds.ts）同款内容，
-* dataDir 按当前用户主目录插值（JSON.stringify 转义反斜杠 → TOML 基本字符串合法写法）。
+* 占位符渲染：把 {{key}} 替换为 vars[key]。
+* 模板中出现未提供的占位符 → 抛错（防漏插值写出半成品）。
 */
-function tomlTemplate() {
-	return `# ============================================================
-# NapukettoQQ 全局配置文件（由 create-napukettoqq 生成）
-# ============================================================
-# 本文件与项目 napuketto.toml.example 内容一致（参考模板）。
-# 数据（账号目录/日志/缓存/QQ 数据）不在此文件，按数据根组织：
-#   优先级：--data-dir <dir> > NAPKETTO_DATA 环境变量 > ~/.napuketto
-# 配置文件路径解析：NAPKETTO_CONFIG > 项目根探测 > cwd > 数据根兜底。
-#
-# 单账号启动每次读取本文件；修改后重启生效。
-
-# ------------------------------------------------------------
-# 基础配置
-# ------------------------------------------------------------
-
-# 数据根目录：账号目录/日志/缓存/QQ 数据存放位置（绝对路径）
-dataDir = ${JSON.stringify(path.join(homedir(), ".napuketto"))}
-
-# 多账号（supervisor）模式下，账号进程崩溃是否自动重启
-autoRestart = true
-
-# 崩溃后自动重启的延迟（毫秒）
-restartDelayMs = 2000
-
-# 多账号列表（留空 = 单账号模式：启动后自动快速登录/扫码）
-# [[accounts]]
-# qq = "123456"          # QQ 号（必填）
-# enabled = true         # 是否启用（可选，缺省 true）
-
-# ------------------------------------------------------------
-# OneBot 11 协议段
-# ------------------------------------------------------------
-[onebot11]
-
-# 鉴权 token（全局默认）：HTTP/WS 连接必须携带。
-#   校验方式：Authorization: Bearer <token> / 裸 token / URL 参数 ?access_token=<token>
-#   每个网络实例可单独覆盖（见下文各实例的 token 字段）。
-#   留空 = 不鉴权（仅本机调试推荐）。
-# token = ""
-
-# 心跳 meta 事件间隔（毫秒）；0 = 关闭心跳事件
-heartbeatInterval = 3000
-
-# 是否上报机器人自己发的消息（OB11 规范默认不上报）
-reportSelfMessage = false
-
-# 消息内容格式：array = 消息段数组（标准 OneBot 11），string = CQ 码字符串
-messagePostFormat = "array"
-
-# ---- HTTP 反向服务器（接收第三方 POST 指令），可配置多个 ----
-[[onebot11.httpServers]]
-enabled = true
-host = "127.0.0.1"       # 监听地址；0.0.0.0 = 监听所有网卡（局域网可连）
-port = 3000
-# token = "abc"          # 可选：覆盖全局 token
-
-# ---- HTTP 正向上报（Webhook：把事件 POST 到第三方地址），可配置多个 ----
-# [[onebot11.httpPostUrls]]
-# enabled = true
-# url = "http://127.0.0.1:8080/onebot"   # 第三方接收地址
-# token = "abc"                          # 可选：覆盖全局 token
-# timeoutMs = 5000                       # 可选：上报超时（毫秒），缺省不超时
-
-# ---- WS 反向服务器（外部 WS 客户端主动连入），可配置多个 ----
-[[onebot11.wsServers]]
-enabled = true
-host = "127.0.0.1"
-port = 3001
-# token = "abc"                          # 可选：覆盖全局 token
-# heartbeatInterval = 30000              # 可选：WS ping 间隔（毫秒）
-
-# ---- WS 正向客户端（主动连接外部 WS，双向），可配置多个 ----
-# [[onebot11.wsReverseUrls]]
-# enabled = true
-# url = "ws://127.0.0.1:8081/ws"         # 第三方 WS 地址（ws:// 或 wss://）
-# token = "abc"                          # 可选：覆盖全局 token
-# reconnectDelayMs = 5000                # 可选：断线重连延迟（毫秒）
-# maxReconnectAttempts = 10              # 可选：最大重连次数（缺省无限）
-# rejectUnauthorized = true              # 可选：wss:// 是否校验证书（自签证书设 false）
-# heartbeatInterval = 30000              # 可选：WS ping 间隔（毫秒）
-`;
-}
-/** 生成 readme.md（用户项目使用说明）。 */
-function readmeTemplate(dirName) {
-	return `# ${dirName}
-
-基于 **NapukettoQQ** 的 QQ 机器人项目（OneBot 11 协议），由 \`create-napukettoqq\` 生成。
-
-## 快速开始
-
-\`\`\`bash
-pnpm install
-pnpm start -q 123456        # 换成你的 QQ 号
-\`\`\`
-
-启动后按终端提示快速登录或扫码；登录成功后 OneBot 11 接口生效
-（默认 HTTP \`127.0.0.1:3000\` + WS \`127.0.0.1:3001\`，见 \`napuketto.toml\`）。
-
-## 前置要求
-
-- 已安装 **QQ NT**（Windows，机器人所需的 \`wrapper.node\` 来自 QQ 安装目录，
-  未自动探测到时用 \`pnpm start --qq-path <QQ安装目录>\` 指定）
-- Node.js 20+ 与 pnpm
-
-## 常用命令
-
-| 命令 | 说明 |
-|---|---|
-| \`pnpm start -q <QQ号>\` | 单账号启动（走自建宿主） |
-| \`pnpm napuketto config init\` | 重新生成默认配置 |
-| \`pnpm napuketto supervisor\` | 多账号模式（按 \`napuketto.toml\` 的 \`accounts\`） |
-
-## 目录
-
-- \`napuketto.toml\` — 全局配置（QQ 号、OneBot 端口、token 等，修改后重启生效）
-- QQ 数据（账号目录/日志/缓存）默认在 \`~/.napuketto/\`
-
-## 升级
-
-\`\`\`bash
-pnpm update @napuketto/cli
-\`\`\`
-`;
+function renderTemplate(content, vars) {
+	return content.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+		const value = vars[key];
+		if (value === void 0) throw new Error(`模板占位符未提供：{{${key}}}（模板 ${match} 无法渲染）`);
+		return value;
+	});
 }
-/** 生成 .gitignore（用户项目）。 */
-const GITIGNORE = `node_modules/
-dist/
-*.log
-napuketto-data/
-`;
 /**
 * 生成 NapukettoQQ 项目骨架到当前目录下的 <dirName>/。
-* 目标目录已存在且非空 → 抛错（提示换名字或先清空）。
+* 目标目录已存在且非空：overwrite=false → 抛错；overwrite=true → 清空后生成。
+* 模板与写入目标一一对应（同文件名）。
 */
-async function scaffoldProject(dirName) {
+async function scaffoldProject(dirName, overwrite = false) {
 	const name = validateProjectName(dirName);
 	const packageName = derivePackageName(name);
-	const dir = path.resolve(process.cwd(), name);
-	let existing = [];
-	try {
-		existing = await readdir(dir);
-	} catch {}
-	if (existing.length > 0) throw new Error(`目录已存在且非空：${dir}\n请换一个文件夹名，或先清空该目录。`);
+	const dir = resolveTargetDir(name);
+	const status = await checkDirStatus(dir);
+	if (status === "nonempty" && !overwrite) throw new Error(`目录已存在且非空：${dir}\n请换一个文件夹名，或先清空该目录。`);
+	if (status === "nonempty") await emptyDir(dir);
+	const vars = {
+		packageName,
+		cliVersion: cliVersionRange(),
+		dataDir: JSON.stringify(path.join(homedir(), ".napuketto"))
+	};
+	const files = ["package.json", "napuketto.toml"];
 	await mkdir(dir, { recursive: true });
-	await writeFile(path.join(dir, "package.json"), packageJsonTemplate(packageName), "utf8");
-	await writeFile(path.join(dir, "napuketto.toml"), tomlTemplate(), "utf8");
-	await writeFile(path.join(dir, "readme.md"), readmeTemplate(name), "utf8");
-	await writeFile(path.join(dir, ".gitignore"), GITIGNORE, "utf8");
+	for (const file of files) {
+		const rendered = renderTemplate(await readTemplate(`${file}.tmpl`), vars);
+		await writeFile(path.join(dir, file), rendered, "utf8");
+	}
 	return {
 		dir,
 		packageName
@@ -199,48 +127,166 @@ async function scaffoldProject(dirName) {
 //#endregion
 //#region src/index.ts
 /**
-* create-napukettoqq 入口（2026-08-07）。
+* create-napukettoqq 入口（2026-08-07 美化 v3，交互层用 @clack/prompts——
+* 现代脚手架交互标准，create-vue / create-turbo 同款）。
 *
 * 用法：
-*   create-napukettoqq                # 交互问部署文件夹名（默认 NapukettoQQ）
-*   create-napukettoqq my-bot         # 位置参数指定文件夹名，跳过交互
+*   create-napukettoqq                # intro + 交互问部署文件夹名（默认 NapukettoQQ）
+*   create-napukettoqq my-bot         # 位置参数指定文件夹名，跳过命名交互
+*   create-napukettoqq my-bot -f      # 目标目录非空时强制清空覆盖
+*   create-napukettoqq -y             # 全默认（命名用默认值、启动询问用默认 Y）
+*   create-napukettoqq -h             # 打印帮助
 *
-* 在当前目录下生成 NapukettoQQ 机器人项目骨架（package.json / napuketto.toml /
-* readme.md / .gitignore），随后打印下一步指引（pnpm install && pnpm start）。
+* 流程：intro → 问文件夹名 → 目标目录准备（非空需确认清空）→ spinner 生成骨架
+*   （package.json / napuketto.toml / readme.md / .gitignore）→ 用调用方包管理器
+*   自动 install → 询问是否现在启动（默认 Y）→ 前台运行 → outro 收尾。
 */
-/** 交互询问部署文件夹名（回车取默认值）。 */
-async function askProjectName() {
-	const rl = createInterface({
-		input: process$1.stdin,
-		output: process$1.stdout
-	});
+/** 帮助文本（-h/--help）。 */
+const HELP = `  用法: create-napukettoqq [name] [选项]
+
+  选项:
+    -f, --forced   目标目录非空时强制清空并覆盖
+    -y, --yes      跳过所有交互提示（使用默认值）
+    -h, --help     显示本帮助
+`;
+/** 解析命令行参数（flag 仅三个，手写保持自包含，不引 yargs-parser）。 */
+function parseArgs(argv) {
+	const opts = {
+		forced: false,
+		yes: false,
+		help: false
+	};
+	for (const arg of argv) if (arg === "-f" || arg === "--forced") opts.forced = true;
+	else if (arg === "-y" || arg === "--yes") opts.yes = true;
+	else if (arg === "-h" || arg === "--help") opts.help = true;
+	else if (arg.startsWith("-")) throw new Error(`未知参数：${arg}`);
+	else if (opts.name === void 0) opts.name = arg;
+	else throw new Error(`多余的位置参数：${arg}`);
+	return opts;
+}
+/** 读取脚手架自身版本号（intro 显示；dist 场景 import.meta.url 指向包内）。 */
+function readVersion() {
 	try {
-		return (await rl.question(`? 部署文件夹名（默认 NapukettoQQ）: `)).trim() || "NapukettoQQ";
-	} finally {
-		rl.close();
+		return JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version ?? "0.0.0";
+	} catch {
+		return "0.0.0";
 	}
 }
-/** 打印生成结果与下一步指引（功能输出，不经日志框架）。 */
-function printNextSteps(dir) {
-	console.log("\n========================================");
-	console.log("  NapukettoQQ 项目已生成");
-	console.log(`  位置：${dir}`);
-	console.log("========================================");
-	console.log("下一步：");
-	console.log(`  cd ${dir}`);
-	console.log("  pnpm install");
-	console.log("  pnpm start -q <你的QQ号>");
-	console.log("");
-	console.log("前置要求：本机已安装 QQ NT（wrapper.node 来自 QQ 安装目录）。");
-	console.log("详细说明见项目内 readme.md 与 napuketto.toml。");
+/** 交互询问部署文件夹名（回车取默认值；-y 直接返回默认值）。 */
+async function askProjectName(yes) {
+	if (yes) return DEFAULT_PROJECT_NAME;
+	const name = await text({
+		message: "部署文件夹名",
+		placeholder: DEFAULT_PROJECT_NAME,
+		initialValue: DEFAULT_PROJECT_NAME,
+		validate: (input) => {
+			try {
+				validateProjectName(input ?? "");
+				return;
+			} catch (err) {
+				return err instanceof Error ? err.message : String(err);
+			}
+		}
+	});
+	if (isCancel(name)) {
+		cancel("操作已取消");
+		process.exit(0);
+	}
+	return validateProjectName(name);
+}
+/** 询问是否移除现有文件并继续（目标目录非空时）。 */
+async function confirmRemove(dirName) {
+	const ok = await confirm({
+		message: `目录 "${dirName}" 已存在且非空，移除现有文件并继续？`,
+		initialValue: false
+	});
+	if (isCancel(ok)) {
+		cancel("操作已取消");
+		process.exit(0);
+	}
+	return ok;
+}
+/** 询问是否现在启动（默认 Y；-y 直接返回 true）。 */
+async function askStartNow(yes) {
+	if (yes) return true;
+	const ok = await confirm({
+		message: "是否现在启动？",
+		initialValue: true
+	});
+	if (isCancel(ok)) {
+		cancel("操作已取消");
+		process.exit(0);
+	}
+	return ok;
+}
+/** 前台执行命令（stdio 继承，用户可见进度/交互），返回退出码。 */
+function runInteractive(bin, args, cwd) {
+	return new Promise((resolve) => {
+		spawn(bin, args, {
+			cwd,
+			stdio: "inherit",
+			windowsHide: false,
+			shell: process.platform === "win32"
+		}).on("exit", (code) => {
+			resolve(code ?? 0);
+		});
+	});
 }
 async function main() {
-	printNextSteps((await scaffoldProject(process$1.argv[2] ?? await askProjectName())).dir);
+	const opts = parseArgs(process.argv.slice(2));
+	if (opts.help) {
+		console.log(HELP);
+		return;
+	}
+	intro(`create-napukettoqq  v${readVersion()}`);
+	const dirName = opts.name ?? await askProjectName(opts.yes);
+	const targetDir = resolveTargetDir(dirName);
+	let overwrite = false;
+	if (await checkDirStatus(targetDir) === "nonempty") if (!opts.forced) {
+		log.warn(`目标目录 "${dirName}" 已存在且非空。`);
+		overwrite = await confirmRemove(dirName);
+		if (!overwrite) {
+			outro("已取消，未做任何修改。");
+			return;
+		}
+	} else overwrite = true;
+	const s = spinner();
+	s.start(`正在生成项目骨架 ${dirName} ...`);
+	const result = await scaffoldProject(dirName, overwrite);
+	s.stop(`项目骨架已生成：${dirName}`);
+	log.success(`位置：${result.dir}`);
+	const pm = detectPackageManager();
+	log.info(`包管理器：${pm}（自动检测）`);
+	log.info("前置要求：本机已安装 QQ NT（wrapper.node 来自 QQ 安装目录）。");
+	log.info(`正在安装依赖（${pm} install）...`);
+	const installCode = await runInteractive(pmBin(pm), ["install"], result.dir);
+	if (installCode !== 0) {
+		log.error(`依赖安装失败（退出码 ${installCode}）。请手动执行：`);
+		log.step(`cd ${result.dir}`);
+		log.step(`${pm} install`);
+		outro("创建失败，请手动安装后重试。");
+		process.exitCode = 1;
+		return;
+	}
+	if (await askStartNow(opts.yes)) {
+		log.info("正在启动 NapukettoQQ（Ctrl+C 停止）...\n");
+		const startCode = await runInteractive(pmBin(pm), ["start"], result.dir);
+		if (startCode !== 0) process.exitCode = startCode;
+	} else {
+		log.message("你可以稍后这样启动：");
+		if (targetDir !== process.cwd()) {
+			const related = relative(process.cwd(), targetDir);
+			log.step(`cd ${related}`);
+		}
+		log.step(`${pm} start -q <你的QQ号>`);
+		log.message("配置说明见项目内 napuketto.toml。");
+	}
+	outro("完成。");
 }
 main().catch((err) => {
 	const message = err instanceof Error ? err.message : String(err);
-	console.error(`创建失败：${message}`);
-	process$1.exitCode = 1;
+	log.error(`创建失败：${message}`);
+	process.exitCode = 1;
 });
 //#endregion
 export {};

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["process"],"sources":["../src/scaffold.ts","../src/index.ts"],"sourcesContent":["/**\n * create-napukettoqq 脚手架核心：模板 + 目标目录创建 + 文件写入。\n *\n * 零依赖（仅 node:fs/promises / node:os / node:path / node:process），\n * 一次性工具保持自包含。生成的用户项目依赖发布版的 @napuketto/cli，\n * 用户 install 后经 cli → loader 自建宿主启动。\n */\n\nimport { mkdir, readdir, writeFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\n\n/** 生成的用户项目所依赖的 @napuketto/cli 版本范围（发布新版时统一改）。 */\nexport const CLI_VERSION = \"^0.0.1\";\n\n/** 默认部署文件夹名（用户交互回车缺省值）。 */\nexport const DEFAULT_PROJECT_NAME = \"NapukettoQQ\";\n\n/** Windows 路径非法字符（项目文件夹名校验用）。 */\nconst ILLEGAL_NAME = /[\\\\/:*?\"<>|]/;\n\n/** 脚手架生成结果。 */\nexport interface ScaffoldResult {\n    /** 目标目录绝对路径。 */\n    dir: string;\n    /** 派生出的 npm 包名（小写、空格 → -）。 */\n    packageName: string;\n}\n\n/** 校验文件夹名：非空、非 . / ..、不含 Windows 非法字符。 */\nexport function validateProjectName(raw: string): string {\n    const name = raw.trim();\n    if (name === \"\" || name === \".\" || name === \"..\") {\n        throw new Error(\"文件夹名不能为空或为 . / ..\");\n    }\n    if (ILLEGAL_NAME.test(name)) {\n        throw new Error(`文件夹名含非法字符：${name}（不允许 \\\\ / : * ? \" < > |）`);\n    }\n    return name;\n}\n\n/** 由文件夹名派生 npm 包名（小写、空格 → -）。 */\nexport function derivePackageName(dirName: string): string {\n    return dirName.toLowerCase().replace(/\\s+/g, \"-\");\n}\n\n/** 生成 package.json（用户项目，JSON.stringify 保证合法）。 */\nfunction packageJsonTemplate(packageName: string): string {\n    const pkg = {\n        name: packageName,\n        version: \"0.0.1\",\n        private: true,\n        type: \"module\",\n        description: \"NapukettoQQ 机器人项目（OneBot 11）\",\n        scripts: {\n            start: \"napuketto\",\n        },\n        dependencies: {\n            \"@napuketto/cli\": CLI_VERSION,\n        },\n    };\n    return `${JSON.stringify(pkg, null, 4)}\\n`;\n}\n\n/**\n * 生成 napuketto.toml：与 cli configTemplate（apps/cli/src/config-cmds.ts）同款内容，\n * dataDir 按当前用户主目录插值（JSON.stringify 转义反斜杠 → TOML 基本字符串合法写法）。\n */\nfunction tomlTemplate(): string {\n    const dataDirLiteral = JSON.stringify(path.join(homedir(), \".napuketto\"));\n    return `# ============================================================\n# NapukettoQQ 全局配置文件（由 create-napukettoqq 生成）\n# ============================================================\n# 本文件与项目 napuketto.toml.example 内容一致（参考模板）。\n# 数据（账号目录/日志/缓存/QQ 数据）不在此文件，按数据根组织：\n#   优先级：--data-dir <dir> > NAPKETTO_DATA 环境变量 > ~/.napuketto\n# 配置文件路径解析：NAPKETTO_CONFIG > 项目根探测 > cwd > 数据根兜底。\n#\n# 单账号启动每次读取本文件；修改后重启生效。\n\n# ------------------------------------------------------------\n# 基础配置\n# ------------------------------------------------------------\n\n# 数据根目录：账号目录/日志/缓存/QQ 数据存放位置（绝对路径）\ndataDir = ${dataDirLiteral}\n\n# 多账号（supervisor）模式下，账号进程崩溃是否自动重启\nautoRestart = true\n\n# 崩溃后自动重启的延迟（毫秒）\nrestartDelayMs = 2000\n\n# 多账号列表（留空 = 单账号模式：启动后自动快速登录/扫码）\n# [[accounts]]\n# qq = \"123456\"          # QQ 号（必填）\n# enabled = true         # 是否启用（可选，缺省 true）\n\n# ------------------------------------------------------------\n# OneBot 11 协议段\n# ------------------------------------------------------------\n[onebot11]\n\n# 鉴权 token（全局默认）：HTTP/WS 连接必须携带。\n#   校验方式：Authorization: Bearer <token> / 裸 token / URL 参数 ?access_token=<token>\n#   每个网络实例可单独覆盖（见下文各实例的 token 字段）。\n#   留空 = 不鉴权（仅本机调试推荐）。\n# token = \"\"\n\n# 心跳 meta 事件间隔（毫秒）；0 = 关闭心跳事件\nheartbeatInterval = 3000\n\n# 是否上报机器人自己发的消息（OB11 规范默认不上报）\nreportSelfMessage = false\n\n# 消息内容格式：array = 消息段数组（标准 OneBot 11），string = CQ 码字符串\nmessagePostFormat = \"array\"\n\n# ---- HTTP 反向服务器（接收第三方 POST 指令），可配置多个 ----\n[[onebot11.httpServers]]\nenabled = true\nhost = \"127.0.0.1\"       # 监听地址；0.0.0.0 = 监听所有网卡（局域网可连）\nport = 3000\n# token = \"abc\"          # 可选：覆盖全局 token\n\n# ---- HTTP 正向上报（Webhook：把事件 POST 到第三方地址），可配置多个 ----\n# [[onebot11.httpPostUrls]]\n# enabled = true\n# url = \"http://127.0.0.1:8080/onebot\"   # 第三方接收地址\n# token = \"abc\"                          # 可选：覆盖全局 token\n# timeoutMs = 5000                       # 可选：上报超时（毫秒），缺省不超时\n\n# ---- WS 反向服务器（外部 WS 客户端主动连入），可配置多个 ----\n[[onebot11.wsServers]]\nenabled = true\nhost = \"127.0.0.1\"\nport = 3001\n# token = \"abc\"                          # 可选：覆盖全局 token\n# heartbeatInterval = 30000              # 可选：WS ping 间隔（毫秒）\n\n# ---- WS 正向客户端（主动连接外部 WS，双向），可配置多个 ----\n# [[onebot11.wsReverseUrls]]\n# enabled = true\n# url = \"ws://127.0.0.1:8081/ws\"         # 第三方 WS 地址（ws:// 或 wss://）\n# token = \"abc\"                          # 可选：覆盖全局 token\n# reconnectDelayMs = 5000                # 可选：断线重连延迟（毫秒）\n# maxReconnectAttempts = 10              # 可选：最大重连次数（缺省无限）\n# rejectUnauthorized = true              # 可选：wss:// 是否校验证书（自签证书设 false）\n# heartbeatInterval = 30000              # 可选：WS ping 间隔（毫秒）\n`;\n}\n\n/** 生成 readme.md（用户项目使用说明）。 */\nfunction readmeTemplate(dirName: string): string {\n    return `# ${dirName}\n\n基于 **NapukettoQQ** 的 QQ 机器人项目（OneBot 11 协议），由 \\`create-napukettoqq\\` 生成。\n\n## 快速开始\n\n\\`\\`\\`bash\npnpm install\npnpm start -q 123456        # 换成你的 QQ 号\n\\`\\`\\`\n\n启动后按终端提示快速登录或扫码；登录成功后 OneBot 11 接口生效\n（默认 HTTP \\`127.0.0.1:3000\\` + WS \\`127.0.0.1:3001\\`，见 \\`napuketto.toml\\`）。\n\n## 前置要求\n\n- 已安装 **QQ NT**（Windows，机器人所需的 \\`wrapper.node\\` 来自 QQ 安装目录，\n  未自动探测到时用 \\`pnpm start --qq-path <QQ安装目录>\\` 指定）\n- Node.js 20+ 与 pnpm\n\n## 常用命令\n\n| 命令 | 说明 |\n|---|---|\n| \\`pnpm start -q <QQ号>\\` | 单账号启动（走自建宿主） |\n| \\`pnpm napuketto config init\\` | 重新生成默认配置 |\n| \\`pnpm napuketto supervisor\\` | 多账号模式（按 \\`napuketto.toml\\` 的 \\`accounts\\`） |\n\n## 目录\n\n- \\`napuketto.toml\\` — 全局配置（QQ 号、OneBot 端口、token 等，修改后重启生效）\n- QQ 数据（账号目录/日志/缓存）默认在 \\`~/.napuketto/\\`\n\n## 升级\n\n\\`\\`\\`bash\npnpm update @napuketto/cli\n\\`\\`\\`\n`;\n}\n\n/** 生成 .gitignore（用户项目）。 */\nconst GITIGNORE = `node_modules/\ndist/\n*.log\nnapuketto-data/\n`;\n\n/**\n * 生成 NapukettoQQ 项目骨架到当前目录下的 <dirName>/。\n * 目标目录已存在且非空 → 抛错（提示换名字或先清空）。\n */\nexport async function scaffoldProject(dirName: string): Promise<ScaffoldResult> {\n    const name = validateProjectName(dirName);\n    const packageName = derivePackageName(name);\n    const dir = path.resolve(process.cwd(), name);\n\n    // 目录已存在且非空 → 拒绝（避免覆盖用户文件）\n    let existing: string[] = [];\n    try {\n        existing = await readdir(dir);\n    } catch {\n        // 目录不存在，可直接创建\n    }\n    if (existing.length > 0) {\n        throw new Error(`目录已存在且非空：${dir}\\n请换一个文件夹名，或先清空该目录。`);\n    }\n\n    await mkdir(dir, { recursive: true });\n    await writeFile(path.join(dir, \"package.json\"), packageJsonTemplate(packageName), \"utf8\");\n    await writeFile(path.join(dir, \"napuketto.toml\"), tomlTemplate(), \"utf8\");\n    await writeFile(path.join(dir, \"readme.md\"), readmeTemplate(name), \"utf8\");\n    await writeFile(path.join(dir, \".gitignore\"), GITIGNORE, \"utf8\");\n\n    return { dir, packageName };\n}\n","#!/usr/bin/env node\n\n/**\n * create-napukettoqq 入口（2026-08-07）。\n *\n * 用法：\n *   create-napukettoqq                # 交互问部署文件夹名（默认 NapukettoQQ）\n *   create-napukettoqq my-bot         # 位置参数指定文件夹名，跳过交互\n *\n * 在当前目录下生成 NapukettoQQ 机器人项目骨架（package.json / napuketto.toml /\n * readme.md / .gitignore），随后打印下一步指引（pnpm install && pnpm start）。\n */\n\nimport process from \"node:process\";\nimport { createInterface } from \"node:readline/promises\";\nimport { DEFAULT_PROJECT_NAME, scaffoldProject } from \"./scaffold.js\";\n\n/** 交互询问部署文件夹名（回车取默认值）。 */\nasync function askProjectName(): Promise<string> {\n    const rl = createInterface({ input: process.stdin, output: process.stdout });\n    try {\n        const answer = await rl.question(`? 部署文件夹名（默认 ${DEFAULT_PROJECT_NAME}）: `);\n        return answer.trim() || DEFAULT_PROJECT_NAME;\n    } finally {\n        rl.close();\n    }\n}\n\n/** 打印生成结果与下一步指引（功能输出，不经日志框架）。 */\nfunction printNextSteps(dir: string): void {\n    console.log(\"\\n========================================\");\n    console.log(\"  NapukettoQQ 项目已生成\");\n    console.log(`  位置：${dir}`);\n    console.log(\"========================================\");\n    console.log(\"下一步：\");\n    console.log(`  cd ${dir}`);\n    console.log(\"  pnpm install\");\n    console.log(\"  pnpm start -q <你的QQ号>\");\n    console.log(\"\");\n    console.log(\"前置要求：本机已安装 QQ NT（wrapper.node 来自 QQ 安装目录）。\");\n    console.log(\"详细说明见项目内 readme.md 与 napuketto.toml。\");\n}\n\nasync function main(): Promise<void> {\n    const dirArg = process.argv[2];\n    const dirName = dirArg ?? (await askProjectName());\n    const result = await scaffoldProject(dirName);\n    printNextSteps(result.dir);\n}\n\nmain().catch((err: unknown) => {\n    const message = err instanceof Error ? err.message : String(err);\n    console.error(`创建失败：${message}`);\n    process.exitCode = 1;\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/scaffold.ts","../src/index.ts"],"sourcesContent":["/**\n * create-napukettoqq 脚手架核心：模板渲染 + 目标目录创建 + 文件写入。\n *\n * 模板为独立文件（templates/ 目录，运行时读取），不硬编码在源码里；\n * 需要插值的占位符用 {{key}} 标记（见 renderTemplate）。\n * 依赖极轻（node:fs/promises / node:os / node:path / node:process）。\n * 生成的用户项目依赖发布版的 @napuketto/cli，用户 install 后经 cli → loader\n * 自建宿主启动。\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { mkdir, readdir, readFile, rm, writeFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\nimport process from \"node:process\";\n\n/** 模板目录（相对本文件：src 与 dist 都在包根下，../templates 均指向包根/templates）。 */\nconst TEMPLATES = new URL(\"../templates/\", import.meta.url);\n\n/**\n * 生成的用户项目所依赖的 @napuketto/cli 版本范围。\n * 运行时从脚手架自身 package.json 读取（dependencies[\"@napuketto/cli\"]）——\n * 发版时 changesets 升版本 + pnpm publish 把 workspace:* 替换为实际版本，\n * 模板版本自动跟随，无需手动同步（比硬编码常量可靠）。\n */\nexport function cliVersionRange(): string {\n    try {\n        const ownPkg = JSON.parse(\n            readFileSync(new URL(\"../package.json\", import.meta.url), \"utf8\"),\n        ) as { dependencies?: Record<string, string> };\n        const range = ownPkg.dependencies?.[\"@napuketto/cli\"];\n        // workspace:* 仅在本地 monorepo 直跑脚手架时出现（发布后 pnpm 替换为实际版本），\n        // 此时兜底默认范围，避免生成的用户项目 install 失败\n        if (range !== undefined && range !== \"workspace:*\") {\n            return range;\n        }\n    } catch {\n        // package.json 缺失（异常环境）→ 兜底默认范围\n    }\n    return \"^0.0.1\";\n}\n\n/** 默认部署文件夹名（用户交互回车缺省值）。 */\nexport const DEFAULT_PROJECT_NAME = \"NapukettoQQ\";\n\n/** 用户可用的包管理器（npm_config_user_agent 检测）。 */\nexport type PackageManager = \"pnpm\" | \"yarn\" | \"npm\";\n\n/**\n * 由 npm_config_user_agent 检测调用方包管理器（yarn create / npm create /\n * pnpm create 都会注入该变量）。兜底 pnpm（项目生态，或直接 node 运行）。\n */\nexport function detectPackageManager(): PackageManager {\n    // noPropertyAccessFromIndexSignature：process.env 是索引签名，必须括号访问\n    const ua = process.env[\"npm_config_user_agent\"] ?? \"\";\n    if (ua.startsWith(\"yarn/\")) {\n        return \"yarn\";\n    }\n    if (ua.startsWith(\"npm/\")) {\n        return \"npm\";\n    }\n    return \"pnpm\";\n}\n\n/** Windows 下包管理器 bin 需带 .cmd 后缀（CreateProcess 不认无扩展名 shim）。 */\nexport function pmBin(pm: PackageManager): string {\n    return process.platform === \"win32\" ? `${pm}.cmd` : pm;\n}\n\n/** Windows 路径非法字符（项目文件夹名校验用）。 */\nconst ILLEGAL_NAME = /[\\\\/:*?\"<>|]/;\n\n/** 脚手架生成结果。 */\nexport interface ScaffoldResult {\n    /** 目标目录绝对路径。 */\n    dir: string;\n    /** 派生出的 npm 包名（小写、空格 → -）。 */\n    packageName: string;\n}\n\n/** 校验文件夹名：非空、非 . / ..、不含 Windows 非法字符。 */\nexport function validateProjectName(raw: string): string {\n    const name = raw.trim();\n    if (name === \"\" || name === \".\" || name === \"..\") {\n        throw new Error(\"文件夹名不能为空或为 . / ..\");\n    }\n    if (ILLEGAL_NAME.test(name)) {\n        throw new Error(`文件夹名含非法字符：${name}（不允许 \\\\ / : * ? \" < > |）`);\n    }\n    return name;\n}\n\n/** 由文件夹名派生 npm 包名（小写、空格 → -）。 */\nexport function derivePackageName(dirName: string): string {\n    return dirName.toLowerCase().replace(/\\s+/g, \"-\");\n}\n\n/** 解析目标目录绝对路径（校验名称后，基于 cwd）。 */\nexport function resolveTargetDir(dirName: string): string {\n    return path.resolve(process.cwd(), validateProjectName(dirName));\n}\n\n/** 目标目录状态：不存在 / 空 / 非空。 */\nexport type DirStatus = \"missing\" | \"empty\" | \"nonempty\";\n\n/** 检测目标目录状态（供交互层决定是否询问清空）。 */\nexport async function checkDirStatus(dir: string): Promise<DirStatus> {\n    let entries: string[] = [];\n    try {\n        entries = await readdir(dir);\n    } catch {\n        return \"missing\";\n    }\n    return entries.length === 0 ? \"empty\" : \"nonempty\";\n}\n\n/** 清空目录内容（保留目录本身）。 */\nexport async function emptyDir(dir: string): Promise<void> {\n    for (const entry of await readdir(dir)) {\n        await rm(path.join(dir, entry), { recursive: true, force: true });\n    }\n}\n\n/** 读取模板文件（templates/ 目录，UTF-8）。 */\nfunction readTemplate(file: string): Promise<string> {\n    return readFile(new URL(file, TEMPLATES), \"utf8\");\n}\n\n/**\n * 占位符渲染：把 {{key}} 替换为 vars[key]。\n * 模板中出现未提供的占位符 → 抛错（防漏插值写出半成品）。\n */\nfunction renderTemplate(content: string, vars: Record<string, string>): string {\n    return content.replace(/\\{\\{(\\w+)\\}\\}/g, (match, key: string) => {\n        const value = vars[key];\n        if (value === undefined) {\n            throw new Error(`模板占位符未提供：{{${key}}}（模板 ${match} 无法渲染）`);\n        }\n        return value;\n    });\n}\n\n/**\n * 生成 NapukettoQQ 项目骨架到当前目录下的 <dirName>/。\n * 目标目录已存在且非空：overwrite=false → 抛错；overwrite=true → 清空后生成。\n * 模板与写入目标一一对应（同文件名）。\n */\nexport async function scaffoldProject(dirName: string, overwrite = false): Promise<ScaffoldResult> {\n    const name = validateProjectName(dirName);\n    const packageName = derivePackageName(name);\n    const dir = resolveTargetDir(name);\n\n    const status = await checkDirStatus(dir);\n    if (status === \"nonempty\" && !overwrite) {\n        throw new Error(`目录已存在且非空：${dir}\\n请换一个文件夹名，或先清空该目录。`);\n    }\n    if (status === \"nonempty\") {\n        await emptyDir(dir);\n    }\n\n    // 渲染变量：dataDir 用 JSON.stringify 转义反斜杠 → TOML 基本字符串合法写法\n    const vars: Record<string, string> = {\n        packageName,\n        cliVersion: cliVersionRange(),\n        dataDir: JSON.stringify(path.join(homedir(), \".napuketto\")),\n    };\n    // 用户项目是「运行壳」：不开发代码，只需 package.json（依赖 + start）+ napuketto.toml（配置）\n    // 模板文件为 templates/<name>.tmpl（.tmpl 后缀避免 TOML/JSON 语言服务把占位符当非法语法）\n    const files = [\"package.json\", \"napuketto.toml\"];\n\n    await mkdir(dir, { recursive: true });\n    for (const file of files) {\n        const rendered = renderTemplate(await readTemplate(`${file}.tmpl`), vars);\n        await writeFile(path.join(dir, file), rendered, \"utf8\");\n    }\n\n    return { dir, packageName };\n}\n","#!/usr/bin/env node\n\n/**\n * create-napukettoqq 入口（2026-08-07 美化 v3，交互层用 @clack/prompts——\n * 现代脚手架交互标准，create-vue / create-turbo 同款）。\n *\n * 用法：\n *   create-napukettoqq                # intro + 交互问部署文件夹名（默认 NapukettoQQ）\n *   create-napukettoqq my-bot         # 位置参数指定文件夹名，跳过命名交互\n *   create-napukettoqq my-bot -f      # 目标目录非空时强制清空覆盖\n *   create-napukettoqq -y             # 全默认（命名用默认值、启动询问用默认 Y）\n *   create-napukettoqq -h             # 打印帮助\n *\n * 流程：intro → 问文件夹名 → 目标目录准备（非空需确认清空）→ spinner 生成骨架\n *   （package.json / napuketto.toml / readme.md / .gitignore）→ 用调用方包管理器\n *   自动 install → 询问是否现在启动（默认 Y）→ 前台运行 → outro 收尾。\n */\n\nimport { spawn } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport { relative } from \"node:path\";\nimport process from \"node:process\";\nimport { cancel, confirm, intro, isCancel, log, outro, spinner, text } from \"@clack/prompts\";\nimport {\n    checkDirStatus,\n    DEFAULT_PROJECT_NAME,\n    detectPackageManager,\n    pmBin,\n    resolveTargetDir,\n    scaffoldProject,\n    validateProjectName,\n} from \"./scaffold.js\";\n\n/** CLI 参数解析结果。 */\ninterface CliOptions {\n    /** 位置参数：部署文件夹名（可选）。 */\n    name?: string;\n    /** -f/--forced：目标目录非空时强制清空覆盖。 */\n    forced: boolean;\n    /** -y/--yes：跳过所有交互提示（使用默认值）。 */\n    yes: boolean;\n    /** -h/--help：显示帮助。 */\n    help: boolean;\n}\n\n/** 帮助文本（-h/--help）。 */\nconst HELP = `  用法: create-napukettoqq [name] [选项]\n\n  选项:\n    -f, --forced   目标目录非空时强制清空并覆盖\n    -y, --yes      跳过所有交互提示（使用默认值）\n    -h, --help     显示本帮助\n`;\n\n/** 解析命令行参数（flag 仅三个，手写保持自包含，不引 yargs-parser）。 */\nfunction parseArgs(argv: string[]): CliOptions {\n    const opts: CliOptions = { forced: false, yes: false, help: false };\n    for (const arg of argv) {\n        if (arg === \"-f\" || arg === \"--forced\") {\n            opts.forced = true;\n        } else if (arg === \"-y\" || arg === \"--yes\") {\n            opts.yes = true;\n        } else if (arg === \"-h\" || arg === \"--help\") {\n            opts.help = true;\n        } else if (arg.startsWith(\"-\")) {\n            throw new Error(`未知参数：${arg}`);\n        } else if (opts.name === undefined) {\n            opts.name = arg;\n        } else {\n            throw new Error(`多余的位置参数：${arg}`);\n        }\n    }\n    return opts;\n}\n\n/** 读取脚手架自身版本号（intro 显示；dist 场景 import.meta.url 指向包内）。 */\nfunction readVersion(): string {\n    try {\n        const ownPkg = JSON.parse(\n            readFileSync(new URL(\"../package.json\", import.meta.url), \"utf8\"),\n        ) as { version?: string };\n        return ownPkg.version ?? \"0.0.0\";\n    } catch {\n        // package.json 缺失（异常环境）→ 兜底\n        return \"0.0.0\";\n    }\n}\n\n/** 交互询问部署文件夹名（回车取默认值；-y 直接返回默认值）。 */\nasync function askProjectName(yes: boolean): Promise<string> {\n    if (yes) {\n        return DEFAULT_PROJECT_NAME;\n    }\n    const name = await text({\n        message: \"部署文件夹名\",\n        placeholder: DEFAULT_PROJECT_NAME,\n        initialValue: DEFAULT_PROJECT_NAME,\n        validate: (input: string | undefined) => {\n            try {\n                validateProjectName(input ?? \"\");\n                return undefined;\n            } catch (err) {\n                return err instanceof Error ? err.message : String(err);\n            }\n        },\n    });\n    if (isCancel(name)) {\n        cancel(\"操作已取消\");\n        process.exit(0);\n    }\n    return validateProjectName(name);\n}\n\n/** 询问是否移除现有文件并继续（目标目录非空时）。 */\nasync function confirmRemove(dirName: string): Promise<boolean> {\n    const ok = await confirm({\n        message: `目录 \"${dirName}\" 已存在且非空，移除现有文件并继续？`,\n        initialValue: false,\n    });\n    if (isCancel(ok)) {\n        cancel(\"操作已取消\");\n        process.exit(0);\n    }\n    return ok;\n}\n\n/** 询问是否现在启动（默认 Y；-y 直接返回 true）。 */\nasync function askStartNow(yes: boolean): Promise<boolean> {\n    if (yes) {\n        return true;\n    }\n    const ok = await confirm({\n        message: \"是否现在启动？\",\n        initialValue: true,\n    });\n    if (isCancel(ok)) {\n        cancel(\"操作已取消\");\n        process.exit(0);\n    }\n    return ok;\n}\n\n/** 前台执行命令（stdio 继承，用户可见进度/交互），返回退出码。 */\nfunction runInteractive(bin: string, args: string[], cwd: string): Promise<number> {\n    return new Promise((resolve) => {\n        // Windows 下 .cmd shim 需 shell:true（CreateProcess 不能直接执行 .cmd）\n        const child = spawn(bin, args, {\n            cwd,\n            stdio: \"inherit\",\n            windowsHide: false,\n            shell: process.platform === \"win32\",\n        });\n        child.on(\"exit\", (code) => {\n            resolve(code ?? 0);\n        });\n    });\n}\n\nasync function main(): Promise<void> {\n    const opts = parseArgs(process.argv.slice(2));\n    if (opts.help) {\n        console.log(HELP);\n        return;\n    }\n\n    // intro：顶边框 + 名称 + 版本\n    intro(`create-napukettoqq  v${readVersion()}`);\n\n    const dirName = opts.name ?? (await askProjectName(opts.yes));\n    const targetDir = resolveTargetDir(dirName);\n\n    // 目标目录准备：非空需确认清空（-f 跳过确认；-y 不隐式清空，保持默认安全语义）\n    let overwrite = false;\n    if ((await checkDirStatus(targetDir)) === \"nonempty\") {\n        if (!opts.forced) {\n            log.warn(`目标目录 \"${dirName}\" 已存在且非空。`);\n            overwrite = await confirmRemove(dirName);\n            if (!overwrite) {\n                outro(\"已取消，未做任何修改。\");\n                return;\n            }\n        } else {\n            overwrite = true;\n        }\n    }\n\n    // 生成骨架（spinner 进度）\n    const s = spinner();\n    s.start(`正在生成项目骨架 ${dirName} ...`);\n    const result = await scaffoldProject(dirName, overwrite);\n    s.stop(`项目骨架已生成：${dirName}`);\n    log.success(`位置：${result.dir}`);\n\n    // 自动安装依赖（用调用方包管理器）\n    const pm = detectPackageManager();\n    log.info(`包管理器：${pm}（自动检测）`);\n    log.info(\"前置要求：本机已安装 QQ NT（wrapper.node 来自 QQ 安装目录）。\");\n    log.info(`正在安装依赖（${pm} install）...`);\n    const installCode = await runInteractive(pmBin(pm), [\"install\"], result.dir);\n    if (installCode !== 0) {\n        log.error(`依赖安装失败（退出码 ${installCode}）。请手动执行：`);\n        log.step(`cd ${result.dir}`);\n        log.step(`${pm} install`);\n        outro(\"创建失败，请手动安装后重试。\");\n        process.exitCode = 1;\n        return;\n    }\n\n    // 询问是否现在启动（默认 Y → 前台运行）\n    if (await askStartNow(opts.yes)) {\n        log.info(\"正在启动 NapukettoQQ（Ctrl+C 停止）...\\n\");\n        const startCode = await runInteractive(pmBin(pm), [\"start\"], result.dir);\n        if (startCode !== 0) {\n            process.exitCode = startCode;\n        }\n    } else {\n        log.message(\"你可以稍后这样启动：\");\n        if (targetDir !== process.cwd()) {\n            const related = relative(process.cwd(), targetDir);\n            log.step(`cd ${related}`);\n        }\n        log.step(`${pm} start -q <你的QQ号>`);\n        log.message(\"配置说明见项目内 napuketto.toml。\");\n    }\n\n    outro(\"完成。\");\n}\n\nmain().catch((err: unknown) => {\n    const message = err instanceof Error ? err.message : String(err);\n    log.error(`创建失败：${message}`);\n    process.exitCode = 1;\n});\n"],"mappings":"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"}

package/package.json

@@ -1,15 +1,20 @@
 {
   "name": "create-napukettoqq",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "一键生成 NapukettoQQ 机器人项目（yarn/pnpm/npm create napukettoqq）",
   "type": "module",
   "files": [
-    "dist"
+    "dist",
+    "templates"
   ],
   "main": "./dist/index.mjs",
   "bin": {
     "create-napukettoqq": "./dist/index.mjs"
   },
+  "dependencies": {
+    "@clack/prompts": "^1.7.0",
+    "@napuketto/cli": "0.0.2"
+  },
   "devDependencies": {
     "tsdown": "^0.22.14"
   },

package/templates/napuketto.toml.tmpl

@@ -0,0 +1,78 @@
+# ============================================================
+# NapukettoQQ 全局配置文件（由 create-napukettoqq 生成）
+# ============================================================
+# 数据（账号目录/日志/缓存/QQ 数据）不在此文件，按数据根组织：
+#   优先级：--data-dir <dir> > NAPKETTO_DATA 环境变量 > ~/.napuketto
+# 配置文件路径解析：NAPKETTO_CONFIG > 项目根探测 > cwd > 数据根兜底。
+#
+# 单账号启动每次读取本文件；修改后重启生效。
+
+# ------------------------------------------------------------
+# 基础配置
+# ------------------------------------------------------------
+
+dataDir = {{dataDir}}
+
+# 数据根目录：账号目录/日志/缓存/QQ 数据存放位置（绝对路径）
+# 多账号（supervisor）模式下，账号进程崩溃是否自动重启
+autoRestart = true
+
+# 崩溃后自动重启的延迟（毫秒）
+restartDelayMs = 2000
+
+# 多账号列表（留空 = 单账号模式：启动后自动快速登录/扫码）
+# [[accounts]]
+# qq = "123456"          # QQ 号（必填）
+# enabled = true         # 是否启用（可选，缺省 true）
+
+# ------------------------------------------------------------
+# OneBot 11 协议段
+# ------------------------------------------------------------
+[onebot11]
+
+# 鉴权 token（全局默认）：HTTP/WS 连接必须携带。
+#   校验方式：Authorization: Bearer <token> / 裸 token / URL 参数 ?access_token=<token>
+#   每个网络实例可单独覆盖（见下文各实例的 token 字段）。
+#   留空 = 不鉴权（仅本机调试推荐）。
+# token = ""
+
+# 心跳 meta 事件间隔（毫秒）；0 = 关闭心跳事件
+heartbeatInterval = 3000
+
+# 是否上报机器人自己发的消息（OB11 规范默认不上报）
+reportSelfMessage = false
+
+# 消息内容格式：array = 消息段数组（标准 OneBot 11），string = CQ 码字符串
+messagePostFormat = "array"
+
+# ---- HTTP 反向服务器（接收第三方 POST 指令），可配置多个 ----
+[[onebot11.httpServers]]
+enabled = true
+host = "127.0.0.1" # 监听地址；0.0.0.0 = 监听所有网卡（局域网可连）
+port = 3000
+# token = "abc"          # 可选：覆盖全局 token
+
+# ---- HTTP 正向上报（Webhook：把事件 POST 到第三方地址），可配置多个 ----
+# [[onebot11.httpPostUrls]]
+# enabled = true
+# url = "http://127.0.0.1:8080/onebot"   # 第三方接收地址
+# token = "abc"                          # 可选：覆盖全局 token
+# timeoutMs = 5000                       # 可选：上报超时（毫秒），缺省不超时
+
+# ---- WS 反向服务器（外部 WS 客户端主动连入），可配置多个 ----
+[[onebot11.wsServers]]
+enabled = true
+host = "127.0.0.1"
+port = 3001
+# token = "abc"                          # 可选：覆盖全局 token
+# heartbeatInterval = 30000              # 可选：WS ping 间隔（毫秒）
+
+# ---- WS 正向客户端（主动连接外部 WS，双向），可配置多个 ----
+# [[onebot11.wsReverseUrls]]
+# enabled = true
+# url = "ws://127.0.0.1:8081/ws"         # 第三方 WS 地址（ws:// 或 wss://）
+# token = "abc"                          # 可选：覆盖全局 token
+# reconnectDelayMs = 5000                # 可选：断线重连延迟（毫秒）
+# maxReconnectAttempts = 10              # 可选：最大重连次数（缺省无限）
+# rejectUnauthorized = true              # 可选：wss:// 是否校验证书（自签证书设 false）
+# heartbeatInterval = 30000              # 可选：WS ping 间隔（毫秒）

package/templates/package.json.tmpl

@@ -0,0 +1,13 @@
+{
+    "name": "{{packageName}}",
+    "version": "0.0.1",
+    "private": true,
+    "type": "module",
+    "description": "NapukettoQQ 机器人项目（OneBot 11）",
+    "scripts": {
+        "start": "napuketto"
+    },
+    "dependencies": {
+        "@napuketto/cli": "{{cliVersion}}"
+    }
+}