draftgo-cli 3.0.29 → 3.0.33

package/src/commands/api.js

@@ -4,7 +4,138 @@ const fs = require('fs');
 const path = require('path');
 const log = require('../logger');
 
-const API_FILE = path.resolve(__dirname, '..', '..', 'resources', 'skill', 'quickref', 'api.json');
+const API_FILE = path.resolve(__dirname, '..', '..', 'resources', 'skill', 'references', 'api.json');
+const HTTP_METHODS = new Set(['get', 'post', 'put', 'patch', 'delete', 'head', 'options']);
+const AUTH_HEADER_NAMES = new Set(['authorization', 'proxy-authorization', 'x-api-key']);
+
+function resolveRef(spec, ref) {
+  if (!ref || !ref.startsWith('#/')) return null;
+  return ref.slice(2).split('/').reduce((value, part) => value && value[part], spec);
+}
+
+function schemaType(schema, spec) {
+  if (!schema || !Object.keys(schema).length) return 'unspecified';
+  if (schema.$ref) {
+    const target = resolveRef(spec, schema.$ref);
+    return target && (target.title || schema.$ref.split('/').pop()) || schema.$ref;
+  }
+  if (schema.anyOf) return schema.anyOf.map((item) => schemaType(item, spec)).join(' | ');
+  if (schema.oneOf) return schema.oneOf.map((item) => schemaType(item, spec)).join(' | ');
+  if (schema.allOf) return schema.allOf.map((item) => schemaType(item, spec)).join(' & ');
+  if (schema.type === 'array') return `${schemaType(schema.items, spec)}[]`;
+  if (schema.type) return schema.format ? `${schema.type} (${schema.format})` : schema.type;
+  if (schema.properties) return 'object';
+  return 'unspecified';
+}
+
+function schemaNotes(schema) {
+  const notes = [];
+  if (schema.description) notes.push(schema.description);
+  if (schema.default !== undefined) notes.push(`default: ${JSON.stringify(schema.default)}`);
+  if (schema.enum) notes.push(`enum: ${schema.enum.map((item) => JSON.stringify(item)).join(', ')}`);
+  return notes.length ? ` (${notes.join('; ')})` : '';
+}
+
+function printSchema(schema, spec, indent = '      ', seen = new Set()) {
+  if (!schema || !Object.keys(schema).length) {
+    console.log(`${indent}schema: unspecified`);
+    return;
+  }
+
+  let resolved = schema;
+  let refName = '';
+  if (schema.$ref) {
+    refName = schema.$ref.split('/').pop();
+    if (seen.has(schema.$ref)) {
+      console.log(`${indent}${refName} (recursive)`);
+      return;
+    }
+    resolved = resolveRef(spec, schema.$ref) || schema;
+    seen = new Set(seen).add(schema.$ref);
+  }
+
+  console.log(`${indent}schema: ${refName ? `${refName} (${schemaType(resolved, spec)})` : schemaType(resolved, spec)}${schemaNotes(resolved)}`);
+  const variants = resolved.anyOf || resolved.oneOf || resolved.allOf;
+  if (variants) {
+    variants.forEach((variant, index) => {
+      console.log(`${indent}  variant ${index + 1}:`);
+      printSchema(variant, spec, `${indent}    `, seen);
+    });
+    return;
+  }
+  const required = new Set(resolved.required || []);
+  for (const [name, property] of Object.entries(resolved.properties || {})) {
+    const fieldSchema = property.$ref ? resolveRef(spec, property.$ref) || property : property;
+    const marker = required.has(name) ? ' required' : ' optional';
+    console.log(`${indent}  ${name}: ${schemaType(property, spec)}${marker}${schemaNotes(fieldSchema)}`);
+  }
+  if (resolved.additionalProperties === true) console.log(`${indent}  additional properties: allowed`);
+  if (resolved.items && !resolved.properties) printSchema(resolved.items, spec, `${indent}  `, seen);
+}
+
+function authenticationFor(operation, spec) {
+  const security = operation.security === undefined ? spec.security : operation.security;
+  const schemes = (security || []).flatMap((requirement) => Object.keys(requirement).map((name) => {
+    const definition = spec.components && spec.components.securitySchemes && spec.components.securitySchemes[name] || {};
+    return { name, type: definition.type || 'unknown', scheme: definition.scheme, bearerFormat: definition.bearerFormat };
+  }));
+  const headers = (operation.parameters || []).filter((parameter) =>
+    parameter.in === 'header' && AUTH_HEADER_NAMES.has(String(parameter.name).toLowerCase())
+  );
+  return { schemes, headers };
+}
+
+function printAuthentication(operation, spec) {
+  const auth = authenticationFor(operation, spec);
+  if (!auth.schemes.length && !auth.headers.length) {
+    console.log('  Authentication: no requirement declared in the bundled OpenAPI.');
+    return;
+  }
+  console.log('  Authentication:');
+  for (const scheme of auth.schemes) {
+    const detail = [scheme.type, scheme.scheme, scheme.bearerFormat].filter(Boolean).join(', ');
+    console.log(`    security scheme ${scheme.name}${detail ? ` (${detail})` : ''}`);
+  }
+  for (const header of auth.headers) {
+    console.log(`    header ${header.name}: ${schemaType(header.schema, spec)}${header.required ? ' (required)' : ' (optional)'}${schemaNotes(header)}`);
+  }
+}
+
+function printOperation(item, spec) {
+  console.log(`\n${item.method} ${item.route}${item.summary ? `  ${item.summary}` : ''}`);
+  if (item.operationId) console.log(`  Operation: ${item.operationId}`);
+  printAuthentication(item.operation, spec);
+
+  const parameters = (item.operation.parameters || []).filter((parameter) =>
+    !(parameter.in === 'header' && AUTH_HEADER_NAMES.has(String(parameter.name).toLowerCase()))
+  );
+  if (parameters.length) {
+    console.log('  Parameters:');
+    for (const parameter of parameters) {
+      console.log(`    ${parameter.in} ${parameter.name}: ${schemaType(parameter.schema, spec)}${parameter.required ? ' (required)' : ' (optional)'}${schemaNotes(parameter)}`);
+    }
+  }
+
+  if (item.operation.requestBody) {
+    console.log(`  Request body: ${item.operation.requestBody.required ? 'required' : 'optional'}`);
+    for (const [contentType, media] of Object.entries(item.operation.requestBody.content || {})) {
+      console.log(`    ${contentType}:`);
+      printSchema(media.schema, spec, '      ');
+    }
+  }
+
+  const responses = Object.entries(item.operation.responses || {});
+  if (responses.length) {
+    console.log('  Responses:');
+    for (const [status, response] of responses) {
+      console.log(`    ${status}${response.description ? ` ${response.description}` : ''}`);
+      for (const [contentType, media] of Object.entries(response.content || {})) {
+        console.log(`      ${contentType}:`);
+        printSchema(media.schema, spec, '        ');
+      }
+    }
+  }
+}
 
 function apiCommand(positional, flags = {}) {
   const keyword = String(positional.join(' ') || '').trim().toLowerCase();
@@ -26,7 +157,7 @@ function apiCommand(positional, flags = {}) {
   const matches = [];
   for (const [route, methods] of Object.entries(spec.paths || {})) {
     for (const [method, operation] of Object.entries(methods || {})) {
-      if (!['get', 'post', 'put', 'patch', 'delete', 'head', 'options'].includes(method.toLowerCase())) continue;
+      if (!HTTP_METHODS.has(method.toLowerCase())) continue;
       const haystack = [route, method, operation.summary, operation.operationId, ...(operation.tags || [])]
         .filter(Boolean).join(' ').toLowerCase();
       if (!words.every((word) => haystack.includes(word))) continue;
@@ -36,23 +167,37 @@ function apiCommand(positional, flags = {}) {
         summary: operation.summary || '',
         operationId: operation.operationId || '',
         tags: operation.tags || [],
+        operation,
       });
     }
   }
 
   if (flags.output === 'json') {
-    console.log(JSON.stringify(matches, null, 2));
+    console.log(JSON.stringify({
+      source: {
+        kind: 'DraftGo bundled base OpenAPI',
+        openapi: spec.openapi || null,
+        version: spec.info && spec.info.version || null,
+        customServiceRoutes: {
+          included: false,
+          reason: 'Custom service routes are registered dynamically from local app.Route calls.',
+          derive: '<METHOD> /api/x/<slug><route-path>',
+        },
+      },
+      query: keyword,
+      matches,
+    }, null, 2));
     return matches.length ? 0 : 1;
   }
   if (!matches.length) {
     log.warn(`未找到包含“${keyword}”的 API。`);
     return 1;
   }
-  log.title(`draftgo api — ${keyword}`);
-  for (const item of matches.slice(0, 50)) {
-    console.log(`  ${item.method.padEnd(7)} ${item.route}${item.summary ? `  ${item.summary}` : ''}`);
-  }
-  if (matches.length > 50) log.dim(`  仅显示前 50 条，共 ${matches.length} 条；使用 --output json 获取完整结果。`);
+  log.title(`DraftGo base API — ${keyword}`);
+  log.dim(`Source: bundled DraftGo base OpenAPI v${spec.info && spec.info.version || 'unknown'}; these are platform APIs, not project-defined APIs.`);
+  log.dim('Custom service routes are not indexed here: derive them from local app.Route calls as <METHOD> /api/x/<slug><route-path>.');
+  for (const item of matches.slice(0, 50)) printOperation(item, spec);
+  if (matches.length > 50) log.dim(`\nOnly the first 50 of ${matches.length} matches are shown; use --output json for all contracts.`);
   return 0;
 }
 

