@robsun/create-keystone-app 0.2.0 → 0.2.2

package/README.md

@@ -5,6 +5,7 @@
 npx @robsun/create-keystone-app <dir> [options]
 pnpm dlx @robsun/create-keystone-app <dir> [options]
 ```
+不传 options 会进入交互式向导。
 
 ## 选项
 - `<dir>`：目标目录（必填），可为新目录名或 `.`（当前目录）。
@@ -17,6 +18,19 @@ pnpm dlx @robsun/create-keystone-app <dir> [options]
 npx @robsun/create-keystone-app my-app --db=postgres --queue=redis --storage=s3
 ```
 
+## 模块生成器
+```bash
+npx --package @robsun/create-keystone-app create-keystone-module <module-name> [options]
+pnpm dlx --package @robsun/create-keystone-app create-keystone-module <module-name> [options]
+```
+不传 options 会进入交互式向导。
+
+选项：
+- `--frontend-only`：只生成前端模块。
+- `--backend-only`：只生成后端模块。
+- `--with-crud`：包含 CRUD 示例代码。
+- `--skip-register`：跳过自动注册步骤。
+
 ## 初始化后操作
 ```bash
 cd <dir>

package/{bin → dist}/create-keystone-app.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 const fs = require('fs');
 const path = require('path');
+const readline = require('readline/promises');
+const { stdin: input, stdout: output } = require('process');
 
 const usage = [
   'Usage: create-keystone-app <dir> [options]',
@@ -10,53 +12,129 @@ const usage = [
   '  --queue <memory|redis>    Queue driver (default: memory)',
   '  --storage <local|s3>      Storage driver (default: local)',
   '  -h, --help                Show help',
+  '',
+  'Run without options to use guided prompts.',
 ].join('\n');
 
-const args = parseArgs(process.argv.slice(2));
-if (args.help) {
-  console.log(usage);
-  process.exit(0);
-}
-
-if (!args.target) {
-  console.error(usage);
+main().catch((err) => {
+  const message = err instanceof Error ? err.message : String(err);
+  console.error(message);
   process.exit(1);
-}
+});
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.help) {
+    console.log(usage);
+    return;
+  }
+
+  const canPrompt = isInteractive();
+  const rl = canPrompt ? readline.createInterface({ input, output }) : null;
+  let db;
+  let queue;
+  let storage;
+
+  try {
+    if (!args.target) {
+      if (!rl) {
+        console.error(usage);
+        process.exit(1);
+      }
+      args.target = await promptText(rl, 'Project directory', 'keystone-app');
+    }
+
+    db = normalizeChoice(args.db, ['sqlite', 'postgres'], 'db') || null;
+    queue = normalizeChoice(args.queue, ['memory', 'redis'], 'queue') || null;
+    storage = normalizeChoice(args.storage, ['local', 's3'], 'storage') || null;
 
-const db = normalizeChoice(args.db, ['sqlite', 'postgres'], 'db') || 'sqlite';
-const queue = normalizeChoice(args.queue, ['memory', 'redis'], 'queue') || 'memory';
-const storage = normalizeChoice(args.storage, ['local', 's3'], 'storage') || 'local';
+    if (!db) {
+      db = rl ? await promptSelect(rl, 'Select database driver', ['sqlite', 'postgres'], 0) : 'sqlite';
+    }
+    if (!queue) {
+      queue = rl ? await promptSelect(rl, 'Select queue driver', ['memory', 'redis'], 0) : 'memory';
+    }
+    if (!storage) {
+      storage = rl ? await promptSelect(rl, 'Select storage driver', ['local', 's3'], 0) : 'local';
+    }
+  } finally {
+    if (rl) {
+      rl.close();
+    }
+  }
 
-const targetDir = path.resolve(process.cwd(), args.target);
-const targetName = args.target === '.'
-  ? path.basename(process.cwd())
-  : path.basename(targetDir);
+  const targetDir = path.resolve(process.cwd(), args.target);
+  const targetName = args.target === '.'
+    ? path.basename(process.cwd())
+    : path.basename(targetDir);
 
-if (fs.existsSync(targetDir)) {
-  const entries = fs.readdirSync(targetDir);
-  if (entries.length > 0) {
-    console.error(`Target directory is not empty: ${targetDir}`);
-    process.exit(1);
+  if (fs.existsSync(targetDir)) {
+    const entries = fs.readdirSync(targetDir);
+    if (entries.length > 0) {
+      console.error(`Target directory is not empty: ${targetDir}`);
+      process.exit(1);
+    }
+  } else {
+    fs.mkdirSync(targetDir, { recursive: true });
   }
-} else {
-  fs.mkdirSync(targetDir, { recursive: true });
+
+  const templateDir = path.resolve(__dirname, '..', 'template');
+  copyDir(templateDir, targetDir, {
+    '__APP_NAME__': normalizePackageName(targetName),
+    '__RAW_NAME__': targetName,
+  });
+
+  applyConfigOptions(targetDir, { db, queue, storage });
+
+  console.log(`Created ${targetName}`);
+  console.log('Next steps:');
+  console.log(`  cd ${args.target}`);
+  console.log('  pnpm install');
+  console.log('  pnpm server:dev');
+  console.log('  pnpm web:dev');
+  console.log('  pnpm dev');
 }
 
-const templateDir = path.resolve(__dirname, '..', 'template');
-copyDir(templateDir, targetDir, {
-  '__APP_NAME__': normalizePackageName(targetName),
-  '__RAW_NAME__': targetName,
-});
+function isInteractive() {
+  return Boolean(input.isTTY && output.isTTY);
+}
 
-applyConfigOptions(targetDir, { db, queue, storage });
+async function promptText(rl, label, defaultValue) {
+  while (true) {
+    const suffix = defaultValue ? ` (${defaultValue})` : '';
+    const answer = await rl.question(`${label}${suffix}: `);
+    const trimmed = answer.trim();
+    if (trimmed) {
+      return trimmed;
+    }
+    if (defaultValue) {
+      return defaultValue;
+    }
+    console.log('Please enter a value.');
+  }
+}
 
-console.log(`Created ${targetName}`);
-console.log('Next steps:');
-console.log(`  cd ${args.target}`);
-console.log('  pnpm install');
-console.log('  pnpm server:dev');
-console.log('  pnpm web:dev');
-console.log('  pnpm dev');
+async function promptSelect(rl, label, choices, defaultIndex) {
+  while (true) {
+    const options = choices.map((choice, index) => `  ${index + 1}) ${choice}`).join('\n');
+    const answer = await rl.question(
+      `${label}\n${options}\nSelect an option [${defaultIndex + 1}]: `
+    );
+    const normalized = answer.trim().toLowerCase();
+    if (!normalized) {
+      return choices[defaultIndex];
+    }
+    const numeric = Number(normalized);
+    if (Number.isInteger(numeric) && numeric >= 1 && numeric <= choices.length) {
+      return choices[numeric - 1];
+    }
+    const match = choices.find((choice) => choice.toLowerCase() === normalized);
+    if (match) {
+      return match;
+    }
+    console.log('Invalid selection. Try again.');
+  }
+}
 
 function normalizePackageName(name) {
   const cleaned = String(name || '')
@@ -113,7 +191,6 @@ function applyConfigOptions(targetDir, options) {
   for (const filePath of configFiles) {
     updateFile(filePath, (content) => applyYamlOptions(content, options));
   }
-
 }
 
 function applyYamlOptions(content, options) {
@@ -236,4 +313,4 @@ function fail(message) {
   console.error(message);
   console.error(usage);
   process.exit(1);
-}
+}

package/dist/create-module.js

@@ -0,0 +1,638 @@
+#!/usr/bin/env node
+const fs = require('fs')
+const path = require('path')
+const readline = require('readline/promises')
+const { stdin: input, stdout: output } = require('process')
+
+const usage = [
+  'Usage: create-module <module-name> [options]',
+  '',
+  'Options:',
+  '  --frontend-only    Only generate the frontend module',
+  '  --backend-only     Only generate the backend module',
+  '  --with-crud        Include CRUD example code',
+  '  --skip-register    Skip auto registration steps',
+  '  -h, --help         Show help',
+  '',
+  'Run without options to use guided prompts.',
+].join('\n')
+
+main().catch((err) => {
+  const message = err instanceof Error ? err.message : String(err)
+  console.error(message)
+  process.exit(1)
+})
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2))
+  if (args.help) {
+    console.log(usage)
+    return
+  }
+
+  const canPrompt = isInteractive()
+  const rl = canPrompt ? readline.createInterface({ input, output }) : null
+
+  let includeFrontend = !args.backendOnly
+  let includeBackend = !args.frontendOnly
+  let withCrud = args.withCrud
+  let skipRegister = args.skipRegister
+
+  try {
+    if (!args.target) {
+      if (!rl) {
+        console.error(usage)
+        process.exit(1)
+      }
+      args.target = await promptText(rl, 'Module name')
+    }
+
+    if (args.frontendOnly && args.backendOnly) {
+      fail('Use either --frontend-only or --backend-only, not both.')
+    }
+
+    if (!args.frontendOnly && !args.backendOnly && rl) {
+      const selection = await promptSelect(
+        rl,
+        'Generate which module(s)?',
+        ['frontend + backend', 'frontend only', 'backend only'],
+        0
+      )
+      if (selection === 'frontend only') {
+        includeFrontend = true
+        includeBackend = false
+      } else if (selection === 'backend only') {
+        includeFrontend = false
+        includeBackend = true
+      }
+    }
+
+    if (!args.withCrud && rl) {
+      withCrud = await promptConfirm(rl, 'Include CRUD example code', false)
+    }
+    if (!args.skipRegister && rl) {
+      const autoRegister = await promptConfirm(rl, 'Auto-register module', true)
+      skipRegister = !autoRegister
+    }
+  } finally {
+    if (rl) {
+      rl.close()
+    }
+  }
+
+  const names = buildNames(args.target)
+  const rootDir = resolveProjectRoot(process.cwd(), includeFrontend, includeBackend)
+
+  const frontendSourceDir = path.join(rootDir, 'apps', 'web', 'src', 'modules', 'example')
+  const frontendTargetDir = path.join(rootDir, 'apps', 'web', 'src', 'modules', names.kebab)
+  const backendSourceDir = path.join(rootDir, 'apps', 'server', 'internal', 'modules', 'example')
+  const backendTargetDir = path.join(rootDir, 'apps', 'server', 'internal', 'modules', names.kebab)
+
+  if (includeFrontend) {
+    if (!fs.existsSync(frontendSourceDir)) {
+      fail(`Frontend example module not found at ${frontendSourceDir}`)
+    }
+    if (fs.existsSync(frontendTargetDir)) {
+      fail(`Frontend module already exists: ${frontendTargetDir}`)
+    }
+    copyModule(frontendSourceDir, frontendTargetDir, names, 'frontend')
+    if (!withCrud) {
+      pruneFrontendCrud(frontendTargetDir, names)
+    }
+  }
+
+  if (includeBackend) {
+    if (!fs.existsSync(backendSourceDir)) {
+      fail(`Backend example module not found at ${backendSourceDir}`)
+    }
+    if (fs.existsSync(backendTargetDir)) {
+      fail(`Backend module already exists: ${backendTargetDir}`)
+    }
+    copyModule(backendSourceDir, backendTargetDir, names, 'backend')
+    if (!withCrud) {
+      pruneBackendCrud(backendTargetDir, names)
+    }
+  }
+
+  if (!skipRegister) {
+    if (includeFrontend) {
+      registerFrontendModule(path.join(rootDir, 'apps', 'web', 'src', 'main.tsx'), names)
+    }
+    if (includeBackend) {
+      registerBackendModule(
+        path.join(rootDir, 'apps', 'server', 'internal', 'modules', 'manifest.go'),
+        path.join(rootDir, 'apps', 'server', 'config.yaml'),
+        names
+      )
+    }
+  }
+
+  const targets = []
+  if (includeFrontend) targets.push('frontend')
+  if (includeBackend) targets.push('backend')
+
+  console.log(`Created ${names.kebab} module (${targets.join(' + ')})`)
+  if (skipRegister) {
+    console.log('Registration skipped. Update the app entrypoints manually.')
+  } else {
+    console.log('Registration updated.')
+  }
+  if (!withCrud) {
+    console.log('Generated minimal scaffolding (no CRUD example).')
+  }
+}
+
+function isInteractive() {
+  return Boolean(input.isTTY && output.isTTY)
+}
+
+async function promptText(rl, label) {
+  while (true) {
+    const answer = await rl.question(`${label}: `)
+    const trimmed = answer.trim()
+    if (trimmed) {
+      return trimmed
+    }
+    console.log('Please enter a value.')
+  }
+}
+
+async function promptSelect(rl, label, choices, defaultIndex) {
+  while (true) {
+    const options = choices.map((choice, index) => `  ${index + 1}) ${choice}`).join('\n')
+    const answer = await rl.question(
+      `${label}\n${options}\nSelect an option [${defaultIndex + 1}]: `
+    )
+    const normalized = answer.trim().toLowerCase()
+    if (!normalized) {
+      return choices[defaultIndex]
+    }
+    const numeric = Number(normalized)
+    if (Number.isInteger(numeric) && numeric >= 1 && numeric <= choices.length) {
+      return choices[numeric - 1]
+    }
+    const match = choices.find((choice) => choice.toLowerCase() === normalized)
+    if (match) {
+      return match
+    }
+    console.log('Invalid selection. Try again.')
+  }
+}
+
+async function promptConfirm(rl, label, defaultValue) {
+  while (true) {
+    const suffix = defaultValue ? 'Y/n' : 'y/N'
+    const answer = await rl.question(`${label} (${suffix}): `)
+    const normalized = answer.trim().toLowerCase()
+    if (!normalized) {
+      return defaultValue
+    }
+    if (['y', 'yes'].includes(normalized)) {
+      return true
+    }
+    if (['n', 'no'].includes(normalized)) {
+      return false
+    }
+    console.log('Please enter y or n.')
+  }
+}
+
+function buildNames(raw) {
+  const words = splitWords(raw)
+  if (words.length === 0) {
+    fail(`Invalid module name: ${raw}`)
+  }
+  const capitalized = words.map(capitalize)
+  const kebab = words.join('-')
+  const camel = words[0] + capitalized.slice(1).join('')
+  const pascal = capitalized.join('')
+  const lower = words.join('')
+  const display = capitalized.join(' ')
+  return {
+    raw,
+    words,
+    kebab,
+    camel,
+    pascal,
+    lower,
+    display,
+  }
+}
+
+function splitWords(value) {
+  const normalized = String(value || '')
+    .trim()
+    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+    .replace(/[^a-zA-Z0-9]+/g, ' ')
+    .trim()
+  if (!normalized) return []
+  return normalized.split(/\s+/).map((word) => word.toLowerCase())
+}
+
+function capitalize(value) {
+  return value ? value[0].toUpperCase() + value.slice(1) : ''
+}
+
+function resolveProjectRoot(startDir, includeFrontend, includeBackend) {
+  const candidates = [
+    startDir,
+    path.join(startDir, 'packages', 'create-keystone-app', 'template'),
+    path.join(startDir, 'template'),
+  ]
+  for (const candidate of candidates) {
+    const frontendOk =
+      !includeFrontend || fs.existsSync(path.join(candidate, 'apps', 'web', 'src', 'modules', 'example'))
+    const backendOk =
+      !includeBackend || fs.existsSync(path.join(candidate, 'apps', 'server', 'internal', 'modules', 'example'))
+    if (frontendOk && backendOk) {
+      return candidate
+    }
+  }
+  fail('Could not find a project with apps/web and apps/server module templates.')
+}
+
+function copyModule(srcDir, destDir, names, mode) {
+  copyDir(srcDir, destDir, (entryName) => renameSegment(entryName, names), (content, filePath) =>
+    transformContent(content, filePath, names, mode)
+  )
+}
+
+function copyDir(src, dest, renameEntry, transform) {
+  fs.mkdirSync(dest, { recursive: true })
+  const entries = fs.readdirSync(src, { withFileTypes: true })
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name)
+    const nextName = renameEntry(entry.name)
+    const destPath = path.join(dest, nextName)
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath, renameEntry, transform)
+    } else {
+      copyFile(srcPath, destPath, transform)
+    }
+  }
+}
+
+function copyFile(src, dest, transform) {
+  const content = fs.readFileSync(src, 'utf8')
+  const next = transform ? transform(content, dest) : content
+  fs.mkdirSync(path.dirname(dest), { recursive: true })
+  fs.writeFileSync(dest, next, 'utf8')
+}
+
+function renameSegment(segment, names) {
+  if (segment === 'example') {
+    return names.kebab
+  }
+  return segment.replace(/Example/g, names.pascal).replace(/example/g, names.camel)
+}
+
+function transformContent(content, filePath, names, mode) {
+  const ext = path.extname(filePath).toLowerCase()
+  if (ext === '.go') {
+    return replaceInCode(
+      content,
+      [
+        ['Example', names.pascal],
+        ['example', names.lower],
+      ],
+      (value) => replaceStringLiteral(value, names, mode === 'backend' ? names.lower : names.camel)
+    )
+  }
+  if (['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'].includes(ext)) {
+    return replaceInCode(
+      content,
+      [
+        ['Example', names.pascal],
+        ['example', names.camel],
+      ],
+      (value) => replaceStringLiteral(value, names, names.camel)
+    )
+  }
+  return replaceText(content, names)
+}
+
+function replaceText(content, names) {
+  return applyReplacements(content, [
+    ['Example', names.display],
+    ['example', names.kebab],
+  ])
+}
+
+function replaceStringLiteral(value, names, pathWord) {
+  if (value.startsWith('./') || value.startsWith('../')) {
+    return applyReplacements(value, [
+      ['Example', names.pascal],
+      ['example', pathWord],
+    ])
+  }
+  return applyReplacements(value, [
+    ['Example', names.display],
+    ['example', names.kebab],
+  ])
+}
+
+function replaceInCode(content, codeReplacements, stringReplacer) {
+  let out = ''
+  let i = 0
+  let start = 0
+  let inString = null
+  let escaped = false
+  while (i < content.length) {
+    const ch = content[i]
+    if (!inString) {
+      if (ch === '"' || ch === "'" || ch === '`') {
+        out += applyReplacements(content.slice(start, i), codeReplacements)
+        inString = ch
+        out += ch
+        i += 1
+        start = i
+        continue
+      }
+      i += 1
+      continue
+    }
+    if (escaped) {
+      escaped = false
+      i += 1
+      continue
+    }
+    if (ch === '\\' && inString !== '`') {
+      escaped = true
+      i += 1
+      continue
+    }
+    if (ch === inString) {
+      out += stringReplacer(content.slice(start, i))
+      out += ch
+      inString = null
+      i += 1
+      start = i
+      continue
+    }
+    i += 1
+  }
+  if (start < content.length) {
+    const tail = content.slice(start)
+    out += inString ? stringReplacer(tail) : applyReplacements(tail, codeReplacements)
+  }
+  return out
+}
+
+function applyReplacements(value, replacements) {
+  let next = value
+  for (const [from, to] of replacements) {
+    next = next.split(from).join(to)
+  }
+  return next
+}
+
+function pruneFrontendCrud(targetDir, names) {
+  const servicesDir = path.join(targetDir, 'services')
+  if (fs.existsSync(servicesDir)) {
+    fs.rmSync(servicesDir, { recursive: true, force: true })
+  }
+  const typesFile = path.join(targetDir, 'types.ts')
+  if (fs.existsSync(typesFile)) {
+    fs.rmSync(typesFile, { force: true })
+  }
+  const pageFile = path.join(targetDir, 'pages', `${names.pascal}ItemsPage.tsx`)
+  const content = [
+    "import { Card, Typography } from 'antd'",
+    '',
+    `export function ${names.pascal}ItemsPage() {`,
+    '  return (',
+    `    <Card title="${names.display}">`,
+    '      <Typography.Paragraph type="secondary">',
+    `        ${names.display} module is ready. Start building your pages here.`,
+    '      </Typography.Paragraph>',
+    '    </Card>',
+    '  )',
+    '}',
+    '',
+  ].join('\n')
+  fs.writeFileSync(pageFile, content, 'utf8')
+}
+
+function pruneBackendCrud(targetDir, names) {
+  const dirs = ['api', 'bootstrap', 'domain', 'infra']
+  for (const dir of dirs) {
+    const fullPath = path.join(targetDir, dir)
+    if (fs.existsSync(fullPath)) {
+      fs.rmSync(fullPath, { recursive: true, force: true })
+    }
+  }
+  const moduleFile = path.join(targetDir, 'module.go')
+  const content = [
+    `package ${names.lower}`,
+    '',
+    'import (',
+    '\t"github.com/gin-gonic/gin"',
+    '\t"gorm.io/gorm"',
+    '',
+    '\t"github.com/robsuncn/keystone/domain/permissions"',
+    '\t"github.com/robsuncn/keystone/infra/jobs"',
+    ')',
+    '',
+    'type Module struct{}',
+    '',
+    'func NewModule() *Module {',
+    '\treturn &Module{}',
+    '}',
+    '',
+    'func (m *Module) Name() string {',
+    `\treturn "${names.kebab}"`,
+    '}',
+    '',
+    'func (m *Module) RegisterRoutes(_ *gin.RouterGroup) {}',
+    '',
+    'func (m *Module) RegisterModels() []interface{} {',
+    '\treturn nil',
+    '}',
+    '',
+    'func (m *Module) RegisterPermissions(reg *permissions.Registry) error {',
+    '\tif reg == nil {',
+    '\t\treturn nil',
+    '\t}',
+    `\tif err := reg.CreateMenu("${names.kebab}:overview", "${names.display}", "${names.kebab}", 10); err != nil {`,
+    '\t\treturn err',
+    '\t}',
+    `\tif err := reg.CreateAction("${names.kebab}:overview:view", "View ${names.display}", "${names.kebab}", "${names.kebab}:overview"); err != nil {`,
+    '\t\treturn err',
+    '\t}',
+    '\treturn nil',
+    '}',
+    '',
+    'func (m *Module) RegisterJobs(_ *jobs.Registry) error {',
+    '\treturn nil',
+    '}',
+    '',
+    'func (m *Module) Migrate(_ *gorm.DB) error {',
+    '\treturn nil',
+    '}',
+    '',
+    'func (m *Module) Seed(_ *gorm.DB) error {',
+    '\treturn nil',
+    '}',
+    '',
+  ].join('\n')
+  fs.writeFileSync(moduleFile, content, 'utf8')
+}
+
+function registerFrontendModule(mainPath, names) {
+  if (!fs.existsSync(mainPath)) {
+    return
+  }
+  const content = fs.readFileSync(mainPath, 'utf8')
+  const importLine = `import './modules/${names.kebab}'`
+  if (content.includes(importLine)) {
+    return
+  }
+  const lines = content.split(/\r?\n/)
+  let lastImport = -1
+  for (let i = 0; i < lines.length; i += 1) {
+    if (/^\s*import\s/.test(lines[i])) {
+      lastImport = i
+    }
+  }
+  if (lastImport === -1) {
+    lines.unshift(importLine)
+  } else {
+    lines.splice(lastImport + 1, 0, importLine)
+  }
+  fs.writeFileSync(mainPath, lines.join('\n'), 'utf8')
+}
+
+function registerBackendModule(manifestPath, configPath, names) {
+  updateManifest(manifestPath, names)
+  updateConfig(configPath, names)
+}
+
+function updateManifest(manifestPath, names) {
+  if (!fs.existsSync(manifestPath)) {
+    return
+  }
+  const content = fs.readFileSync(manifestPath, 'utf8')
+  const lines = content.split(/\r?\n/)
+  const importStart = lines.findIndex((line) => line.trim() === 'import (')
+  if (importStart === -1) {
+    return
+  }
+  const importEnd = lines.findIndex((line, index) => index > importStart && line.trim() === ')')
+  if (importEnd === -1) {
+    return
+  }
+  const importBlock = lines.slice(importStart + 1, importEnd)
+  const exampleImport = importBlock.find((line) => line.includes('/internal/modules/example'))
+  if (!exampleImport) {
+    return
+  }
+  const pathMatch = exampleImport.match(/\"([^\"]+)\"/)
+  if (!pathMatch) {
+    return
+  }
+  const modulePath = pathMatch[1].replace(/\/example$/, `/${names.kebab}`)
+  const alias = names.lower
+  const importLine = `${alias} "${modulePath}"`
+  if (!importBlock.some((line) => line.includes(`/${names.kebab}"`))) {
+    lines.splice(importEnd, 0, importLine)
+  }
+  const registerLine = `\tRegister(${alias}.NewModule())`
+  if (!lines.some((line) => line.trim() === registerLine.trim())) {
+    const registerIndices = lines
+      .map((line, index) => ({ line, index }))
+      .filter(({ line }) => line.includes('Register('))
+    if (registerIndices.length > 0) {
+      lines.splice(registerIndices[registerIndices.length - 1].index + 1, 0, registerLine)
+    } else {
+      const clearIndex = lines.findIndex((line) => line.includes('Clear()'))
+      if (clearIndex !== -1) {
+        lines.splice(clearIndex + 1, 0, registerLine)
+      }
+    }
+  }
+  fs.writeFileSync(manifestPath, lines.join('\n'), 'utf8')
+}
+
+function updateConfig(configPath, names) {
+  if (!fs.existsSync(configPath)) {
+    return
+  }
+  const content = fs.readFileSync(configPath, 'utf8')
+  if (content.includes(`- "${names.kebab}"`) || content.includes(`- '${names.kebab}'`)) {
+    return
+  }
+  const lines = content.split(/\r?\n/)
+  const modulesIndex = lines.findIndex((line) => line.trim() === 'modules:')
+  if (modulesIndex === -1) {
+    return
+  }
+  const enabledIndex = lines.findIndex((line, index) => index > modulesIndex && line.trim() === 'enabled:')
+  if (enabledIndex === -1) {
+    return
+  }
+  let insertIndex = enabledIndex + 1
+  let indent = null
+  for (let i = enabledIndex + 1; i < lines.length; i += 1) {
+    const line = lines[i]
+    if (!line.trim()) continue
+    if (!line.trim().startsWith('-')) {
+      insertIndex = i
+      break
+    }
+    if (indent === null) {
+      indent = line.match(/^\s*/)?.[0] ?? ''
+    }
+    insertIndex = i + 1
+  }
+  const prefix = indent ?? '    '
+  lines.splice(insertIndex, 0, `${prefix}- "${names.kebab}"`)
+  fs.writeFileSync(configPath, lines.join('\n'), 'utf8')
+}
+
+function parseArgs(argv) {
+  const out = {
+    target: null,
+    frontendOnly: false,
+    backendOnly: false,
+    withCrud: false,
+    skipRegister: false,
+    help: false,
+  }
+  for (const arg of argv) {
+    if (arg === '--help' || arg === '-h') {
+      out.help = true
+      continue
+    }
+    if (arg === '--frontend-only') {
+      out.frontendOnly = true
+      continue
+    }
+    if (arg === '--backend-only') {
+      out.backendOnly = true
+      continue
+    }
+    if (arg === '--with-crud') {
+      out.withCrud = true
+      continue
+    }
+    if (arg === '--skip-register') {
+      out.skipRegister = true
+      continue
+    }
+    if (arg.startsWith('-')) {
+      fail(`Unknown option: ${arg}`)
+    }
+    if (!out.target) {
+      out.target = arg
+      continue
+    }
+    fail('Too many arguments.')
+  }
+  return out
+}
+
+function fail(message) {
+  console.error(message)
+  console.error(usage)
+  process.exit(1)
+}

package/package.json

@@ -1,19 +1,23 @@
-{
+{
   "name": "@robsun/create-keystone-app",
-  "version": "0.2.0",
+  "version": "0.2.2",
+  "scripts": {
+    "build": "node scripts/build.js",
+    "prepublishOnly": "node scripts/build.js && node scripts/prune-template-deps.js"
+  },
   "publishConfig": {
     "access": "public"
   },
   "bin": {
-    "create-keystone-app": "bin/create-keystone-app.js"
+    "create-keystone-app": "dist/create-keystone-app.js",
+    "create-keystone-module": "dist/create-module.js"
   },
   "files": [
-    "bin",
+    "dist",
     "template",
     "README.md"
   ],
   "engines": {
     "node": ">=18"
-  },
-  "scripts": {}
-}
+  }
+}

