create-koishi-ce 1.2.1 → 1.3.0

package/README.md

@@ -0,0 +1,77 @@
+# create-koishi-ce
+
+**简体中文** | [English](#english)
+
+Koishi CE 生态的项目脚手架。一条命令生成以 Bun 为运行时、纯 `@koishi-ce` 依赖的完整机器人项目：预装常用插件、钉住上游包名 alias、预写分组配置，开箱即可 `koishi start`。
+
+```bash
+bunx create-koishi-ce my-app
+# 或
+npm create koishi-ce my-app
+```
+
+## 选项
+
+| 选项 | 默认值 | 说明 |
+| --- | --- | --- |
+| `[名称]` | 交互询问（初始值 koishi-app） | 项目名，同时作为目标目录名 |
+| `-t, --template <名称>` | 内置模板 | 改用 npm registry 上的远程模板包（逃生舱） |
+| `-r, --ref <引用>` | latest | 远程模板的版本引用 |
+| `-f, --forced` | - | 强制清空目标目录 |
+| `-g, --git` | - | 初始化 git 仓库（分支取 init.defaultBranch，未配置则 main） |
+| `--registry <地址>` | 参数 > npm_config_registry > .npmrc > 官方源 | npm registry |
+| `-p, --prod` | - | 生产模式：删除模板的 workspaces 与 devDependencies |
+| `-y, --yes` | - | 跳过全部询问（含跳过依赖安装） |
+
+交互流程：项目名；目标目录非空时确认是否清空；最后确认是否立即安装依赖并启动（包管理器一律使用 Bun）。
+
+## 生成的项目
+
+- **package.json**：`type: module`、`packageManager` 钉 Bun、workspaces 含 `plugins/*` 与 `external/*`；dependencies 预装全套 `@koishi-ce` 常用插件（console、config、market、auth、admin、help、sandbox 等），并预置四行 npm alias 钉住上游名——`koishi` / `@koishijs/core` / `@koishijs/loader` 指向 `@koishi-ce/koishi-shim`、`@koishijs/plugin-console` 指向 `@koishi-ce/console-shim`，社区插件由此全部解析到 CE 框架；
+- **koishi.yml**：按 server（端口 5140-5149）/ basic / console（自动打开、市场指向 registry.koishi.chat 镜像）/ storage / adapter / develop（开发模式启用热重载）分组预写；官方 adapter / database 插件以 `~` 停用条目预写，可按需启用；
+- **开发工具链**：devDependencies 预置 `@koishi-ce/client`、`@koishi-ce/plugin-hmr` 与 `@koishi-ce/scripts`（`koishi-scripts setup` 可在 external/ 下继续创建插件项目）。
+
+不预装任何 adapter 与 database——官方版本可后续从市场安装，peer 已被 alias 钉住不会形成双实例。
+
+## 许可证
+
+[MIT](https://github.com/Koishi-CE/koishi/blob/main/LICENSE)，本仓库原创作品，版权归 Koishi-CE 贡献者，见 [NOTICE](https://github.com/Koishi-CE/koishi/blob/main/NOTICE)。
+
+---
+
+## English
+
+The project scaffold for the Koishi CE ecosystem. One command generates a complete bot project on the Bun runtime with pure `@koishi-ce` dependencies: common plugins preinstalled, upstream-name aliases pinned, grouped config prewritten — ready for `koishi start` out of the box.
+
+```bash
+bunx create-koishi-ce my-app
+# or
+npm create koishi-ce my-app
+```
+
+## Options
+
+| Option | Default | Description |
+| --- | --- | --- |
+| `[name]` | prompted (initial koishi-app) | Project name, also the target directory |
+| `-t, --template <name>` | built-in template | Use a remote template package from the npm registry (escape hatch) |
+| `-r, --ref <ref>` | latest | Version ref of the remote template |
+| `-f, --forced` | - | Force-clean the target directory |
+| `-g, --git` | - | Initialize a git repository (branch from init.defaultBranch, fallback main) |
+| `--registry <url>` | arg > npm_config_registry > .npmrc > official | npm registry |
+| `-p, --prod` | - | Production mode: drop workspaces and devDependencies from the template |
+| `-y, --yes` | - | Skip all prompts (including dependency installation) |
+
+Interactive flow: project name; confirm cleaning a non-empty target directory; confirm installing dependencies and starting right away (Bun is always the package manager).
+
+## Generated project
+
+- **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, 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 / database plugins are prewritten as `~`-disabled entries.
+- **Toolchain** — devDependencies include `@koishi-ce/client`, `@koishi-ce/plugin-hmr` and `@koishi-ce/scripts` (`koishi-scripts setup` scaffolds further plugin projects under external/).
+
+No adapter or database is preinstalled — official ones can be installed from the market later; their peers are already pinned by the aliases.
+
+## License
+
+[MIT](https://github.com/Koishi-CE/koishi/blob/main/LICENSE), original work of this repository, copyright Koishi-CE contributors — see [NOTICE](https://github.com/Koishi-CE/koishi/blob/main/NOTICE).

package/lib/bin.mjs

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

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-CwJZjC5d.mjs";
+import { a as start, i as renderManifest, n as getLocalRegistry, r as readNpmrcRegistry, t as detectAgent } from "./src-DiZgIQu5.mjs";
 export { detectAgent, getLocalRegistry, readNpmrcRegistry, renderManifest, start };

package/lib/{src-CwJZjC5d.mjs → src-DiZgIQu5.mjs}

@@ -1,17 +1,18 @@
 import { spawnSync } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { basename, join, relative } from "node:path";
+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 { fileURLToPath } from "node:url";
 //#region package.json
 var package_default = {
 	name: "create-koishi-ce",
 	description: "Setup a Koishi application",
-	version: "1.2.1",
+	version: "1.3.0",
 	type: "module",
 	main: "./lib/index.mjs",
 	module: "./lib/index.mjs",
@@ -62,98 +63,57 @@ var package_default = {
 };
 //#endregion
 //#region src/template.ts
-/** 模板静态文件（相对项目根的路径 → 文件内容），package.json 另行渲染 */
-const templateFiles = {
-	".env": [
-		"GITHUB_MIRROR = https://ghproxy.com/https://github.com",
-		"GITHUB_CONTENT_MIRROR = https://ghproxy.com/https://raw.githubusercontent.com",
-		"GRAVATAR_MIRROR = https://cravatar.cn"
-	].join("\n"),
-	".gitignore": ["node_modules/", "data/"].join("\n"),
-	"koishi.yml": [
-		"plugins:",
-		"  group:server:",
-		"    server:",
-		"      port: 5140",
-		"      maxPort: 5149",
-		"  group:basic:",
-		"    ~admin: {}",
-		"    ~bind: {}",
-		"    commands: {}",
-		"    help: {}",
-		"    http: {}",
-		"    ~inspect: {}",
-		"    locales: {}",
-		"    proxy-agent: {}",
-		"  group:console:",
-		"    actions: {}",
-		"    ~analytics: {}",
-		"    ~auth: {}",
-		"    config: {}",
-		"    console:",
-		"      open: true",
-		"    explorer: {}",
-		"    insight: {}",
-		"    logger: {}",
-		"    market:",
-		"      search:",
-		"        endpoint: https://registry.koishi.chat/index.json",
-		"    notifier: {}",
-		"    oobe: {}",
-		"    sandbox: {}",
-		"    status: {}",
-		"  group:develop:",
-		"    $if: env.NODE_ENV === 'development'",
-		"    hmr:",
-		"      root: ."
-	].join("\n"),
-	"tsconfig.json": [
-		"{",
-		"  \"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\"]",
-		"}"
-	].join("\n"),
-	"README.md": `# Koishi 机器人项目
-
-由 \`bun create koishi-ce\` 生成，运行于 [@koishi-ce 社区再分发版](https://github.com/Koishi-CE/koishi) 生态。
-
-## 环境要求
-
-- [Bun](https://bun.sh) ≥ 1.2（运行时：koishi CLI 与插件加载链以 Bun 为准）
-
-## 快速开始
-
-\`\`\`bash
-bun install
-bun run start        # 启动（生产模式）
-bun run dev          # 启动（开发模式，启用 HMR 热更新）
-\`\`\`
-
-启动后访问控制台：<http://127.0.0.1:5140>
-
-## 安装插件
-
-推荐在控制台「插件市场」页安装（已预配 registry.koishi.chat 镜像源）；也可以手动 \`bun add <包名>\` 后在 \`koishi.yml\` 中启用。
-
-上游官方 adapter（如 adapter-discord / adapter-telegram）、数据库插件（如 database-sqlite）与社区 koishi-plugin-* 插件均可直接安装：根依赖中的四行 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 副本。analytics 等依赖数据库的插件请先安装数据库插件，再去掉配置中对应的 \`~\` 前缀启用。
-
-## 自定义插件
-
-在 \`plugins/\` 目录下创建插件包（可用 \`bun run new <名称>\` 生成骨架），在 \`koishi.yml\` 中以相对路径引用（如 \`./plugins/my-plugin\`）即可启用；Bun 直接加载 TypeScript 源码，无需预编译。
-`
+/**
+* 内置项目模板（create-koishi-ce 的默认模板）。
+*
+* 历史包袱修正：本脚手架最初直接下载上游官方 @koishijs/boilerplate 解包
+* 生成项目，产物依赖全是 npm 官方包（koishi / @koishijs/*），完全绕开了
+* 本仓的 @koishi-ce 再分发生态（官方 market 还带 Bun 下必炸的 get-registry）。
+* 默认模板改为内置的纯 @koishi-ce 依赖集；确需上游官方模板时用
+* --template <包名> 走 npm 远程下载（见 index.ts 的 scaffoldRemote）。
+*
+* 模板的静态文本一律放在 src/template/ 下的真实文件里（本模块只负责
+* 定位与读取，不再内嵌字符串常量）。npm 包的 files 含 src，因此 lib
+* 产物与 src 直跑两种形态都能按相对路径定位到模板目录。
+*
+* 模板要点：
+* - 运行时 Bun：koishi CLI（@koishi-ce/koishi 的 bin）与 loader 插件加载链
+*   均以 Bun 为准（ESM-only 产物，Bun 原生加载 TS / yml）；脚本里的环境
+*   变量注入直接写 `NODE_ENV=... ` 前缀——bun run 走 Bun Shell，跨平台
+*   原生支持，无需 cross-env 一类的依赖；
+* - "koishi" 裸名与 @koishijs/core / @koishijs/loader / @koishijs/plugin-console
+*   上游名用 npm alias 钉到 @koishi-ce shim（版本冻结线，见 packages/shim）：
+*   上游官方 adapter / database 插件与社区 koishi-plugin-* 的 peer 由此满足，
+*   不会拉入 npm 官方全家桶形成第二份框架副本；市场安装亦不改写该声明
+*   （installer 的 isGuardedRequest 护栏将 npm:@koishi-ce alias 与
+*   workspace: 同等保护）；
+* - koishi.yml 对齐官方实例的预写策略：控制台与基础插件全量预装（依赖
+*   数据库的保持 ~ 禁用）；本仓不再分发的 adapter / database 官方插件只以
+*   ~ 禁用条目预写、不预装——loader 跳过禁用条目，装好后在控制台启用；
+* - 依赖版本统一 ^1.0.0 区间（安装时取最新 1.x），shim 版本例外（冻结线）。
+*/
+/**
+* 定位内置模板目录：src 直跑（开发 / 测试）与 lib 产物（npm 消费）两种
+* 形态各按相对路径探测（发布包 files 含 src，lib 同级的 ../src/template
+* 恒存在）。
+*/
+function locateTemplateDir() {
+	const base = dirname(fileURLToPath(import.meta.url));
+	for (const dir of [join(base, "template"), join(base, "../src/template")]) if (existsSync(dir)) return dir;
+	throw new Error("create-koishi-ce 内置模板目录缺失（src/template）");
+}
+const templateDir = locateTemplateDir();
+/**
+* 无点前缀的模板源文件名 → 生成项目中的目标路径。点开头文件会被 npm
+* 发布规则与各路工具的特殊处理波及（.env 恒不入包、嵌套 .gitignore 会被
+* git 当真），模板目录里一律存无点文件名。
+*/
+const dotFiles = {
+	env: ".env",
+	gitignore: ".gitignore"
 };
+/** 模板静态文件（相对项目根的路径 → 文件内容），package.json 另行渲染 */
+const templateFiles = Object.fromEntries(readdirSync(templateDir).filter((file) => !file.startsWith(".")).map((file) => [dotFiles[file] ?? file, readFileSync(join(templateDir, file), "utf8")]));
 /**
 * 内置模板的 package.json 基础内容（name/version 会被 renderManifest 覆写，
 * prod 模式下 workspaces 与 devDependencies 会被移除）。
@@ -161,10 +121,11 @@ bun run dev          # 启动（开发模式，启用 HMR 热更新）
 function baseManifest() {
 	return {
 		type: "module",
+		packageManager: `bun@${Bun.version}`,
 		workspaces: ["plugins/*", "external/*"],
 		scripts: {
 			start: "koishi start",
-			dev: "cross-env NODE_ENV=development koishi start",
+			dev: "NODE_ENV=development koishi start",
 			new: "koishi-scripts setup"
 		},
 		dependencies: {
@@ -172,11 +133,13 @@ function baseManifest() {
 			"@koishi-ce/plugin-actions": "^1.0.0",
 			"@koishi-ce/plugin-admin": "^1.0.0",
 			"@koishi-ce/plugin-analytics": "^1.0.0",
+			"@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-commands": "^1.0.0",
 			"@koishi-ce/plugin-config": "^1.0.0",
 			"@koishi-ce/plugin-console": "^1.0.0",
+			"@koishi-ce/plugin-dataview": "^1.0.0",
 			"@koishi-ce/plugin-explorer": "^1.0.0",
 			"@koishi-ce/plugin-help": "^1.0.0",
 			"@koishi-ce/plugin-http": "^1.0.0",
@@ -188,9 +151,12 @@ function baseManifest() {
 			"@koishi-ce/plugin-notifier": "^1.0.0",
 			"@koishi-ce/plugin-oobe": "^1.0.0",
 			"@koishi-ce/plugin-proxy-agent": "^1.0.0",
+			"@koishi-ce/plugin-rate-limit": "^1.0.0",
 			"@koishi-ce/plugin-sandbox": "^1.0.0",
 			"@koishi-ce/plugin-server": "^1.0.0",
+			"@koishi-ce/plugin-server-temp": "^1.0.0",
 			"@koishi-ce/plugin-status": "^1.0.0",
+			"@koishi-ce/plugin-theme-vanilla": "^1.0.0",
 			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",
@@ -200,8 +166,7 @@ function baseManifest() {
 			"@koishi-ce/client": "^1.0.0",
 			"@koishi-ce/plugin-hmr": "^1.0.0",
 			"@koishi-ce/scripts": "^1.0.0",
-			"bun-types": "^1.4.0",
-			"cross-env": "^7.0.3"
+			"bun-types": "^1.4.0"
 		}
 	};
 }

package/package.json

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

package/src/__tests__/manifest.test.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import { expect, test } from "bun:test";
 import { detectAgent, type Manifest, renderManifest } from "../index.ts";
 

package/src/__tests__/registry.test.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import { expect, test } from "bun:test";
 import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";

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

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import { afterAll, beforeAll, describe, expect, it, mock } from "bun:test";
 import { spawnSync } from "node:child_process";
 import {

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

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import { afterAll, beforeAll, describe, expect, it } from "bun:test";
 
 /**

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

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import { afterAll, beforeAll, describe, expect, it, mock } from "bun:test";
 import {
 	existsSync,

package/src/__tests__/template.test.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 import { expect, test } from "bun:test";
 import { renderManifest } from "../index.ts";
 import { baseManifest, templateFiles } from "../template.ts";
@@ -15,12 +18,23 @@ test("内置模板依赖纯度：不含任何 @koishijs / koishi-plugin 官方
 	for (const key of Object.keys(dependencies ?? {})) {
 		expect(guarded.has(key) || key.startsWith("@koishi-ce/")).toBe(true);
 	}
-	const toolchain = new Set(["bun-types", "cross-env"]);
 	for (const key of Object.keys(devDependencies ?? {})) {
-		expect(key.startsWith("@koishi-ce/") || toolchain.has(key)).toBe(true);
+		expect(key === "bun-types" || key.startsWith("@koishi-ce/")).toBe(true);
 	}
 });
 
+test("内置模板 packageManager 钉 Bun，脚本用 Bun Shell 环境变量前缀", () => {
+	const manifest = baseManifest();
+	const { scripts } = manifest as unknown as {
+		scripts: Record<string, string>;
+	};
+	// 本项目只支持 Bun 运行时：packageManager 形如 bun@1.x.y
+	expect(manifest["packageManager"] ?? "").toMatch(/^bun@\d+\.\d+\.\d+/);
+	// cross-env 已移除：bun run 走 Bun Shell，环境变量前缀天然跨平台
+	expect(scripts["dev"]).toBe("NODE_ENV=development koishi start");
+	expect(JSON.stringify(manifest)).not.toContain("cross-env");
+});
+
 test("内置模板以 npm alias 钉住 koishi 裸名，版本保持 4.18.x 冻结线", () => {
 	const request = baseManifest().dependencies?.["koishi"];
 	expect(typeof request).toBe("string");
@@ -59,8 +73,40 @@ test("内置模板静态文件齐备，koishi.yml 预配 market 镜像源", () =
 	expect(templateFiles["koishi.yml"]).toContain(
 		"endpoint: https://registry.koishi.chat/index.json",
 	);
-	// 模板不预装数据库，依赖数据库的插件保持 ~ 禁用
-	expect(templateFiles["koishi.yml"]).toContain("~analytics");
+});
+
+test("koishi.yml 预写策略对齐官方实例：CE 插件装而禁用，官方 adapter/database 只写不装", () => {
+	const yml = templateFiles["koishi.yml"] ?? "";
+	// 依赖数据库 / 暂无需启用的 CE 插件：预装但 ~ 禁用
+	for (const name of [
+		"~admin",
+		"~bind",
+		"~analytics",
+		"~auth",
+		"~dataview",
+		"~rate-limit",
+		"~inspect",
+		"~server-temp",
+	]) {
+		expect(yml).toContain(name);
+	}
+	// 无需数据库即可工作的 CE 插件：直接启用
+	for (const name of ["assets-local", "theme-vanilla", "status", "sandbox"]) {
+		expect(yml).toContain(name);
+	}
+	// 官方 adapter / database 只以 ~ 禁用条目预写（未预装，市场装后启用）
+	for (const name of [
+		"~adapter-discord",
+		"~adapter-telegram",
+		"~adapter-qq",
+		"~database-sqlite",
+		"~database-postgres",
+	]) {
+		expect(yml).toContain(name);
+	}
+	// 模板依赖里不得出现官方 adapter / database 包名（只预写不预装）
+	expect(JSON.stringify(baseManifest())).not.toContain("adapter-");
+	expect(JSON.stringify(baseManifest())).not.toContain("database-");
 });
 
 test("renderManifest 渲染内置模板：常规改写生效，prod 模式保留 koishi alias", () => {
@@ -69,6 +115,7 @@ test("renderManifest 渲染内置模板：常规改写生效，prod 模式保留
 	expect(output.private).toBe(true);
 	expect(output.version).toBe("0.0.0");
 	expect(output.scripts.start).toBe("koishi start");
+	expect(output.packageManager).toMatch(/^bun@/);
 	expect(output.dependencies.koishi).toBe(
 		"npm:@koishi-ce/koishi-shim@^4.18.11",
 	);

package/src/bin.ts

@@ -1,4 +1,7 @@
 #!/usr/bin/env bun
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * create-koishi-ce 的 CLI 可执行入口：shebang 由 rolldown 原样保留到
  * lib/bin.mjs，package.json 的 bin 字段指向它（范式同 @koishi-ce/scripts）。

package/src/index.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * create-koishi-ce 脚手架（npm 包名 create-koishi-ce，目录名为
  * apps/koishi-create，二者不一致是历史遗留，以目录名为准）。

package/src/template/README.md

@@ -0,0 +1,32 @@
+# Koishi 机器人项目
+
+由 `bun create koishi-ce` 生成，运行于 [@koishi-ce 社区再分发版](https://github.com/Koishi-CE/koishi) 生态。
+
+## 环境要求
+
+- [Bun](https://bun.sh) ≥ 1.2（本项目唯一支持的运行时与包管理器：koishi CLI 与插件加载链均以 Bun 为准）
+
+## 快速开始
+
+```bash
+bun install
+bun run start        # 启动（生产模式）
+bun run dev          # 启动（开发模式，启用 HMR 热更新）
+```
+
+启动后访问控制台：<http://127.0.0.1:5140>
+
+## 预装与预写
+
+- **已预装**：基础与控制台插件（@koishi-ce 全家桶）。其中依赖数据库的（admin / bind / analytics / auth / dataview / rate-limit 等）与暂无需启用的（inspect / server-temp）在 `koishi.yml` 中以 `~` 前缀保持禁用——安装并启用任一数据库插件后，去掉对应 `~` 即可。
+- **只预写、未预装**：adapter（discord / telegram / qq …）与数据库（sqlite / mongo / postgres …）官方插件以 `~` 禁用条目预写在 `koishi.yml` 的 `group:adapter` / `group:storage`——loader 会跳过禁用条目，不安装也能正常启动；需要时在控制台「插件市场」搜索安装，回到配置页点击启用即可。
+
+## 安装插件
+
+推荐在控制台「插件市场」页安装（已预配 registry.koishi.chat 镜像源）；也可以手动 `bun add <包名>` 后在 `koishi.yml` 中启用。
+
+根依赖中的四行 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 副本。
+
+## 自定义插件
+
+在 `plugins/` 目录下创建插件包（可用 `bun run new <名称>` 生成骨架），在 `koishi.yml` 中以相对路径引用（如 `./plugins/my-plugin`）即可启用；Bun 直接加载 TypeScript 源码，无需预编译。

package/src/template/env

@@ -0,0 +1,3 @@
+GITHUB_MIRROR = https://ghproxy.com/https://github.com
+GITHUB_CONTENT_MIRROR = https://ghproxy.com/https://raw.githubusercontent.com
+GRAVATAR_MIRROR = https://cravatar.cn

package/src/template/gitignore

@@ -0,0 +1,3 @@
+node_modules/
+data/
+temp/

package/src/template/koishi.yml

@@ -0,0 +1,65 @@
+plugins:
+  group:server:
+    server:
+      port: 5140
+      maxPort: 5149
+    ~server-temp: {}
+  group:basic:
+    ~admin: {}
+    ~bind: {}
+    commands: {}
+    help: {}
+    http: {}
+    ~inspect: {}
+    locales: {}
+    proxy-agent: {}
+    ~rate-limit: {}
+  group:console:
+    actions: {}
+    ~analytics: {}
+    ~auth: {}
+    config: {}
+    console:
+      open: true
+    ~dataview: {}
+    explorer: {}
+    insight: {}
+    logger: {}
+    market:
+      search:
+        endpoint: https://registry.koishi.chat/index.json
+    notifier: {}
+    oobe: {}
+    sandbox: {}
+    status: {}
+    theme-vanilla: {}
+  group:storage:
+    ~database-mongo:
+      database: koishi
+    ~database-mysql:
+      database: koishi
+    ~database-postgres:
+      database: koishi
+    ~database-sqlite:
+      path: data/koishi.db
+    assets-local: {}
+  group:adapter:
+    ~adapter-dingtalk: {}
+    ~adapter-discord: {}
+    ~adapter-kook: {}
+    ~adapter-lark: {}
+    ~adapter-line: {}
+    ~adapter-mail: {}
+    ~adapter-matrix: {}
+    ~adapter-qq: {}
+    ~adapter-satori: {}
+    ~adapter-slack: {}
+    ~adapter-telegram: {}
+    ~adapter-wechat-official: {}
+    ~adapter-wecom: {}
+    ~adapter-whatsapp: {}
+    ~adapter-zulip: {}
+  group:develop:
+    $if: env.NODE_ENV === 'development'
+    hmr:
+      root: .

package/src/template/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "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"]
+}

package/src/template.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2026-present Koishi-CE contributors.
+
 /**
  * 内置项目模板（create-koishi-ce 的默认模板）。
  *
@@ -7,115 +10,66 @@
  * 默认模板改为内置的纯 @koishi-ce 依赖集；确需上游官方模板时用
  * --template <包名> 走 npm 远程下载（见 index.ts 的 scaffoldRemote）。
  *
+ * 模板的静态文本一律放在 src/template/ 下的真实文件里（本模块只负责
+ * 定位与读取，不再内嵌字符串常量）。npm 包的 files 含 src，因此 lib
+ * 产物与 src 直跑两种形态都能按相对路径定位到模板目录。
+ *
  * 模板要点：
  * - 运行时 Bun：koishi CLI（@koishi-ce/koishi 的 bin）与 loader 插件加载链
- *   均以 Bun 为准（ESM-only 产物，Bun 原生加载 TS / yml）；
- * - "koishi" 裸名与 @koishijs/core / @koishijs/loader 上游名用 npm alias
- *   钉到 @koishi-ce/koishi-shim（4.18.x 冻结线，见 packages/shim/koishi-shim）：
- *   上游官方 adapter / database 插件与社区
- *   koishi-plugin-* 的 peer `koishi ^4.x` 等由此满足，不会拉入 npm 官方
- *   koishi 形成第二份框架副本；市场安装亦不改写该声明（installer 的
- *   isGuardedRequest 护栏将 npm:@koishi-ce alias 与 workspace: 同等保护）；
- * - 本仓没有 adapter / database 插件的再分发，模板不预装这两类；依赖数据库
- *   的插件（如 analytics）在 koishi.yml 中保持 ~ 禁用，待用户从市场安装
- *   数据库插件后再启用；
+ *   均以 Bun 为准（ESM-only 产物，Bun 原生加载 TS / yml）；脚本里的环境
+ *   变量注入直接写 `NODE_ENV=... ` 前缀——bun run 走 Bun Shell，跨平台
+ *   原生支持，无需 cross-env 一类的依赖；
+ * - "koishi" 裸名与 @koishijs/core / @koishijs/loader / @koishijs/plugin-console
+ *   上游名用 npm alias 钉到 @koishi-ce shim（版本冻结线，见 packages/shim）：
+ *   上游官方 adapter / database 插件与社区 koishi-plugin-* 的 peer 由此满足，
+ *   不会拉入 npm 官方全家桶形成第二份框架副本；市场安装亦不改写该声明
+ *   （installer 的 isGuardedRequest 护栏将 npm:@koishi-ce alias 与
+ *   workspace: 同等保护）；
+ * - koishi.yml 对齐官方实例的预写策略：控制台与基础插件全量预装（依赖
+ *   数据库的保持 ~ 禁用）；本仓不再分发的 adapter / database 官方插件只以
+ *   ~ 禁用条目预写、不预装——loader 跳过禁用条目，装好后在控制台启用；
  * - 依赖版本统一 ^1.0.0 区间（安装时取最新 1.x），shim 版本例外（冻结线）。
  */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import type { Manifest } from "./index.ts";
 
-/** 模板静态文件（相对项目根的路径 → 文件内容），package.json 另行渲染 */
-export const templateFiles: Record<string, string> = {
-	".env": [
-		"GITHUB_MIRROR = https://ghproxy.com/https://github.com",
-		"GITHUB_CONTENT_MIRROR = https://ghproxy.com/https://raw.githubusercontent.com",
-		"GRAVATAR_MIRROR = https://cravatar.cn",
-	].join("\n"),
-	".gitignore": ["node_modules/", "data/"].join("\n"),
-	"koishi.yml": [
-		"plugins:",
-		"  group:server:",
-		"    server:",
-		"      port: 5140",
-		"      maxPort: 5149",
-		"  group:basic:",
-		"    ~admin: {}",
-		"    ~bind: {}",
-		"    commands: {}",
-		"    help: {}",
-		"    http: {}",
-		"    ~inspect: {}",
-		"    locales: {}",
-		"    proxy-agent: {}",
-		"  group:console:",
-		"    actions: {}",
-		"    ~analytics: {}",
-		"    ~auth: {}",
-		"    config: {}",
-		"    console:",
-		"      open: true",
-		"    explorer: {}",
-		"    insight: {}",
-		"    logger: {}",
-		"    market:",
-		"      search:",
-		"        endpoint: https://registry.koishi.chat/index.json",
-		"    notifier: {}",
-		"    oobe: {}",
-		"    sandbox: {}",
-		"    status: {}",
-		"  group:develop:",
-		"    $if: env.NODE_ENV === 'development'",
-		"    hmr:",
-		"      root: .",
-	].join("\n"),
-	"tsconfig.json": [
-		"{",
-		'  "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"]',
-		"}",
-	].join("\n"),
-	"README.md": `# Koishi 机器人项目
-
-由 \`bun create koishi-ce\` 生成，运行于 [@koishi-ce 社区再分发版](https://github.com/Koishi-CE/koishi) 生态。
-
-## 环境要求
-
-- [Bun](https://bun.sh) ≥ 1.2（运行时：koishi CLI 与插件加载链以 Bun 为准）
-
-## 快速开始
-
-\`\`\`bash
-bun install
-bun run start        # 启动（生产模式）
-bun run dev          # 启动（开发模式，启用 HMR 热更新）
-\`\`\`
-
-启动后访问控制台：<http://127.0.0.1:5140>
-
-## 安装插件
-
-推荐在控制台「插件市场」页安装（已预配 registry.koishi.chat 镜像源）；也可以手动 \`bun add <包名>\` 后在 \`koishi.yml\` 中启用。
-
-上游官方 adapter（如 adapter-discord / adapter-telegram）、数据库插件（如 database-sqlite）与社区 koishi-plugin-* 插件均可直接安装：根依赖中的四行 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 副本。analytics 等依赖数据库的插件请先安装数据库插件，再去掉配置中对应的 \`~\` 前缀启用。
+/**
+ * 定位内置模板目录：src 直跑（开发 / 测试）与 lib 产物（npm 消费）两种
+ * 形态各按相对路径探测（发布包 files 含 src，lib 同级的 ../src/template
+ * 恒存在）。
+ */
+function locateTemplateDir(): string {
+	const base = dirname(fileURLToPath(import.meta.url));
+	for (const dir of [join(base, "template"), join(base, "../src/template")]) {
+		if (existsSync(dir)) return dir;
+	}
+	throw new Error("create-koishi-ce 内置模板目录缺失（src/template）");
+}
 
-## 自定义插件
+const templateDir = locateTemplateDir();
 
-在 \`plugins/\` 目录下创建插件包（可用 \`bun run new <名称>\` 生成骨架），在 \`koishi.yml\` 中以相对路径引用（如 \`./plugins/my-plugin\`）即可启用；Bun 直接加载 TypeScript 源码，无需预编译。
-`,
+/**
+ * 无点前缀的模板源文件名 → 生成项目中的目标路径。点开头文件会被 npm
+ * 发布规则与各路工具的特殊处理波及（.env 恒不入包、嵌套 .gitignore 会被
+ * git 当真），模板目录里一律存无点文件名。
+ */
+const dotFiles: Record<string, string> = {
+	env: ".env",
+	gitignore: ".gitignore",
 };
 
+/** 模板静态文件（相对项目根的路径 → 文件内容），package.json 另行渲染 */
+export const templateFiles: Record<string, string> = Object.fromEntries(
+	readdirSync(templateDir)
+		.filter((file) => !file.startsWith("."))
+		.map((file) => [
+			dotFiles[file] ?? file,
+			readFileSync(join(templateDir, file), "utf8"),
+		]),
+);
+
 /**
  * 内置模板的 package.json 基础内容（name/version 会被 renderManifest 覆写，
  * prod 模式下 workspaces 与 devDependencies 会被移除）。
@@ -123,10 +77,13 @@ bun run dev          # 启动（开发模式，启用 HMR 热更新）
 export function baseManifest(): Manifest {
 	return {
 		type: "module",
+		// 本项目只用 Bun：钉住创建时的 Bun 版本（bun run 亦据此选择解释器）
+		packageManager: `bun@${Bun.version}`,
 		workspaces: ["plugins/*", "external/*"],
 		scripts: {
 			start: "koishi start",
-			dev: "cross-env NODE_ENV=development koishi start",
+			// bun run 走 Bun Shell，`NODE_ENV=...` 前缀天然跨平台，无需 cross-env
+			dev: "NODE_ENV=development koishi start",
 			new: "koishi-scripts setup",
 		},
 		dependencies: {
@@ -134,11 +91,13 @@ export function baseManifest(): Manifest {
 			"@koishi-ce/plugin-actions": "^1.0.0",
 			"@koishi-ce/plugin-admin": "^1.0.0",
 			"@koishi-ce/plugin-analytics": "^1.0.0",
+			"@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-commands": "^1.0.0",
 			"@koishi-ce/plugin-config": "^1.0.0",
 			"@koishi-ce/plugin-console": "^1.0.0",
+			"@koishi-ce/plugin-dataview": "^1.0.0",
 			"@koishi-ce/plugin-explorer": "^1.0.0",
 			"@koishi-ce/plugin-help": "^1.0.0",
 			"@koishi-ce/plugin-http": "^1.0.0",
@@ -150,9 +109,12 @@ export function baseManifest(): Manifest {
 			"@koishi-ce/plugin-notifier": "^1.0.0",
 			"@koishi-ce/plugin-oobe": "^1.0.0",
 			"@koishi-ce/plugin-proxy-agent": "^1.0.0",
+			"@koishi-ce/plugin-rate-limit": "^1.0.0",
 			"@koishi-ce/plugin-sandbox": "^1.0.0",
 			"@koishi-ce/plugin-server": "^1.0.0",
+			"@koishi-ce/plugin-server-temp": "^1.0.0",
 			"@koishi-ce/plugin-status": "^1.0.0",
+			"@koishi-ce/plugin-theme-vanilla": "^1.0.0",
 			// 上游裸名占位：npm alias 钉到 @koishi-ce 的 koishi shim（勿删，
 			// 语义见文件头注释）；版本必须保持 4.18.x 冻结线以满足 ^4 peer
 			koishi: "npm:@koishi-ce/koishi-shim@^4.18.11",
@@ -173,7 +135,6 @@ export function baseManifest(): Manifest {
 			"@koishi-ce/plugin-hmr": "^1.0.0",
 			"@koishi-ce/scripts": "^1.0.0",
 			"bun-types": "^1.4.0",
-			"cross-env": "^7.0.3",
 		},
 	};
 }