package/src/commands/help.js

@@ -14,32 +14,25 @@ The CLI is the workbench layer for local runtime, resource sync, checks, and pus
 Usage:
   draftgo init [<target>...]       Install skill. No target = auto-detect.
                                     Use "all" to install every target.
-  draftgo update [<target>...]     Atomically update skill + entry files.
-                                    Reports newer CLI versions without
-                                    modifying the global installation.
+  draftgo update [<target>...]     Fully update the global CLI, then atomically
+                                    refresh skill + entry files.
   draftgo uninstall <target|all>   Remove entry files for target(s).
                                     Use explicit "all" to remove every target.
                                     --purge also removes .draftgo/ (runtime data).
   draftgo status                   Show installed targets and skill version.
-  draftgo doctor                   Diagnose environment (python, targets,
-                                    CLI freshness).
-  draftgo upgrade                  Explicitly upgrade the global CLI, then
-                                    refresh installed skill files.
   draftgo map                      Print a local DraftGo project resource map
                                     for fast AI orientation.
-  draftgo check                    Check local resource closure: routes,
-                                    entry binding, files, mock/color risks.
+  draftgo check                    Check page entry binding, page/navigation
+                                    HTML parsing, and unregistered local files.
   draftgo verify-ui <url>          Run a deterministic browser smoke check.
                                     Uses one viewport and screenshots on failure.
