@yuer678/create-kb 0.3.0 → 0.3.1

package/README.md

@@ -0,0 +1,36 @@
+# @yuer678/create-kb
+
+> [kb-ui](https://github.com/anyuer678/kb-ui) 脚手架 CLI：**7 种项目模板**一键创建，CLI 命令名仍是 `create-kb`。
+
+> ⚠️ npm 上的 `create-kb`（无 scope）是**同名无关项目**，本包因此发布为 scoped 名 `@yuer678/create-kb`。
+
+## 使用
+
+```bash
+npx @yuer678/create-kb my-app                     # 交互式选择模板
+npx @yuer678/create-kb my-api --template api      # 直接指定模板（7 选 1）
+npx @yuer678/create-kb my-app --no-git -p npm     # 不初始化 git / 指定包管理器
+```
+
+## 模板
+
+| 模板 | 说明 |
+|------|------|
+| `base` | 最小可用 Vue 3 + Vite + TS 前端 |
+| `starter` | 带完整组件示例的前端（预装 [kb-ui-vue](https://www.npmjs.com/package/kb-ui-vue)） |
+| `api` | Express + TypeScript + Zod 后端（源码与 [@yuer678/kb-api](https://www.npmjs.com/package/@yuer678/kb-api) 同步，含 supertest 测试） |
+| `fullstack` | Vue 前端 + Express API + Docker Compose 一键起 |
+| `electron` | Electron 桌面应用骨架（安全模型 + 打包） |
+| `react` | React 19 + Vite 前端 |
+| `ai` | LLM 工作台（OpenAI 兼容 + SSE 流式 + 聊天前端） |
+
+## 相关包
+
+- [`kb-ui-vue`](https://www.npmjs.com/package/kb-ui-vue) —— Vue 3 组件库（73 组件 / 46 主题）
+- [`@yuer678/kb-utils`](https://www.npmjs.com/package/@yuer678/kb-utils) —— 通用 TS 工具函数库
+- [`@yuer678/kb-api`](https://www.npmjs.com/package/@yuer678/kb-api) —— 参考后端（模板内后端与其同源同步）
+- 仓库：<https://github.com/anyuer678/kb-ui>
+
+## License
+
+MIT

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
+import { createRequire as createRequire2 } from "module";
 import { Command } from "commander";
 
 // src/prompts.ts
@@ -81,9 +82,9 @@ function templatesRoot() {
   return join(__dirname, "../templates");
 }
 function kbVersion() {
-  const require2 = createRequire(import.meta.url);
+  const require3 = createRequire(import.meta.url);
   try {
-    const pkg = require2("kb-ui-vue/package.json");
+    const pkg = require3("kb-ui-vue/package.json");
     return pkg.version;
   } catch {
     console.warn('\u26A0 \u672A\u8BFB\u53D6\u5230 kb-ui-vue \u7248\u672C\uFF0C\u6A21\u677F\u5C06\u4F7F\u7528 "latest" \u4F5C\u4E3A\u4F9D\u8D56\u7248\u672C');
@@ -164,8 +165,10 @@ async function createProject(options) {
 }
 
 // src/index.ts
+var require2 = createRequire2(import.meta.url);
+var ownVersion = require2("../package.json").version ?? "unknown";
 var program = new Command();
-program.name("create-kb").description("\u521B\u5EFA\u4E00\u4E2A\u9884\u88C5 @kb/ui \u7684 Vue 3 + Vite + TypeScript \u9879\u76EE").version("0.1.0").argument("[project-name]", "\u9879\u76EE\u540D\u79F0").option("--template <template>", "\u6A21\u677F\uFF1Abase\uFF08\u6700\u5C0F\uFF09| starter\uFF08\u5B8C\u6574\u793A\u4F8B\uFF09", "base").option("--no-git", "\u4E0D\u521D\u59CB\u5316 git \u4ED3\u5E93").option("-p, --package-manager <pm>", "\u5305\u7BA1\u7406\u5668\uFF1Apnpm | npm | yarn", "pnpm").action(async (projectName) => {
+program.name("create-kb").description("\u521B\u5EFA\u4E00\u4E2A\u9884\u88C5 kb-ui-vue \u7684 Vue 3 + Vite + TypeScript \u9879\u76EE").version(ownVersion).argument("[project-name]", "\u9879\u76EE\u540D\u79F0").option("--template <template>", "\u6A21\u677F\uFF1Abase\uFF08\u6700\u5C0F\uFF09| starter\uFF08\u5B8C\u6574\u793A\u4F8B\uFF09| api\uFF08\u540E\u7AEF\uFF09| fullstack\uFF08\u5168\u6808\uFF09| electron\uFF08\u684C\u9762\uFF09| react | ai\uFF08LLM \u5DE5\u4F5C\u53F0\uFF09", "base").option("--no-git", "\u4E0D\u521D\u59CB\u5316 git \u4ED3\u5E93").option("-p, --package-manager <pm>", "\u5305\u7BA1\u7406\u5668\uFF1Apnpm | npm | yarn", "pnpm").action(async (projectName) => {
   const cliOptions = program.opts();
   if (projectName !== void 0) {
     const result = validateProjectName(projectName);

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@yuer678/create-kb",
-  "version": "0.3.0",
+  "version": "0.3.1",
+  "description": "kb-ui 脚手架 CLI：7 种项目模板（Vue3 前端 / Express 后端 / 全栈 / Electron / React / LLM 工作台）一键创建",
   "license": "MIT",
   "author": "anyuer678",
   "repository": {
@@ -26,7 +27,7 @@
   "dependencies": {
     "commander": "^15.0.0",
     "prompts": "^2.4.2",
-    "kb-ui-vue": "0.4.0"
+    "kb-ui-vue": "0.4.1"
   },
   "devDependencies": {
     "@types/node": "^26.6.1",

package/templates/api/src/app.ts

@@ -1,6 +1,7 @@
 /* eslint-disable */
 // ⚠️ 自动生成文件，请勿直接修改。
 // 源：packages/api/src —— 改动请改源文件后运行 `pnpm sync:api-template`。
+import { createRequire } from 'node:module'
 import express from 'express'
 import type { Express, RequestHandler } from 'express'
 import { createHealthRouter } from './routes/health'
@@ -20,9 +21,20 @@ export interface CreateAppOptions {
   cors?: boolean
 }
 
+/** 运行时读自己包的 package.json 版本，避免默认值随发布演进漂移（包内 dist/ 与 package.json 同级） */
+function readOwnVersion(): string {
+  try {
+    const req = createRequire(import.meta.url)
+    const pkg = req('../package.json') as { version?: string }
+    return pkg.version ?? 'unknown'
+  } catch {
+    return 'unknown'
+  }
+}
+
 export const API_PREFIX = '/api'
 export const DEFAULT_API_NAME = 'kb-api'
-export const DEFAULT_API_VERSION = '0.1.0'
+export const DEFAULT_API_VERSION = readOwnVersion()
 
 const ENDPOINTS = [
   'GET    /api/health',

package/templates/fullstack/server/src/app.ts

@@ -1,6 +1,7 @@
 /* eslint-disable */
 // ⚠️ 自动生成文件，请勿直接修改。
 // 源：packages/api/src —— 改动请改源文件后运行 `pnpm sync:api-template`。
+import { createRequire } from 'node:module'
 import express from 'express'
 import type { Express, RequestHandler } from 'express'
 import { createHealthRouter } from './routes/health'
@@ -20,9 +21,20 @@ export interface CreateAppOptions {
   cors?: boolean
 }
 
+/** 运行时读自己包的 package.json 版本，避免默认值随发布演进漂移（包内 dist/ 与 package.json 同级） */
+function readOwnVersion(): string {
+  try {
+    const req = createRequire(import.meta.url)
+    const pkg = req('../package.json') as { version?: string }
+    return pkg.version ?? 'unknown'
+  } catch {
+    return 'unknown'
+  }
+}
+
 export const API_PREFIX = '/api'
 export const DEFAULT_API_NAME = 'kb-api'
-export const DEFAULT_API_VERSION = '0.1.0'
+export const DEFAULT_API_VERSION = readOwnVersion()
 
 const ENDPOINTS = [
   'GET    /api/health',