adspecs 0.1.19 → 0.1.21

package/src/lib/report.js

@@ -1,327 +1,338 @@
-'use strict';
-
-const chalk = require('chalk');
-const { areaDisplayName, decisionLabel, decisionIcon } = require('./area-scanner');
-
-/**
- * 报告生成
- *
- * 提供两种报告：
- * 1. 计划摘要（执行前）— 让用户确认即将执行的操作
- * 2. 最终详细报告（执行后）— 含表格、目录树、状态说明、后续步骤
- */
-
-// ============================================================
-// 模式标签
-// ============================================================
-
-function modeLabel(mode) {
-  const labels = {
-    simple: '简易模式',
-    classic: '经典模式',
-    full: '完整模式',
-    demo: '轻量模式',
-  };
-  return labels[mode] || mode;
-}
-
-function frontDemoLabel(frontDemo) {
-  if (frontDemo === 'antd') return 'Ant Design React';
-  if (frontDemo === 'vue') return 'Vue';
-  if (frontDemo === 'skip') return '跳过';
-  return frontDemo;
-}
-
-// ============================================================
-// 计划摘要（执行前）
-// ============================================================
-
-/**
- * 输出计划摘要
- *
- * @param {object} info - 项目信息
- * @param {object} decisions - 每区域决策
- * @param {object} subDecisions - 子目录决策
- * @param {object} modeUpgrade - 模式升级检测
- * @param {string} targetDir - 目标路径
- */
-function printPlanSummary(info, decisions, subDecisions, modeUpgrade, targetDir) {
-  console.log('');
-  console.log(chalk.bold('📋 初始化计划：'));
-  console.log('');
-  console.log(chalk.gray('   项目信息'));
-  console.log(`   项目名称:     ${chalk.green(info.project_name)}`);
-  console.log(`   项目短名称:   ${chalk.green(info.project_short_name)}`);
-  console.log(`   公司名称:     ${info.company_name}`);
-  console.log(`   文件密级:     ${info.confidentiality}`);
-  console.log(`   初始化模式:   ${chalk.yellow(modeLabel(info.mode))}`);
-
-  if (info.mode === 'classic' || info.mode === 'full') {
-    console.log(`   前端技术栈:   ${frontDemoLabel(info.frontDemo)}`);
-  }
-  if (info.mode === 'demo') {
-    console.log(`   前端技术栈:   ${frontDemoLabel('antd')} (固定)`);
-  }
-
-  console.log(`   目标路径:     ${chalk.blue(targetDir)}`);
-  console.log('');
-
-  // 区域操作预览
-  console.log(chalk.gray('   区域操作'));
-  const areaEntries = Object.entries(decisions);
-  const maxNameLen = Math.max(...areaEntries.map(([k]) => areaDisplayName(k).length));
-
-  for (const [areaKey, decision] of areaEntries) {
-    // frontDemo='skip' 覆盖决策显示
-    let displayDecision = decision;
-    let displayIcon = decisionIcon(decision);
-    let displayLabel = decisionLabel(decision);
-
-    if (areaKey === 'frontDemo' && info.frontDemo === 'skip') {
-      displayIcon = '⏭';
-      displayLabel = '跳过（用户选择不创建）';
-    }
-
-    const name = areaDisplayName(areaKey).padEnd(maxNameLen);
-    console.log(`   ${displayIcon} ${name}/  ${chalk.gray('→')}  ${displayLabel}`);
-
-    // 子决策预览
-    if (areaKey === 'docs' && decision === 'skip' && subDecisions.conventions !== 'skip') {
-      console.log(
-        `      ${chalk.gray('└')} 40-project_conventions/  ${chalk.gray('→')}  ${decisionLabel(subDecisions.conventions)}`
-      );
-    }
-    if (areaKey === 'adspecs' && decision === 'skip' && subDecisions.templates !== 'skip') {
-      console.log(
-        `      ${chalk.gray('└')} templates/  ${chalk.gray('→')}  ${decisionLabel(subDecisions.templates)}`
-      );
-    }
-  }
-
-  // 模式升级提示
-  if (modeUpgrade.detected) {
-    console.log('');
-    console.log(
-      chalk.yellow(
-        `   📦 模式升级检测：检测到 40-project_conventions/ 为空目录（简易模式产物），将自动补充 frontend-standard/`
-      )
-    );
-  }
-
-  console.log('');
-}
-
-// ============================================================
-// 最终详细报告（执行后）
-// ============================================================
-
-/**
- * 输出最终详细报告
- *
- * @param {object} report - scaffolder 返回的执行报告
- * @param {object} info - 项目信息
- * @param {object} decisions - 每区域决策
- * @param {object} subDecisions - 子目录决策
- * @param {object} modeUpgrade - 模式升级检测
- */
-function printFinalReport(report, info, decisions, subDecisions, modeUpgrade) {
-  console.log('');
-  console.log(chalk.green.bold('## 项目初始化完成 🎉'));
-  console.log('');
-
-  // 项目信息段
-  console.log(chalk.bold('项目名称:'), info.project_name);
-  console.log(chalk.bold('项目短名称:'), info.project_short_name);
-  console.log(chalk.bold('公司名称:'), info.company_name);
-  console.log(chalk.bold('文件密级:'), info.confidentiality);
-  console.log(chalk.bold('初始化模式:'), modeLabel(info.mode));
-  if (info.mode === 'classic' || info.mode === 'full' || info.mode === 'demo') {
-    const fdLabel = info.mode === 'demo' ? frontDemoLabel('antd') : frontDemoLabel(info.frontDemo);
-    console.log(chalk.bold('前端技术栈:'), fdLabel);
-  }
-  console.log(chalk.bold('目标路径:'), report.targetDir);
-  console.log('');
-
-  // 区域执行结果表格
-  console.log(chalk.bold('### 区域执行结果'));
-  console.log('');
-  console.log('   | 区域 | 状态 | 说明 |');
-  console.log('   | --- | --- | --- |');
-
-  for (const stage of report.stages) {
-    const icon = statusIcon(stage.status);
-    const detail = stageDetail(stage);
-    console.log(`   | ${stage.name} | ${icon} ${stage.status} | ${detail} |`);
-
-    // 子行：templates/
-    if (stage.name === '.adspecs/' && stage.subDecisions) {
-      if (stage.subDecisions.templates === 'update') {
-        console.log(`   | ${chalk.gray('└ templates/')} | ${chalk.green('🔄')} 已更新 | 从插件根目录覆盖更新 |`);
-      }
-    }
-
-    // 子行：feature.json
-    if (stage.name === '.adspecs/' && stage.featureResult) {
-      if (stage.featureResult.addedKeys && stage.featureResult.addedKeys.length > 0) {
-        console.log(
-          `   | ${chalk.gray('└ feature.json')} | ${chalk.yellow('🔧')} 已补全 | 补充缺失属性 [${stage.featureResult.addedKeys.join(', ')}] |`
-        );
-      }
-    }
-
-    // 子行：40-project_conventions/
-    if (stage.name === 'docs/' && stage.subDecisions) {
-      if (stage.subDecisions.conventions === 'update') {
-        console.log(
-          `   | ${chalk.gray('└ 40-project_conventions/')} | ${chalk.green('🔄')} 已更新 | 按前端技术栈覆盖更新 |`
-        );
-      }
-      if (stage.modeUpgrade && stage.modeUpgrade.detected) {
-        console.log(
-          `   | ${chalk.gray('└ 40-project_conventions/')} | ${chalk.yellow('📦')} 已补充 | 模式升级自动补充 frontend-standard/ |`
-        );
-      }
-    }
-  }
-
-  console.log('');
-
-  // 状态说明
-  console.log(chalk.bold('状态说明：'));
-  console.log('   ✅ 已创建 — 目录原本不存在，新建完成');
-  console.log('   🔄 已重建 — 目录原本存在，按用户选择删除后重新创建');
-  console.log('   🔄 已更新 — 父目录跳过，但子目录按用户选择使用最新文件覆盖');
-  console.log('   🔧 已补全 — 已有文件属性与 references 对比后，补充缺失属性');
-  console.log('   ⏭ 已跳过 — 目录原本存在，按用户选择保留未动');
-  console.log('');
-
-  // 目录树总览
-  console.log(chalk.bold('### 目录树总览'));
-  console.log('');
-  printDirectoryTree(info.mode, info.frontDemo);
-
-  // 后续步骤
-  console.log(chalk.bold('### 后续步骤'));
-  console.log('');
-  printNextSteps(info.mode, report.targetDir, info.frontDemo);
-}
-
-/**
- * 状态图标
- */
-function statusIcon(status) {
-  const icons = {
-    created: '✅',
-    recreated: '🔄',
-    updated: '🔄',
-    skipped: '⏭',
-    exists: '⏭',
-  };
-  return icons[status] || '❓';
-}
-
-/**
- * 阶段详情
- */
-function stageDetail(stage) {
-  if (stage.fileCount !== undefined) {
-    return `${stage.fileCount} 个文件`;
-  }
-  if (stage.reason) {
-    return stage.reason;
-  }
-  if (stage.detail && stage.detail.created) {
-    return '已创建';
-  }
-  return '';
-}
-
-/**
- * 按模式输出 ASCII 目录树
- */
-function printDirectoryTree(mode, frontDemo) {
-  const lines = [];
-  lines.push('   {targetDir}/');
-  lines.push('   ├── .adspecs/          （插件配置、脚本、模板 + project.json）');
-  lines.push('   ├── docs/              （11 个子目录）');
-  if (mode === 'classic' || mode === 'full' || mode === 'demo') {
-    lines.push('   │   └── 40-project_conventions/');
-    if (mode === 'demo') {
-      lines.push('   │       ├── frontend-standard/  （Ant Design React 前端规范）');
-      lines.push('   │       └── end-standard/       （Python 后端规范）');
-    } else {
-      const fdLabel = frontDemo === 'antd' ? 'Ant Design React' : 'Vue';
-      lines.push(`   │       └── frontend-standard/  （${fdLabel} 前端规范）`);
-    }
-  }
-  lines.push('   ├── wiki/              （基线文件目录）');
-
-  if (mode === 'full' || mode === 'demo') {
-    lines.push('   ├── web-ui/            （前端生产项目）');
-    lines.push('   ├── service/           （后端服务模块）');
-  }
-  if (mode === 'classic' || mode === 'full' || mode === 'demo') {
-    if (frontDemo !== 'skip') {
-      const fdLabel = frontDemo === 'antd' ? 'Ant Design React' : 'Vue';
-      lines.push(`   └── front-demo/        （${fdLabel} 前端演示项目）`);
-    }
-  }
-
-  if (mode === 'demo') {
-    lines.push('');
-    lines.push('   技术栈：Python + SQLite + React + Ant Design 6 全栈 demo');
-  }
-
-  console.log(lines.join('\n'));
-  console.log('');
-}
-
-/**
- * 按模式输出后续步骤
- */
-function printNextSteps(mode, targetDir, frontDemo = 'vue') {
-  if (mode === 'simple') {
-    console.log('   1. 执行 `git init` 初始化 Git 仓库');
-    console.log('   2. 根据需要调整 .adspecs/templates/ 下的文档模板');
-    console.log('   3. 根据需要编辑 .adspecs/project.json 补充公司 Logo 路径等信息');
-    console.log('   4. 执行 `adspecs plugin install` 注册 Claude Code 插件');
-  } else if (mode === 'classic') {
-    console.log('   1. 执行 `git init` 初始化 Git 仓库');
-    if (frontDemo !== 'skip') {
-      console.log('   2. 在前端演示目录执行 `npm install` 安装依赖：');
-      console.log(`      cd ${targetDir}/front-demo && npm install`);
-      console.log('   3. 根据需要调整文档模板和编码规范');
-      console.log('   4. 执行 `adspecs plugin install` 注册 Claude Code 插件');
-    } else {
-      console.log('   2. 根据需要调整文档模板和编码规范');
-      console.log('   3. 执行 `adspecs plugin install` 注册 Claude Code 插件');
-    }
-  } else if (mode === 'full') {
-    console.log('   1. 执行 `git init` 初始化 Git 仓库');
-    console.log('   2. 安装前端依赖：');
-    console.log(`      cd ${targetDir}/web-ui && npm install`);
-    if (frontDemo !== 'skip') {
-      console.log(`      cd ${targetDir}/front-demo && npm install`);
-    }
-    console.log('   3. 根据需要调整文档模板和编码规范');
-    console.log('   4. 执行 `adspecs plugin install` 注册 Claude Code 插件');
-  } else if (mode === 'demo') {
-    console.log('   1. 执行 `git init` 初始化 Git 仓库');
-    console.log('   2. 安装前端依赖：');
-    console.log(`      cd ${targetDir}/web-ui && npm install`);
-    console.log(`      cd ${targetDir}/front-demo && npm install`);
-    console.log('   3. 安装后端依赖（Python 环境）：');
-    console.log(`      cd ${targetDir}/service`);
-    console.log('      python -m venv venv && source venv/bin/activate  # Windows: venv\\Scripts\\activate');
-    console.log('      pip install -r requirements.txt');
-    console.log('   4. 执行 `adspecs plugin install` 注册 Claude Code 插件');
-  }
-  console.log('');
-}
-
-module.exports = {
-  printPlanSummary,
-  printFinalReport,
-  modeLabel,
-  frontDemoLabel,
-};
+'use strict';
+
+const chalk = require('chalk');
+const { areaDisplayName, decisionLabel, decisionIcon } = require('./area-scanner');
+
+/**
+ * 报告生成
+ *
+ * 提供两种报告：
+ * 1. 计划摘要（执行前）— 让用户确认即将执行的操作
+ * 2. 最终详细报告（执行后）— 含表格、目录树、状态说明、后续步骤
+ */
+
+// ============================================================
+// 模式标签
+// ============================================================
+
+function modeLabel(mode) {
+  const labels = {
+    simple: '简易模式',
+    classic: '经典模式',
+    full: '完整模式',
+    demo: '轻量模式',
+  };
+  return labels[mode] || mode;
+}
+
+function frontDemoLabel(frontDemo) {
+  if (frontDemo === 'antd') return 'Ant Design React';
+  if (frontDemo === 'vue') return 'Vue';
+  if (frontDemo === 'skip') return '跳过';
+  return frontDemo;
+}
+
+// ============================================================
+// 计划摘要（执行前）
+// ============================================================
+
+/**
+ * 输出计划摘要
+ *
+ * @param {object} info - 项目信息
+ * @param {object} decisions - 每区域决策
+ * @param {object} subDecisions - 子目录决策
+ * @param {object} modeUpgrade - 模式升级检测
+ * @param {string} targetDir - 目标路径
+ */
+function printPlanSummary(info, decisions, subDecisions, modeUpgrade, targetDir) {
+  console.log('');
+  console.log(chalk.bold('📋 初始化计划：'));
+  console.log('');
+  console.log(chalk.gray('   项目信息'));
+  console.log(`   项目名称:     ${chalk.green(info.project_name)}`);
+  console.log(`   项目短名称:   ${chalk.green(info.project_short_name)}`);
+  console.log(`   公司名称:     ${info.company_name}`);
+  console.log(`   文件密级:     ${info.confidentiality}`);
+  console.log(`   初始化模式:   ${chalk.yellow(modeLabel(info.mode))}`);
+
+  if (info.mode === 'classic' || info.mode === 'full') {
+    console.log(`   前端技术栈:   ${frontDemoLabel(info.frontDemo)}`);
+  }
+  if (info.mode === 'demo') {
+    console.log(`   前端技术栈:   ${frontDemoLabel('antd')} (固定)`);
+  }
+
+  console.log(`   目标路径:     ${chalk.blue(targetDir)}`);
+  console.log('');
+
+  // 区域操作预览
+  console.log(chalk.gray('   区域操作'));
+  const areaEntries = Object.entries(decisions);
+  const maxNameLen = Math.max(...areaEntries.map(([k]) => areaDisplayName(k).length));
+
+  for (const [areaKey, decision] of areaEntries) {
+    // frontDemo='skip' 覆盖决策显示
+    let displayDecision = decision;
+    let displayIcon = decisionIcon(decision);
+    let displayLabel = decisionLabel(decision);
+
+    if (areaKey === 'frontDemo' && info.frontDemo === 'skip') {
+      displayIcon = '⏭';
+      displayLabel = '跳过（用户选择不创建）';
+    }
+
+    const name = areaDisplayName(areaKey).padEnd(maxNameLen);
+    console.log(`   ${displayIcon} ${name}/  ${chalk.gray('→')}  ${displayLabel}`);
+
+    // 子决策预览
+    if (areaKey === 'docs' && decision === 'skip' && subDecisions.conventions !== 'skip') {
+      console.log(
+        `      ${chalk.gray('└')} 40-project_conventions/  ${chalk.gray('→')}  ${decisionLabel(subDecisions.conventions)}`
+      );
+    }
+    if (areaKey === 'adspecs' && decision === 'skip') {
+      const tmplMap = subDecisions.templates || {};
+      const tmplEntries = Object.entries(tmplMap);
+      const replaceCount = tmplEntries.filter(([, v]) => v === 'replace').length;
+      const keepCount = tmplEntries.filter(([, v]) => v === 'keep').length;
+      if (replaceCount > 0 || keepCount > 0) {
+        console.log(
+          `      ${chalk.gray('└')} templates/  ${chalk.gray('→')}  逐文件确认（${replaceCount} 个替换，${keepCount} 个保留）`
+        );
+      }
+    }
+  }
+
+  // 模式升级提示
+  if (modeUpgrade.detected) {
+    console.log('');
+    console.log(
+      chalk.yellow(
+        `   📦 模式升级检测：检测到 40-project_conventions/ 为空目录（简易模式产物），将自动补充 frontend-standard/`
+      )
+    );
+  }
+
+  console.log('');
+}
+
+// ============================================================
+// 最终详细报告（执行后）
+// ============================================================
+
+/**
+ * 输出最终详细报告
+ *
+ * @param {object} report - scaffolder 返回的执行报告
+ * @param {object} info - 项目信息
+ * @param {object} decisions - 每区域决策
+ * @param {object} subDecisions - 子目录决策
+ * @param {object} modeUpgrade - 模式升级检测
+ */
+function printFinalReport(report, info, decisions, subDecisions, modeUpgrade) {
+  console.log('');
+  console.log(chalk.green.bold('## 项目初始化完成 🎉'));
+  console.log('');
+
+  // 项目信息段
+  console.log(chalk.bold('项目名称:'), info.project_name);
+  console.log(chalk.bold('项目短名称:'), info.project_short_name);
+  console.log(chalk.bold('公司名称:'), info.company_name);
+  console.log(chalk.bold('文件密级:'), info.confidentiality);
+  console.log(chalk.bold('初始化模式:'), modeLabel(info.mode));
+  if (info.mode === 'classic' || info.mode === 'full' || info.mode === 'demo') {
+    const fdLabel = info.mode === 'demo' ? frontDemoLabel('antd') : frontDemoLabel(info.frontDemo);
+    console.log(chalk.bold('前端技术栈:'), fdLabel);
+  }
+  console.log(chalk.bold('目标路径:'), report.targetDir);
+  console.log('');
+
+  // 区域执行结果表格
+  console.log(chalk.bold('### 区域执行结果'));
+  console.log('');
+  console.log('   | 区域 | 状态 | 说明 |');
+  console.log('   | --- | --- | --- |');
+
+  for (const stage of report.stages) {
+    const icon = statusIcon(stage.status);
+    const detail = stageDetail(stage);
+    console.log(`   | ${stage.name} | ${icon} ${stage.status} | ${detail} |`);
+
+    // 子行：templates/（逐文件确认结果）
+    if (stage.name === '.adspecs/' && stage.subDecisions && stage.subDecisions.templates) {
+      const tmpl = stage.subDecisions.templates;
+      if (typeof tmpl === 'object' && (tmpl.replaced > 0 || tmpl.kept > 0 || tmpl.added > 0)) {
+        const parts = [];
+        if (tmpl.added > 0) parts.push(`${tmpl.added} 个新增`);
+        if (tmpl.replaced > 0) parts.push(`${tmpl.replaced} 个替换`);
+        if (tmpl.kept > 0) parts.push(`${tmpl.kept} 个保留`);
+        console.log(`   | ${chalk.gray('└ templates/')} | ${chalk.green('🔄')} 部分更新 | ${parts.join('，')} |`);
+      }
+    }
+
+    // 子行：feature.json
+    if (stage.name === '.adspecs/' && stage.featureResult) {
+      if (stage.featureResult.addedKeys && stage.featureResult.addedKeys.length > 0) {
+        console.log(
+          `   | ${chalk.gray('└ feature.json')} | ${chalk.yellow('🔧')} 已补全 | 补充缺失属性 [${stage.featureResult.addedKeys.join(', ')}] |`
+        );
+      }
+    }
+
+    // 子行：40-project_conventions/
+    if (stage.name === 'docs/' && stage.subDecisions) {
+      if (stage.subDecisions.conventions === 'update') {
+        console.log(
+          `   | ${chalk.gray('└ 40-project_conventions/')} | ${chalk.green('🔄')} 已更新 | 按前端技术栈覆盖更新 |`
+        );
+      }
+      if (stage.modeUpgrade && stage.modeUpgrade.detected) {
+        console.log(
+          `   | ${chalk.gray('└ 40-project_conventions/')} | ${chalk.yellow('📦')} 已补充 | 模式升级自动补充 frontend-standard/ |`
+        );
+      }
+    }
+  }
+
+  console.log('');
+
+  // 状态说明
+  console.log(chalk.bold('状态说明：'));
+  console.log('   ✅ 已创建 — 目录原本不存在，新建完成');
+  console.log('   🔄 已重建 — 目录原本存在，按用户选择删除后重新创建');
+  console.log('   🔄 已更新 — 父目录跳过，但子目录按用户选择使用最新文件覆盖（templates/ 支持逐文件确认，部分替换部分保留）');
+  console.log('   🔧 已补全 — 已有文件属性与 references 对比后，补充缺失属性');
+  console.log('   ⏭ 已跳过 — 目录原本存在，按用户选择保留未动');
+  console.log('');
+
+  // 目录树总览
+  console.log(chalk.bold('### 目录树总览'));
+  console.log('');
+  printDirectoryTree(info.mode, info.frontDemo);
+
+  // 后续步骤
+  console.log(chalk.bold('### 后续步骤'));
+  console.log('');
+  printNextSteps(info.mode, report.targetDir, info.frontDemo);
+}
+
+/**
+ * 状态图标
+ */
+function statusIcon(status) {
+  const icons = {
+    created: '✅',
+    recreated: '🔄',
+    updated: '🔄',
+    skipped: '⏭',
+    exists: '⏭',
+  };
+  return icons[status] || '❓';
+}
+
+/**
+ * 阶段详情
+ */
+function stageDetail(stage) {
+  if (stage.fileCount !== undefined) {
+    return `${stage.fileCount} 个文件`;
+  }
+  if (stage.reason) {
+    return stage.reason;
+  }
+  if (stage.detail && stage.detail.created) {
+    return '已创建';
+  }
+  return '';
+}
+
+/**
+ * 按模式输出 ASCII 目录树
+ */
+function printDirectoryTree(mode, frontDemo) {
+  const lines = [];
+  lines.push('   {targetDir}/');
+  lines.push('   ├── .adspecs/          （插件配置、脚本、模板 + project.json）');
+  lines.push('   ├── docs/              （11 个子目录）');
+  if (mode === 'classic' || mode === 'full' || mode === 'demo') {
+    lines.push('   │   └── 40-project_conventions/');
+    if (mode === 'demo') {
+      lines.push('   │       ├── frontend-standard/  （Ant Design React 前端规范）');
+      lines.push('   │       └── end-standard/       （Python 后端规范）');
+    } else {
+      const fdLabel = frontDemo === 'antd' ? 'Ant Design React' : 'Vue';
+      lines.push(`   │       └── frontend-standard/  （${fdLabel} 前端规范）`);
+    }
+  }
+  lines.push('   ├── wiki/              （基线文件目录）');
+
+  if (mode === 'full' || mode === 'demo') {
+    lines.push('   ├── web-ui/            （前端生产项目）');
+    lines.push('   ├── service/           （后端服务模块）');
+  }
+  if (mode === 'classic' || mode === 'full' || mode === 'demo') {
+    if (frontDemo !== 'skip') {
+      const fdLabel = frontDemo === 'antd' ? 'Ant Design React' : 'Vue';
+      lines.push(`   └── front-demo/        （${fdLabel} 前端演示项目）`);
+    }
+  }
+
+  if (mode === 'demo') {
+    lines.push('');
+    lines.push('   技术栈：Python + SQLite + React + Ant Design 6 全栈 demo');
+  }
+
+  console.log(lines.join('\n'));
+  console.log('');
+}
+
+/**
+ * 按模式输出后续步骤
+ */
+function printNextSteps(mode, targetDir, frontDemo = 'vue') {
+  if (mode === 'simple') {
+    console.log('   1. 执行 `git init` 初始化 Git 仓库');
+    console.log('   2. 根据需要调整 .adspecs/templates/ 下的文档模板');
+    console.log('   3. 根据需要编辑 .adspecs/project.json 补充公司 Logo 路径等信息');
+    console.log('   4. 执行 `adspecs plugin install` 注册 Claude Code 插件');
+  } else if (mode === 'classic') {
+    console.log('   1. 执行 `git init` 初始化 Git 仓库');
+    if (frontDemo !== 'skip') {
+      console.log('   2. 在前端演示目录执行 `npm install` 安装依赖：');
+      console.log(`      cd ${targetDir}/front-demo && npm install`);
+      console.log('   3. 根据需要调整文档模板和编码规范');
+      console.log('   4. 执行 `adspecs plugin install` 注册 Claude Code 插件');
+    } else {
+      console.log('   2. 根据需要调整文档模板和编码规范');
+      console.log('   3. 执行 `adspecs plugin install` 注册 Claude Code 插件');
+    }
+  } else if (mode === 'full') {
+    console.log('   1. 执行 `git init` 初始化 Git 仓库');
+    console.log('   2. 安装前端依赖：');
+    console.log(`      cd ${targetDir}/web-ui && npm install`);
+    if (frontDemo !== 'skip') {
+      console.log(`      cd ${targetDir}/front-demo && npm install`);
+    }
+    console.log('   3. 根据需要调整文档模板和编码规范');
+    console.log('   4. 执行 `adspecs plugin install` 注册 Claude Code 插件');
+  } else if (mode === 'demo') {
+    console.log('   1. 执行 `git init` 初始化 Git 仓库');
+    console.log('   2. 安装前端依赖：');
+    console.log(`      cd ${targetDir}/web-ui && npm install`);
+    console.log(`      cd ${targetDir}/front-demo && npm install`);
+    console.log('   3. 安装后端依赖（Python 环境）：');
+    console.log(`      cd ${targetDir}/service`);
+    console.log('      python -m venv venv && source venv/bin/activate  # Windows: venv\\Scripts\\activate');
+    console.log('      pip install -r requirements.txt');
+    console.log('   4. 执行 `adspecs plugin install` 注册 Claude Code 插件');
+  }
+  console.log('');
+}
+
+module.exports = {
+  printPlanSummary,
+  printFinalReport,
+  modeLabel,
+  frontDemoLabel,
+};