-  draftgo api <keyword>            Search the bundled OpenAPI specification.
-  draftgo dev                      Run this project's npm dev script.
-  draftgo build                    Run this project's npm build script.
-  draftgo new <type> <slug>        Scaffold a new resource locally (no network).
-                                    Creates template file + index.json entry.
-                                    Types: page | nav | db_meta | script | doc
+  draftgo api <keyword>            Search DraftGo base APIs and show request/
+                                    response/authentication contracts.
+                                    Custom service routes come from app.Route;
+                                    they are not part of the bundled OpenAPI.
   draftgo delete <type> <id>       Delete resource from server + local index.
                                     Types: pages | nav | db_meta | custom_scripts
-                                           | docs | doc_categories
+                                           | docs | doc_categories | aihub
                                     Alias: del, rm. Flags: --yes / -y skip confirm.
   draftgo pull [type] [id...]      Pull DraftGo resources via the bundled
                                     sync script. Defaults to --all.
@@ -50,24 +43,27 @@ Usage:
   draftgo auto-push [type] [id...] Run check, then push only when
                                     config.auto_push is true.
                                     Supports --batch <type> <ids> ... too.
-  draftgo local up|down|logs|status
+  draftgo local setup|start|stop|logs|status
                                     Manage .draftgo/docker/docker-compose.yaml