package/template/README.md

@@ -31,6 +31,18 @@ pnpm web:dev
 - `pnpm test`：Web 类型检查 + Lint + Vitest + Go 测试。
 - `pnpm clean`：清理构建产物。
 
+## 模块生成器
+```bash
+pnpm create:module <module-name> [options]
+```
+不传 options 会进入交互式向导。
+
+选项：
+- `--frontend-only`：只生成前端模块。
+- `--backend-only`：只生成后端模块。
+- `--with-crud`：包含 CRUD 示例代码。
+- `--skip-register`：跳过自动注册步骤。
+
 ## 目录结构
 - `apps/web/`：React + Vite 壳与业务模块（`src/modules/*`）。
 - `apps/server/`：Go API + 模块注册/迁移/种子数据（含 `config.yaml`）。

package/template/apps/server/internal/modules/manifest.go

@@ -1,7 +1,7 @@
 package modules
 
 import (
-	example "__APP_NAME__/apps/server/internal/modules/example"
+example "__APP_NAME__/apps/server/internal/modules/example"
 )
 
 // RegisterAll wires the module registry for this app.

package/template/apps/web/package.json

@@ -17,7 +17,7 @@
   },
   "dependencies": {
     "@ant-design/icons": "^6.1.0",
-    "@robsun/keystone-web-core": "0.1.7",
+    "@robsun/keystone-web-core": "0.1.8",
     "antd": "^6.0.1",
     "dayjs": "^1.11.19",
     "react": "^19.2.0",

package/template/apps/web/src/main.tsx

@@ -15,5 +15,4 @@ createRoot(document.getElementById('root')!).render(
   <StrictMode>
     <KeystoneApp />
   </StrictMode>
-)
-
+)

