create-lumfall 1.0.1 → 1.1.1

package/README.md

@@ -1,24 +1,33 @@
 # create-lumfall
 
-[lumfall](https://www.npmjs.com/package/lumfall) 应用脚手架：一条命令生成可直接运行的
-完整工程，不用安装依赖后再手动搭目录。
+[lumfall](https://www.npmjs.com/package/lumfall) 应用脚手架：一条命令从 GitHub 拉取模板并生成
+可直接运行的完整工程，不用安装依赖后再手动搭目录。
 
 ```sh
-pnpm create lumfall my-app            # 交互式选择模板
-pnpm create lumfall my-app -t basic   # 基础业务项目
-pnpm create lumfall my-doc -t document # 技术文档站
+pnpm create lumfall my-app                # 交互式选择模板
+pnpm create lumfall my-app -t basic       # 基础业务项目
+pnpm create lumfall my-admin -t business  # B 端全栈管理台
+pnpm create lumfall my-doc -t document    # 技术文档站
 
 # npm / npx 同样可用
 npm create lumfall my-app
-npx create-lumfall my-app -t basic
+npx create-lumfall my-app -t business
 ```
 
 ## 模板
 
-| 模板 | 说明 |
-| --- | --- |
-| `basic` | 基础业务项目：`server.js` / `build.js` / `config/` / `app/` 全套目录约定 + 示例 API 与示例页面（来自 `lumfall-basic-project`） |
-| `document` | 技术文档站：对标 VitePress（导航/侧栏/TOC/搜索/暗色模式），内置 lumfall 技术文档内容（来自 `lumfall-document`） |
+模板内容不在本包内维护，而是在生成时按注册表从 GitHub 拉取（模板仓库更新后
+无需重发本包）：
+
+| 模板 | 说明 | 模板仓库 |
+| --- | --- | --- |
+| `basic` | 基础业务项目：`server.js` / `build.js` / `config/` / `app/` 全套目录约定 + 示例 API 与示例页面 | `ikun-Lg/lumfall-basic-project@main` |
+| `business` | B 端全栈管理台：电商 + 课程双系统、JWT 登录、DSL 驱动菜单（schema/group/sider/iframe 全形态）、通用 CRUD 接口，内置演示数据（admin / 123456） | `ikun-Lg/lumfall-business@master` |
+| `document` | 技术文档站：对标 VitePress（导航/侧栏/TOC/搜索/暗色模式），生成空站后放入自己的内容 | `ikun-Lg/lumfall-document@template/empty` |
+
+拉取策略：优先 codeload `tar.gz`（无需安装 git），失败自动回退 `git clone --depth 1`
+（复用 git 的代理 / 凭据配置）。`--repo <owner/name>` 可覆盖模板仓库来源，用于
+fork、私有镜像或离线自建。
 
 生成后：
 
@@ -31,14 +40,12 @@ pnpm start:prod     # 生产构建 + 启动
 
 脚手架会把模板里的自指名称（package.json / server.js / config 中的应用名）替换为你
 传入的项目名。模板内容与框架版本解耦：模板 `package.json` 里的 `lumfall` 用的是
-semver 范围，安装时取最新发布版。
+semver 范围，安装时取最新发布版。lockfile 不随模板分发（安装时解析最新依赖）。
 
 ## 维护
 
-模板源是本工作区同级的 `lumfall-basic-project/` 与 `lumfall-document/` 两个项目。
-模板内容变更后，在本目录执行：
+模板内容在各模板仓库里维护，本包只保留注册表（`cli.js` 顶部的 `TEMPLATES`）：
 
-```sh
-pnpm sync            # 重新拷贝（自动排除 node_modules / 构建产物 / logs / .git / pnpm-lock.yaml）
-npm publish          # 发布新版
-```
+- 更新模板 → 直接提交推送对应仓库（分支由注册表 `ref` 指定），无需发布本包版本；
+- 新增模板 → 在 `TEMPLATES` 增加一项（key / alias / name / repo / ref / selfName / hint）；
+- 发布本包 → `npm publish`（改动注册表或 CLI 逻辑时）。

package/cli.js

@@ -3,36 +3,63 @@
  * create-lumfall —— lumfall 应用脚手架。
  *
  * 用法：
- *   pnpm create lumfall [项目名] [-t basic|document]
- *   npm create lumfall  [项目名] [-t basic|document]
- *   npx create-lumfall  [项目名] [-t basic|document]
+ *   pnpm create lumfall [项目名] [-t basic|business|document]
+ *   npm create lumfall  [项目名] [-t basic|business|document]
+ *   npx create-lumfall  [项目名] [-t basic|business|document]
  *
- * 零依赖：参数缺省时用 readline 交互补齐；模板内嵌在本包 templates/ 下，
- * 生成即可 pnpm install && pnpm start:dev，不需要手动建目录。
+ * 零依赖：参数缺省时用 readline 交互补齐。
+ *
+ * 模板不内置在 npm 包里，而是按注册表（TEMPLATES，见下）在生成时从 GitHub 拉取：
+ * 优先 codeload tar.gz（无需 git），失败自动回退 `git clone --depth 1`。
+ * 模板仓库更新后无需重发本包；`--repo` 可覆盖为 fork / 私有镜像。
  */
 const fs = require("fs");
 const os = require("os");
 const path = require("path");
+const https = require("https");
 const readline = require("readline");
+const { execFileSync } = require("child_process");
 
+// ── 模板注册表：repo = GitHub owner/name，ref = 分支（可含 /，如 template/empty）──
 const TEMPLATES = [
   {
     key: "basic",
     alias: "b",
     name: "基础业务项目",
     desc: "目录约定 + 示例 API + 示例页面，一般业务从这里起步",
+    repo: "ikun-Lg/lumfall-basic-project",
+    ref: "main",
     selfName: "lumfall-basic-project",
+    hint: "示例页面: http://localhost:3000/view/home（示例 API 在 app/ 下按目录约定组织）",
+  },
+  {
+    key: "business",
+    alias: "biz",
+    name: "B 端全栈管理台（电商 + 课程双系统）",
+    desc: "管理台 SPA + JWT 登录 + DSL 驱动菜单 + schema CRUD，内置双业务系统演示数据",
+    repo: "ikun-Lg/lumfall-business",
+    ref: "master",
+    selfName: "lumfall-business",
+    hint: `管理台: http://localhost:3000/view/admin（默认账号 admin / 123456，普通用户 user / 123456）
+项目列表: http://localhost:3000/view/project-list（顶栏可切换电商 / 课程系统）`,
   },
   {
     key: "document",
     alias: "d",
     name: "技术文档站（空模板）",
     desc: "导航/侧栏/搜索/主题就绪，生成后放入自己的内容即可",
+    repo: "ikun-Lg/lumfall-document",
+    ref: "template/empty",
     selfName: "lumfall-document",
+    hint: "文档站入口: http://localhost:3000/view/docs（站点配置在 app/pages/docs/docs-config.js）",
   },
 ];
 
+// 同步进生成目录时需要剔除的文件（lockfile 不随模板分发，安装时取最新依赖）
+const EXCLUDED_NAMES = new Set(["pnpm-lock.yaml", ".DS_Store", "node_modules", ".git"]);
+
 const NAME_PATTERN = /^[a-z][a-z0-9-_]*$/i;
+const REPO_PATTERN = /^[a-zA-Z0-9_-]+\/[a-zA-Z0-9._-]+$/;
 
 function ask(rl, question) {
   return new Promise((resolve) => rl.question(question, (answer) => resolve(answer.trim())));
@@ -83,14 +110,24 @@ function printHelp() {
   npx create-lumfall [项目名] [选项]
 
 选项:
-  -t, --template <basic|document>   模板类型（basic=基础业务项目, document=技术文档站）
+  -t, --template <${TEMPLATES.map((t) => t.key).join("|")}>
+                                    模板类型
+  -r, --repo <owner/name>           覆盖模板仓库（fork / 私有镜像 / 离线自建）
   -h, --help                        显示帮助
   -v, --version                     显示版本
 
+模板:
+${TEMPLATES.map((t) => `  ${t.key.padEnd(10)} ${t.name} —— ${t.desc}`).join("\n")}
+
+说明:
+  模板在生成时从 GitHub 拉取（${TEMPLATES.map((t) => t.repo).join(", ")}），
+  需要网络；无 git 亦可用（优先走 tar.gz），失败自动回退 git clone。
+
 示例:
   pnpm create lumfall my-app                # 交互式选择模板
-  pnpm create lumfall my-app -t document    # 直接生成文档站
-  npx create-lumfall admin -t basic`);
+  pnpm create lumfall my-app -t business    # 生成 B 端管理台
+  pnpm create lumfall my-doc -t document    # 生成文档站
+  pnpm create lumfall my-app -t basic -r your-name/lumfall-basic-project`);
 }
 
 function resolveTemplate(flagValue) {
@@ -124,9 +161,108 @@ function rewriteSelfName(targetDir, template, projectName) {
   }
 }
 
+// ── 模板拉取 ────────────────────────────────────────────────
+
+/** 跟随重定向下载 URL 到本地文件（最多 5 跳），HTTP 状态非 200 时报错并附响应片段 */
+function downloadFile(url, destFile, redirectsLeft = 5) {
+  return new Promise((resolve, reject) => {
+    const request = https.get(
+      url,
+      { headers: { "user-agent": "create-lumfall", accept: "*/*" }, timeout: 30000 },
+      (response) => {
+        const { statusCode, headers } = response;
+
+        if (statusCode >= 300 && statusCode < 400 && headers.location) {
+          response.resume();
+          if (redirectsLeft <= 0) {
+            reject(new Error(`${url} 重定向次数过多`));
+            return;
+          }
+          const next = new URL(headers.location, url).toString();
+          resolve(downloadFile(next, destFile, redirectsLeft - 1));
+          return;
+        }
+
+        if (statusCode !== 200) {
+          let body = "";
+          response.on("data", (chunk) => {
+            if (body.length < 200) body += chunk.toString();
+          });
+          response.on("end", () => {
+            reject(new Error(`HTTP ${statusCode}${body ? `：${body.trim().slice(0, 160)}` : ""}`));
+          });
+          return;
+        }
+
+        const file = fs.createWriteStream(destFile);
+        response.pipe(file);
+        file.on("finish", () => file.close(() => resolve(destFile)));
+        file.on("error", reject);
+      }
+    );
+    request.on("timeout", () => request.destroy(new Error("请求超时（30s）")));
+    request.on("error", reject);
+  });
+}
+
+/** 解包 tar.gz 到指定目录（依赖系统 tar：macOS/Linux/Win10+ 均自带） */
+function extractTarball(tarballPath, destDir) {
+  fs.mkdirSync(destDir, { recursive: true });
+  execFileSync("tar", ["-xzf", tarballPath, "-C", destDir], { stdio: "pipe" });
+}
+
+/** 从 GitHub 拉取模板到临时目录，返回仓库内容根目录 */
+async function fetchTemplate({ repo, ref, workDir }) {
+  // 方案一：codeload tar.gz（无需 git，包体最小）
+  try {
+    const tarball = path.join(workDir, "template.tar.gz");
+    const url = `https://codeload.github.com/${repo}/tar.gz/refs/heads/${ref}`;
+    log(`  拉取 https://github.com/${repo} (${ref}) ...`);
+    await downloadFile(url, tarball);
+    const extractDir = path.join(workDir, "extract");
+    extractTarball(tarball, extractDir);
+    // tar 包顶层是唯一目录（<repo>-<ref>），其内容才是模板根
+    const topLevel = fs.readdirSync(extractDir).filter((name) => name !== ".DS_Store");
+    if (topLevel.length !== 1) {
+      throw new Error(`tar 包结构异常（顶层 ${topLevel.length} 个目录）`);
+    }
+    return path.join(extractDir, topLevel[0]);
+  } catch (tarballError) {
+    log(`  tar.gz 拉取失败（${tarballError.message}），回退 git clone ...`);
+  }
+
+  // 方案二：git clone（复用 git 的代理 / 凭据配置）
+  const cloneDir = path.join(workDir, "clone");
+  try {
+    execFileSync(
+      "git",
+      ["clone", "--depth", "1", "--branch", ref, `https://github.com/${repo}.git`, cloneDir],
+      { stdio: "pipe" }
+    );
+    return cloneDir;
+  } catch (gitError) {
+    const detail = String(gitError.stderr || gitError.message).trim().split("\n").slice(-2).join(" ");
+    throw new Error(
+      `无法获取模板仓库 ${repo}@${ref}：\n` +
+        `  - 请确认网络可访问 GitHub（或配置 git 代理）\n` +
+        `  - 请确认仓库存在且分支 "${ref}" 已推送\n` +
+        `  - git: ${detail}`
+    );
+  }
+}
+
+/** 把模板内容拷贝到目标目录（剔除 lockfile / 系统文件 / 版本控制目录） */
+function copyTemplate(sourceRoot, targetDir) {
+  fs.mkdirSync(targetDir, { recursive: true });
+  fs.cpSync(sourceRoot, targetDir, {
+    recursive: true,
+    filter: (src) => !EXCLUDED_NAMES.has(path.basename(src)),
+  });
+}
+
 async function main() {
   const argv = process.argv.slice(2);
-  const flags = { template: null };
+  const flags = { template: null, repo: null };
 
   const positional = [];
   for (let i = 0; i < argv.length; i++) {
@@ -143,6 +279,10 @@ async function main() {
       flags.template = argv[++i];
       continue;
     }
+    if (arg === "-r" || arg === "--repo") {
+      flags.repo = argv[++i];
+      continue;
+    }
     if (arg.startsWith("-")) {
       throw new Error(`未知选项 "${arg}"（--help 查看用法）`);
     }
@@ -150,7 +290,9 @@ async function main() {
   }
 
   const prompt = createPrompt();
-  try {    // 1. 项目名
+  let workDir = null;
+  try {
+    // 1. 项目名
     let projectName = positional[0];
     if (!projectName) {
       projectName = await prompt.question("项目名称（用作目录名，如 my-app）: ");
@@ -175,6 +317,15 @@ async function main() {
       }
     }
 
+    // 2.1 --repo 覆盖（fork / 私有镜像 / 离线自建仓库）
+    let repo = template.repo;
+    if (flags.repo) {
+      if (!REPO_PATTERN.test(flags.repo)) {
+        throw new Error(`--repo "${flags.repo}" 不合法：格式为 owner/name`);
+      }
+      repo = flags.repo;
+    }
+
     // 3. 目标目录
     const targetDir = path.resolve(process.cwd(), projectName);
     if (!(await confirmOverwrite(prompt, targetDir))) {
@@ -182,33 +333,37 @@ async function main() {
       return;
     }
 
-    // 4. 拷贝模板 + 重写项目名
-    const templateDir = path.join(__dirname, "templates", template.key);
-    if (!fs.existsSync(templateDir)) {
-      throw new Error(`模板缺失: ${template.key}（包可能未完整发布）`);
+    // 4. 从 GitHub 拉取模板 → 拷贝 → 重写项目名
+    workDir = fs.mkdtempSync(path.join(os.tmpdir(), "create-lumfall-"));
+    const sourceRoot = await fetchTemplate({ repo, ref: template.ref, workDir });
+    copyTemplate(sourceRoot, targetDir);
+
+    if (!fs.existsSync(path.join(targetDir, "server.js"))) {
+      log("⚠ 仓库内容未包含 server.js，可能不是 lumfall 模板仓库，请留意产物。");
     }
-    fs.mkdirSync(path.dirname(targetDir), { recursive: true });
-    fs.cpSync(templateDir, targetDir, { recursive: true });
     rewriteSelfName(targetDir, template, projectName);
 
     log(`
 ✔ 已创建 ${template.name} 项目: ${projectName}
-  模板: ${template.key}    位置: ${path.relative(os.homedir(), targetDir) || targetDir}
+  模板: ${template.key}    仓库: ${repo}@${template.ref}    位置: ${path.relative(os.homedir(), targetDir) || targetDir}
 
 下一步:
   cd ${projectName}
   pnpm install
   pnpm start:dev        # 本地开发（前端 HMR + 服务）
   pnpm start:prod       # 生产构建 + 启动
-${template.key === "document"
-    ? `
-文档站入口: http://localhost:3000/view/docs（站点配置在 app/pages/docs/docs-config.js）`
-    : `
-示例页面: http://localhost:3000/view/home（示例 API 在 app/ 下按目录约定组织）`}
+${template.hint}
 
 详细用法见项目内 README.md。`);
   } finally {
     prompt.close();
+    if (workDir) {
+      try {
+        fs.rmSync(workDir, { recursive: true, force: true });
+      } catch (e) {
+        // 临时目录清理失败不影响结果
+      }
+    }
   }
 }
 

package/package.json

@@ -1,25 +1,23 @@
 {
   "name": "create-lumfall",
-  "version": "1.0.1",
-  "description": "lumfall 应用脚手架：一条命令生成可运行的基础业务项目或技术文档站（pnpm create lumfall my-app）",
+  "version": "1.1.1",
+  "description": "lumfall 应用脚手架：一条命令从 GitHub 拉取并生成基础业务项目 / B 端管理台 / 技术文档站（pnpm create lumfall my-app）",
   "bin": {
     "create-lumfall": "cli.js"
   },
   "files": [
     "cli.js",
-    "templates/",
     "README.md"
   ],
-  "scripts": {
-    "sync": "node scripts/sync-templates.js"
-  },
   "keywords": [
     "lumfall",
     "create",
     "scaffold",
+    "template",
     "koa",
     "vue",
-    "fullstack"
+    "fullstack",
+    "admin"
   ],
   "author": "lggbond",
   "license": "ISC",

package/templates/basic/README.md

@@ -1,113 +0,0 @@
-# lumfall-basic-project
-
-基于 [lumfall](https://www.npmjs.com/package/lumfall) 的基础业务项目骨架。
-克隆或复制本目录，重命名后即可开始业务开发，不必从零搭建工程。
-
-## 目录结构
-
-```text
-lumfall-basic-project/
-├── server.js                  # 服务端入口：serviceStart()
-├── build.js                   # 前端构建入口：frontendBuild(_ENV)
-├── package.json
-├── config/
-│   ├── config.default.js      # 全环境基础配置
-│   ├── config.local.js        # _ENV=local 覆盖（可选）
-│   ├── config.beta.js         # _ENV=beta 覆盖（可选）
-│   └── config.prod.js         # _ENV=prod 覆盖（可选）
-└── app/
-    ├── middleware.js          # 业务全局中间件注册入口
-    ├── middleware/            # 可复用中间件 → app.middlewares.<dir>.<name>
-    ├── controller/            # 示例：demo.js → app.controllers.demo
-    ├── service/               # 示例：demo.js → app.services.demo
-    ├── router/                # 路由注册（URL → controller 方法）
-    ├── router-schema/         # API 参数 JSON Schema（Ajv 校验）
-    ├── extend/                # 扩展点：返回值直接挂到 app 上
-    ├── pages/
-    │   └── home/              # 示例页面，访问 /view/home
-    │       ├── entry.home.js  # 页面入口（命名必须是 entry.<page-name>.js）
-    │       └── home.vue
-    └── webpack.config.js      # Webpack 扩展配置（与框架配置 merge.smart 合并）
-```
-
-框架通过 npm 依赖 `lumfall` 引入，业务代码只写在本目录，不要修改
-`node_modules/lumfall` 里的框架本体。
-
-## 常用命令
-
-```sh
-pnpm install                  # 安装依赖
-
-pnpm start:dev                # 本地开发：webpack dev server（HMR）+ 服务
-pnpm build:prod && pnpm prod  # 生产构建 + 启动
-pnpm new-page user-list       # 新建页面 app/pages/user-list/，访问 /view/user-list
-pnpm new-page user-list --header  # 新建页面并套用框架的 HeaderContainer 布局
-```
-
-环境由 `_ENV` 区分（`local` / `beta` / `prod`，缺省 `local`），不是 `NODE_ENV`。
-
-## 示例包含什么
-
-骨架自带一套最小但完整的示例，覆盖最常见的开发路径：
-
-| 内容 | 位置 | 说明 |
-| --- | --- | --- |
-| 页面 | `app/pages/home/` | 访问 `/view/home`，演示 `$lumfallCurl` 调接口、Arco 组件 |
-| 读配置的接口 | `GET /api/demo/info` | 返回 `config` 合并结果，改 `config.<env>.js` 即可看到变化 |
-| 分页列表接口 | `GET /api/demo/note/list` | 演示 query 参数 + router-schema 校验 |
-| 创建接口 | `POST /api/demo/note` | 演示 body 参数 + 校验失败返回 code 442 |
-
-新增一个 API 只需四步：`app/service/xxx.js` → `app/controller/xxx.js` →
-`app/router/xxx.js` → `app/router-schema/xxx.js`，目录与挂载约定见下表。
-
-## 目录约定与挂载点
-
-文件 / 目录名用 `kebab-case` 或 `snake_case`，加载后自动转 `camelCase`。
-
-| 业务目录 | 导出约定 | 挂载结果 |
-| --- | --- | --- |
-| `app/middleware/**/*.js` | `(app) => (ctx, next) => {}` | `app.middlewares.<dir>.<name>` |
-| `app/controller/**/*.js` | `(app) => class` | `app.controllers.<dir>.<name>`，启动时实例化 |
-| `app/service/**/*.js` | `(app) => class` | `app.services.<dir>.<name>`，启动时实例化 |
-| `app/extend/**/*.js` | `(app) => object` | 直接挂到 `app`，例如 `app.logger` |
-| `app/router/**/*.js` | `(app, router) => {}` | 注册路由到 `app.router` |
-| `app/router-schema/**/*.js` | schema 对象或 `(app) => map` | 合并进 `app.routerSchema` |
-
-controller / service 继承基类后可用：`this.services`（= `app.services`）、
-`this.config`（= `app.config`，仅请求阶段读取），以及统一响应
-`this.success(ctx, data, metadata)` / `this.fail(ctx, message, code)`。
-
-## 配置
-
-四层浅合并，后者覆盖前者同名键：
-
-```text
-框架 config.default -> 业务 config.default -> 框架 config.<env> -> 业务 config.<env>
-```
-
-- 需要强约束时在 `server.js` 传 `configSchema`（JSON Schema），不匹配直接启动失败
-- 需要强校验时同样可传 `lifecycle`（启动/停止 hook）、`plugins`（数据库等前置能力）、
-  `monitoring`（请求级观测），用法见框架文档
-
-## 常见注意点
-
-1. 服务与构建都必须在本目录（业务根目录 = `process.cwd()`）下执行
-2. 业务代码里取业务路径用 `app.businessPath`，不要用 `__dirname`
-3. `frontendBuild` 只认 `_ENV=local`（webpack dev server）和 `_ENV=prod`（产物构建）
-4. 完全未命中路由会 302 到 `server.js` 里配置的 `homePath`
-5. `/health/live`、`/health/ready` 是框架内置健康检查；业务依赖探针通过
-   `app/extend/` 注册到 `app.health`
-6. 生产环境建议开启 `config.security.apiSignature` 并把 `secret` 放到环境变量
-7. 框架共享依赖（`vue`、`@arco-design/web-vue`、`vue-router`、`pinia`、
-   `@babel/runtime`、`lodash`、`axios` 等）可直接 import，由框架
-   `resolve.alias` 白名单解析（需要 lumfall ≥ 1.1.1），无需重复安装，
-   运行时也只有一份实例。白名单之外的库先 `pnpm add xxx` 再使用；
-   `_` 与 `axios` 另有 webpack 全局注入，页面代码不 import 也能用
-
-## 下一步
-
-- 需要 B 端管理台（登录、Dashboard、Schema 组件、菜单管理）时，参考同工作区的
-  `lumfall-business/`，它演示了 `model/`（Dashboard 的 Model + Project 配置）、
-  schema 表格/表单/搜索栏等开箱组件的用法
-- 需要技术文档站模板时，参考同工作区的 `lumfall-document/`
-- 框架完整能力（安全策略、生命周期、插件、诊断清单等）见 lumfall 技术文档

package/templates/basic/app/controller/demo.js

@@ -1,28 +0,0 @@
-// 示例 controller：演示「工厂返回 class、继承 Controller.Base」的约定。
-// 文件名 demo.js + 无子目录 → 挂载到 app.controllers.demo
-module.exports = (app) => {
-  const BaseController = require("lumfall").Controller.Base(app);
-
-  return class DemoController extends BaseController {
-    // 通过 this.services（= app.services）在请求阶段取 service，安全
-    async getInfo(ctx) {
-      const { demo: demoService } = this.services;
-      await this.success(ctx, demoService.getInfo());
-    }
-
-    async getNoteList(ctx) {
-      const { demo: demoService } = this.services;
-      const { data, total, page, size } = demoService.getNoteList({
-        page: Number(ctx.request.query.page) || 1,
-        size: Number(ctx.request.query.pageSize) || 10,
-      });
-      await this.success(ctx, data, { total, page, size });
-    }
-
-    async createNote(ctx) {
-      const { demo: demoService } = this.services;
-      const note = demoService.createNote(ctx.request.body);
-      await this.success(ctx, note);
-    }
-  };
-};

package/templates/basic/app/extend/README.md

@@ -1,3 +0,0 @@
-// 扩展点目录：每个文件导出 (app) => object，返回值直接挂到 app 上。
-// 例如文件 cache.js 导出 (app) => ({ get, set })，即可通过 app.cache 使用。
-// 框架已占用：app.logger、app.health、app.env 等，重名会被跳过并告警。

package/templates/basic/app/middleware/README.md

@@ -1,2 +0,0 @@
-// 可复用中间件目录：每个文件导出 (app) => (ctx, next) => {}，
-// 自动挂载到 app.middlewares.<目录名>.<文件名>（kebab/snake-case 自动转 camelCase）。

package/templates/basic/app/middleware.js

@@ -1,13 +0,0 @@
-// 业务全局中间件注册入口。
-// 执行时机在框架全局中间件之后（static → nunjucks → bodyParser → errorHandler
-// → monitoring → apiParamsVerify → securityPolicy），因此这里注册的中间件
-// 位于框架中间件链的内层。
-// 可复用中间件放在 app/middleware/ 目录，会自动挂到 app.middlewares.<dir>.<name>。
-module.exports = (app) => {
-  // 示例：简单请求日志（生产观测更推荐 serviceStart 的 monitoring 配置）
-  // app.use(async (ctx, next) => {
-  //   const start = Date.now();
-  //   await next();
-  //   console.log(`${ctx.method} ${ctx.path} ${ctx.status} ${Date.now() - start}ms`);
-  // });
-};

package/templates/basic/app/pages/home/entry.home.js

@@ -1,4 +0,0 @@
-import boot from "$lumfallBoot";
-import Home from "./home.vue";
-
-boot(Home);