-                                    generated by draftgo local-dev.
+                                    generated by local setup. up/down remain
+                                    compatible aliases for start/stop.
   draftgo list-targets             List supported AI tools.
   draftgo connect                  Bind this project to an existing DraftGo
                                     server. Prompts for BaseURL + access
                                     token (or pass --server / --token).
-  draftgo local-dev                One-click local DraftGo stack via Docker
-                                    (MySQL + Redis + app). Generates
-                                    <project>/.draftgo/docker/docker-compose.yaml
-                                    with random secrets, then guides you to
-                                    finish setup and paste an access token.
+  draftgo local setup              One-click local DraftGo stack via Docker
+                                    (shared MySQL, Redis, Milvus + app). It
+                                    generates an app-only project compose,
+                                    <project>/.draftgo/docker/docker-compose.yaml,
+                                    then guides you to finish setup and paste
+                                    an access token.
+  draftgo local-dev                Compatibility alias for \`draftgo local setup\`.
   draftgo -v | --version           Print CLI version.
   draftgo -h | --help              Show this help.
 
 v3 Workbench:
-  draftgo local up|down|logs       Local stack lifecycle commands.
-  draftgo dev|build|check          Project workflow gates.
+  draftgo local start|stop|logs    Local stack lifecycle commands.
+  draftgo check                    Local resource closure gate.
   draftgo pull|push                First-class resource sync wrappers.
 
 Flags:
@@ -77,7 +73,7 @@ Flags:
   --skip-update-check      Do not contact npm to check for a newer CLI.
   --yes                    Assume "yes" for interactive prompts.
   --connect                (init) Skip the prompt and run \`draftgo connect\`.
-  --local-dev              (init) Skip the prompt and run \`draftgo local-dev\`.
+  --local-dev              (init) Skip the prompt and run \`draftgo local setup\`.
   --no-setup               (init) Don't offer either flow after installing.
   --server <url>           (connect) Provide the DraftGo BaseURL non-interactively.
   --token <sat>            (connect) Provide the access token non-interactively.
@@ -101,10 +97,9 @@ Examples:
   draftgo init claudecode      # install for Claude Code only
   draftgo init claudecode kiro # install for both
   draftgo init all             # install for every supported target
-  draftgo update               # refresh skill and report newer CLI versions
-  draftgo upgrade              # explicitly upgrade CLI and refresh skill
+  draftgo update               # fully update CLI and installed skills
   draftgo map                  # inspect pages/nav/db/scripts before development
-  draftgo check --strict       # fail on closure warnings before push
+  draftgo check --strict       # fail on any resource-check warning before push
   draftgo verify-ui http://localhost:5173 --mobile-check auto
   draftgo uninstall all --purge # full removal incl. runtime data
 `);

package/src/commands/init.js