package/template/package.json

@@ -7,6 +7,7 @@
     "build": "node scripts/build.js",
     "build:web": "pnpm --filter web build",
     "check-modules": "node scripts/check-modules.js",
+    "create:module": "pnpm dlx --package @robsun/create-keystone-app create-keystone-module",
     "test": "pnpm check-modules && node scripts/test.js",
     "lint": "pnpm --filter web lint",
     "format": "prettier --write \"**/*.{ts,tsx,js,jsx,json,md,yml,yaml}\"",

package/template/pnpm-lock.yaml

@@ -27,8 +27,8 @@ importers:
         specifier: ^6.1.0
         version: 6.1.0(react-dom@19.2.3(react@19.2.3))(react@19.2.3)
       '@robsun/keystone-web-core':
-        specifier: 0.1.7
-        version: 0.1.7(@ant-design/icons@6.1.0(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(@types/react@19.2.7)(antd@6.1.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react-dom@19.2.3(react@19.2.3))(react-router-dom@7.11.0(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3)(use-sync-external-store@1.6.0(react@19.2.3))(vite@7.3.0(@types/node@24.10.4)(jiti@2.6.1)(lightningcss@1.30.2)(yaml@2.8.2))
+        specifier: 0.1.8
+        version: 0.1.8(@ant-design/icons@6.1.0(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(@types/react@19.2.7)(antd@6.1.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react-dom@19.2.3(react@19.2.3))(react-router-dom@7.11.0(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3)(use-sync-external-store@1.6.0(react@19.2.3))(vite@7.3.0(@types/node@24.10.4)(jiti@2.6.1)(lightningcss@1.30.2)(yaml@2.8.2))
       antd:
         specifier: ^6.0.1
         version: 6.1.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3)
@@ -924,7 +924,7 @@ packages:
       react: '>=16.9.0'
       react-dom: '>=16.9.0'
 
-  '@robsun/keystone-web-core@0.1.7':
+  '@robsun/keystone-web-core@0.1.8':
     resolution: {integrity: sha512-r6Qfs1LxTZBv6GVIf5s6LREuTl/lskq8L3Y9YynUFKvL1tuZ3h3sThxPvvP7VQbBZn5As/XUv16kpqqVXX1HvQ==}
     peerDependencies:
       '@ant-design/icons': ^6.1.0
@@ -3744,7 +3744,7 @@ snapshots:
       react: 19.2.3
       react-dom: 19.2.3(react@19.2.3)
 
-  '@robsun/keystone-web-core@0.1.7(@ant-design/icons@6.1.0(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(@types/react@19.2.7)(antd@6.1.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react-dom@19.2.3(react@19.2.3))(react-router-dom@7.11.0(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3)(use-sync-external-store@1.6.0(react@19.2.3))(vite@7.3.0(@types/node@24.10.4)(jiti@2.6.1)(lightningcss@1.30.2)(yaml@2.8.2))':
+  '@robsun/keystone-web-core@0.1.8(@ant-design/icons@6.1.0(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(@types/react@19.2.7)(antd@6.1.3(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react-dom@19.2.3(react@19.2.3))(react-router-dom@7.11.0(react-dom@19.2.3(react@19.2.3))(react@19.2.3))(react@19.2.3)(use-sync-external-store@1.6.0(react@19.2.3))(vite@7.3.0(@types/node@24.10.4)(jiti@2.6.1)(lightningcss@1.30.2)(yaml@2.8.2))':
     dependencies:
       '@ant-design/icons': 6.1.0(react-dom@19.2.3(react@19.2.3))(react@19.2.3)
       '@vitejs/plugin-react': 5.1.2(vite@7.3.0(@types/node@24.10.4)(jiti@2.6.1)(lightningcss@1.30.2)(yaml@2.8.2))
@@ -6027,3 +6027,4 @@ snapshots:
       use-sync-external-store: 1.6.0(react@19.2.3)
 
   zwitch@2.0.4: {}
+