@@ -12,8 +12,8 @@ const { ask } = require('../prompt');
 function warnIfNoPython() {
   const py = findPython();
   if (!py) {
-    log.warn('Python 未检测到。DraftGo 的 init/sync 脚本需要 Python 3.9+。');
-    log.dim('  请安装 Python 3.9+ 后再运行 /draftgo init 子技能。');
+    log.warn('Python 未检测到。DraftGo 资源同步需要 Python 3.9+。');
+    log.dim('  安装 Python 3.9+ 后运行 `draftgo pull` 获取项目资源。');
   } else {
     log.dim(`  detected ${py.bin} (${py.version})`);
   }
@@ -47,7 +47,7 @@ async function init(projectDir, positional, flags) {
 
   // 2) Render skill body into each target's own directory (no shared
   //    .draftgo/skill/ indirection anymore — each AI tool gets a real copy).
-  log.step('写入各 AI 工具 skill 目录（含 SKILL.md / 子技能 / rules / scripts）');
+  log.step('写入各 AI 工具 skill 目录（含 SKILL.md / 子技能 / references / scripts）');
   ensureRuntime(projectDir);
   const failures = [];
   let installedCount = 0;
@@ -101,29 +101,28 @@ async function init(projectDir, positional, flags) {
       return await require('./localDev')(projectDir, [], flags);
     }
     if (interactive) {
-      log.title('未检测到 DraftGo 服务器配置');
-      log.plain('选择一种方式完成绑定：');
-      log.plain(`  ${log.c.cyan('[1]')} 连接已有 DraftGo 服务器  ${log.c.gray('（输入 BaseURL + 系统访问令牌）')}`);
-      log.plain(`  ${log.c.cyan('[2]')} 进入本地开发模式          ${log.c.gray('（没部署基座，用 Docker 一键启动）')}`);
-      log.plain(`  ${log.c.cyan('[3]')} 稍后再说`);
-      const choice = (await ask('请选择 [1/2/3]', { default: '1' })).trim();
-      if (choice === '1') {
+      log.title('选择 DraftGo 基座处理方式');
+      log.plain(`  ${log.c.cyan('[A]')} 连接基座服务`);
+      log.dim('      使用已有 DraftGo 服务，接下来输入 BaseURL 和系统访问令牌。');
+      log.plain(`  ${log.c.cyan('[B]')} 本地启动基座`);
+      log.dim('      使用 Docker 启动 DraftGo；按需准备共享的 MySQL、Redis 和 Milvus。');
+      log.plain(`  ${log.c.cyan('[C]')} 稍后自行处理`);
+      log.dim('      仅安装 Skill，不写入服务配置，也不创建容器。');
+      const choice = (await ask('请选择 [A/B/C]', { default: 'C' })).trim().toUpperCase();
+      if (choice === 'A') {
         return await require('./connect')(projectDir, [], flags);
       }
-      if (choice === '2') {
-        return await require('./localDev')(projectDir, [], flags);
+      if (choice === 'B') {
+        return await require('./localDev')(projectDir, [], { ...flags, yes: true });
       }
-      if (choice !== '3') {
-        log.warn('Invalid choice; skipped server setup. Run `draftgo connect` or `draftgo local-dev` later.');
+      if (choice !== 'C') {
+        log.warn('无效选择，已跳过基座处理。');
       }
     }
   }
 
   log.title('完成');
-  log.plain('下一步：在你的 AI 工具里说「初始化 draftgo 项目」，它会引导你配置服务器和 token。');
-  log.dim('或直接运行：');
-  log.dim('  draftgo connect              # 连接已有 DraftGo 服务器');
-  log.dim('  draftgo local-dev            # 本地一键部署 DraftGo');
+  log.plain(hasConfig ? 'Skill 已安装，项目已连接 DraftGo。' : 'Skill 已安装。');
   return 0;
 }
 

package/src/commands/local.js

@@ -5,6 +5,7 @@ const { spawnSync } = require('child_process');
 const log = require('../logger');
 const { exists } = require('../fsx');
 const { detectDocker } = require('../localdev/detect');
+const { runWizard } = require('../localdev');
 
 function composeFile(projectDir) {
   return path.join(projectDir, '.draftgo', 'docker', 'docker-compose.yaml');
@@ -22,7 +23,7 @@ function runCompose(projectDir, args, stdio = 'inherit') {
   const file = composeFile(projectDir);
   if (!exists(file)) {
     log.err('未找到 .draftgo/docker/docker-compose.yaml。');
-    log.dim('  请先运行 `draftgo local-dev` 生成本地 DraftGo stack。');
+    log.dim('  请先运行 `draftgo local setup` 生成本地 DraftGo stack。');
     return 1;
   }
 
@@ -34,13 +35,17 @@ function runCompose(projectDir, args, stdio = 'inherit') {
   return r.status || 0;
 }
 
-function local(projectDir, positional) {
+function local(projectDir, positional, flags = {}) {
   const action = positional[0] || 'status';
 
   switch (action) {
+    case 'setup':
+      return runWizard(projectDir, { yes: !!(flags.yes || flags.y) });
     case 'up':
+    case 'start':
       return runCompose(projectDir, ['up', '-d']);
     case 'down':
+    case 'stop':
       return runCompose(projectDir, ['down']);
     case 'logs':
       return runCompose(projectDir, ['logs', ...(positional.slice(1).length ? positional.slice(1) : ['-f', 'app'])]);
@@ -49,7 +54,8 @@ function local(projectDir, positional) {
       return runCompose(projectDir, ['ps']);
     default:
       log.err(`未知 local 子命令：${action}`);
-      log.dim('  可用：draftgo local up | down | logs | status');
+      log.dim('  可用：draftgo local setup | start | stop | logs | status');
+      log.dim('  兼容别名：up | down');
       return 1;
   }
 }

package/src/commands/sync.js

@@ -35,7 +35,7 @@ function sync(projectDir, command, positional, flags = {}) {
 
   if (!exists(path.join(projectDir, '.draftgo', 'config.json'))) {
     log.err('未找到 .draftgo/config.json。');
-    log.dim('  请先运行 `draftgo connect` 或 `/draftgo init`。');
+    log.dim('  请先运行 `draftgo connect`。');
     return 1;
   }
 

package/src/commands/update.js

@@ -1,35 +1,63 @@
 'use strict';
 
+const { spawnSync } = require('child_process');
 const log = require('../logger');
 const { all, byName, resolveTargets } = require('../installers');
 const { ensureRuntime, writeInstalledVersion, readInstalledVersion, getPackageVersion } = require('../skill');
 const { fetchLatestVersion, cmpSemver } = require('../updateCheck');
 const { detectTargets } = require('../detect');
 
-async function reportAvailableUpgrade(flags) {
-  if (flags['skip-update-check'] || process.env.DRAFTGO_NO_UPDATE_CHECK === '1') return;
+const REENTRY_FLAG = 'DRAFTGO_UPDATE_REENTERED';
+
+async function updateCliIfNeeded(projectDir, positional, flags) {
+  if (process.env[REENTRY_FLAG] === '1' || flags['skip-update-check'] || process.env.DRAFTGO_NO_UPDATE_CHECK === '1') {
+    return null;
+  }
   const current = getPackageVersion();
-  const latest = await fetchLatestVersion();
+  const latest = await fetchLatestVersion(5000, { force: true });
   if (!latest) {
-    log.dim('  （查询最新版失败，按当前 CLI 继续）');
-    return;
+    log.warn('无法查询 npm 最新版本；将用当前 CLI 刷新 skill。');
+    return null;
   }
-  if (cmpSemver(latest, current) > 0) {
-    log.warn(`draftgo-cli 有新版：${current} → ${latest}`);
-    log.dim('  运行 `draftgo upgrade` 可显式升级；本次继续使用当前版本刷新 skill。');
-  } else {
+  if (cmpSemver(latest, current) <= 0) {
     log.dim(`  CLI 已是最新（${current}）`);
+    return null;
+  }
+
+  const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+  log.step(`更新 draftgo-cli：${current} → ${latest}`);
+  const install = spawnSync(npm, ['install', '-g', `draftgo-cli@${latest}`], { stdio: 'inherit', shell: false });
+  if (install.error) {
+    log.err(`CLI 更新启动失败：${install.error.message}`);
+    return 1;
   }
+  if (install.status !== 0) {
+    log.err(`npm install 返回码 ${install.status}`);
+    return Number.isInteger(install.status) ? install.status : 1;
+  }
+
+  const command = process.platform === 'win32' ? 'draftgo.cmd' : 'draftgo';
+  const rerun = spawnSync(command, ['update', ...positional, '--project', projectDir, '--skip-update-check'], {
+    stdio: 'inherit',
+    shell: false,
+    env: { ...process.env, [REENTRY_FLAG]: '1' },
+  });
+  if (rerun.error) {
+    log.err(`新版 CLI 刷新 skill 失败：${rerun.error.message}`);
+    return 1;
+  }
+  return Number.isInteger(rerun.status) ? rerun.status : 1;
 }
 
 async function update(projectDir, positional, flags) {
   log.title('draftgo update');
 
+  const reentryCode = await updateCliIfNeeded(projectDir, positional, flags);
+  if (reentryCode !== null) return reentryCode;
+
   const prev = readInstalledVersion(projectDir);
   log.info(`当前已装 skill：${prev || '未安装'}，CLI 版本：${getPackageVersion()}`);
 
-  await reportAvailableUpgrade(flags);
-
   // Determine which entry files to refresh:
   //   - no positional → refresh installed targets plus project-level tool signals
   //   - "all"          → refresh every known target
@@ -84,4 +112,4 @@ async function update(projectDir, positional, flags) {
 }
 
 module.exports = update;
-module.exports.reportAvailableUpgrade = reportAvailableUpgrade;
+module.exports.updateCliIfNeeded = updateCliIfNeeded;

package/src/index.js

@@ -2,10 +2,17 @@
 
 const path = require('path');
 const { parse } = require('./cli');
+const { resolveCommand } = require('./commandRegistry');
 const log = require('./logger');
 
 async function run(argv) {
-  const { command, positional, flags } = parse(argv);
+  const { command, positional, flags, errors } = parse(argv);
+
+  if (errors.length) {
+    for (const error of errors) log.err(error);
+    require('./commands/help')();
+    return 1;
+  }
 
   // --version / --help shortcuts
   if (flags.version || flags.v || command === 'version') {
@@ -22,62 +29,11 @@ async function run(argv) {
     : process.cwd();
 
   try {
-    switch (command) {
-      case 'init':
-        return await require('./commands/init')(projectDir, positional, flags);
-      case 'update':
-        return await require('./commands/update')(projectDir, positional, flags);
-      case 'uninstall':
-      case 'remove':
-        return await require('./commands/uninstall')(projectDir, positional, flags);
-      case 'status':
-        return require('./commands/status')(projectDir);
-      case 'doctor':
-        return await require('./commands/doctor')(projectDir, flags);
-      case 'upgrade':
-        return await require('./commands/upgrade')(projectDir, positional, flags);
-      case 'map':
-        return require('./commands/map')(projectDir, flags);
-      case 'check':
-        return require('./commands/check')(projectDir, flags);
-      case 'verify-ui':
-      case 'verifyui':
-        return await require('./commands/verifyUi')(projectDir, positional, flags);
-      case 'api':
-        return require('./commands/api')(positional, flags);
-      case 'dev':
-      case 'build':
-        return require('./commands/projectScript')(projectDir, command, flags);
-      case 'new':
-        return require('./commands/new')(projectDir, positional, flags);
-      case 'delete':
-      case 'del':
-      case 'rm':
-        return await require('./commands/delete')(projectDir, positional, flags);
-      case 'deploy':
-        return require('./commands/deploy')(projectDir, positional, flags);
-      case 'auto-push':
-      case 'autopush':
-        return require('./commands/autoPush')(projectDir, positional, flags);
-      case 'pull':
-      case 'push':
-        return require('./commands/sync')(projectDir, command, positional, flags);
-      case 'local':
-        return require('./commands/local')(projectDir, positional, flags);
-      case 'list-targets':
-      case 'targets':
-        return require('./commands/listTargets')();
-      case 'local-dev':
-      case 'localdev':
-        return await require('./commands/localDev')(projectDir, positional, flags);
-      case 'connect':
-      case 'login':
-        return await require('./commands/connect')(projectDir, positional, flags);
-      default:
-        log.err(`未知命令：${command}`);
-        require('./commands/help')();
-        return 1;
-    }
+    const definition = resolveCommand(command);
+    if (definition) return await definition.run(projectDir, positional, flags);
+    log.err(`未知命令：${command}`);
+    require('./commands/help')();
+    return 1;
   } catch (e) {
     log.err(e.message || String(e));
     if (process.env.DEBUG) console.error(e.stack);