speccore 6.38.0 → 6.40.0

package/dist/core/analyze-engine.js

@@ -1642,13 +1642,65 @@ async function detectPlatformsFromConstitution() {
  * 用于 analyze --auto 模式，替代 init 创建的空模板。
  */
 async function generateSpecsFromRequirements(reqPaths, iteration, specDir) {
-    // 1. 读取所有需求内容
+    // 1. 【增强】读取所有需求内容，并按端分类
+    const platforms = await detectPlatformsFromConstitution(); // 【提前定义】
     const allContent = [];
+    const platformFileMap = {}; // platform -> [file paths]
+    const unclassifiedFiles = []; // 无法分类的文件
     for (const p of reqPaths) {
         if (await (0, fs_extra_1.pathExists)(p)) {
-            allContent.push(await (0, fs_extra_1.readFile)(p, 'utf-8'));
+            const content = await (0, fs_extra_1.readFile)(p, 'utf-8');
+            // 【新增】尝试从文件路径或内容中推断所属的端
+            const inferredPlatform = inferPlatformFromPathOrContent(p, content, platforms);
+            if (inferredPlatform) {
+                // ✅ 端专属文档：不加入全局内容，只记录到平台映射
+                if (!platformFileMap[inferredPlatform]) {
+                    platformFileMap[inferredPlatform] = [];
+                }
+                platformFileMap[inferredPlatform].push(p);
+                logger_1.logger.info(`   📄 检测到 ${p} 属于 ${inferredPlatform} 端（端专属文档）`);
+            }
+            else {
+                // ❓ 无法推断，检查是否为跨端通用文档
+                const fileName = p.split(/[/\\]/).pop() || '';
+                const isGlobalDoc = fileName.toUpperCase().includes('REQUIREMENT') ||
+                    fileName.toUpperCase().includes('INDEX') ||
+                    fileName.toUpperCase().includes('PRD');
+                if (isGlobalDoc) {
+                    // ✅ 跨端通用文档：加入全局内容
+                    allContent.push(content);
+                    logger_1.logger.info(`   📄 ${fileName} 识别为跨端通用文档`);
+                }
+                else {
+                    // ⚠️ 无法分类的非通用文档
+                    unclassifiedFiles.push({ path: p, content });
+                    logger_1.logger.warn(`   ⚠️ 无法自动识别 ${p} 所属的端`);
+                }
+            }
         }
     }
+    // 【新增】如果有无法分类的文件，给出处理建议
+    if (unclassifiedFiles.length > 0) {
+        logger_1.logger.info('');
+        logger_1.logger.info(`   ❓ 发现 ${unclassifiedFiles.length} 个文档无法自动识别所属端`);
+        logger_1.logger.info(`   💡 可用端列表: ${platforms.join(', ')}`);
+        logger_1.logger.info('');
+        for (const file of unclassifiedFiles) {
+            const fileName = file.path.split(/[/\\]/).pop() || file.path;
+            logger_1.logger.info(`   📄 ${fileName}`);
+            // 检查是否有全局的 REQUIREMENT.md 或 INDEX.md，这些通常是跨端的
+            if (fileName.toUpperCase().includes('REQUIREMENT') ||
+                fileName.toUpperCase().includes('INDEX') ||
+                fileName.toUpperCase().includes('PRD')) {
+                logger_1.logger.info(`      → 假设为跨端通用文档，内容将合并到全局分析中`);
+            }
+            else {
+                logger_1.logger.info(`      → 未指定端，将在生成端专属文档时使用占位符`);
+                logger_1.logger.info(`      → 后续可运行: speccore ask "将 ${fileName} 标注为 [端名] 端"`);
+            }
+        }
+        logger_1.logger.info('');
+    }
     const fullContent = allContent.join('\n\n---\n\n');
     if (fullContent.trim().length < 20) {
         logger_1.logger.warn('   ⚠️ 需求文档内容过少，无法生成有效 Spec 文件');
@@ -1661,8 +1713,26 @@ async function generateSpecsFromRequirements(reqPaths, iteration, specDir) {
     const businessRules = extractBusinessRules(fullContent);
     const uiPatterns = extractUIPatterns(fullContent);
     const archImpact = await analyzeArchitectureImpact(fullContent);
-    const platforms = await detectPlatformsFromConstitution();
+    // const platforms 已在前面定义
     const now = new Date().toISOString().split('T')[0];
+    // 3. 【新增】按端分割需求内容，为每个端单独提取专属信息
+    // 【修复】不仅要分割全局内容，还要合并端专属文件的内容
+    const platformContents = splitContentByPlatform(fullContent, platforms);
+    // 合并端专属文件的内容
+    for (const [platform, filePaths] of Object.entries(platformFileMap)) {
+        let platformContent = platformContents[platform] || '';
+        for (const filePath of filePaths) {
+            const content = await (0, fs_extra_1.readFile)(filePath, 'utf-8');
+            if (platformContent) {
+                platformContent += '\n\n---\n\n' + content;
+            }
+            else {
+                platformContent = content;
+            }
+        }
+        platformContents[platform] = platformContent;
+    }
+    logger_1.logger.info(`   🔍 已按端分割需求内容: ${Object.keys(platformContents).length} 个端有专属内容`);
     // 3. 生成各 Spec 文件
     const files = [];
     // ── 全局文档（跨端通用）──
@@ -1703,7 +1773,7 @@ async function generateSpecsFromRequirements(reqPaths, iteration, specDir) {
         const platformDir = (0, path_1.join)(specDir, platform);
         await (0, fs_extra_1.ensureDir)(platformDir);
         // TECH.md — 该端技术方案
-        const techContent = buildTechSpecForPlatform(iteration, now, apis, dataModels, archImpact, platform, features, uiPatterns);
+        const techContent = buildTechSpecForPlatform(iteration, now, apis, dataModels, archImpact, platform, features, uiPatterns, platformContents);
         await (0, fs_extra_1.writeFile)((0, path_1.join)(platformDir, 'TECH.md'), techContent);
         // TEST.md — 该端测试计划
         const testContent = buildTestSpecForPlatform(iteration, now, features, apis, platform);
@@ -1970,7 +2040,7 @@ function buildTechSpec(iter, now, apis, models, archImpact, platforms, features,
 /**
  * 生成指定端的技术方案（该端专属内容）
  */
-function buildTechSpecForPlatform(iter, now, apis, models, archImpact, platform, features, uiPatterns) {
+function buildTechSpecForPlatform(iter, now, apis, models, archImpact, platform, features, uiPatterns, platformContents) {
     let md = `# ${platform} 端技术方案\n\n> 迭代: ${iter} | 端: ${platform} | 生成: ${now}\n\n`;
     if (isBackendPlatform(platform)) {
         // 后端专属内容
@@ -2003,7 +2073,12 @@ function buildTechSpecForPlatform(iter, now, apis, models, archImpact, platform,
             platformPages.forEach(p => { md += `| ${p.name} | \`${p.route}\` | ${p.desc} |\n`; });
         }
         else {
+            // 【增强】添加智能填充提示
             md += `_待补充：从需求中提取 ${platform} 端的页面清单。_\n`;
+            md += `\n> 💡 **如何填充**：\n`;
+            md += `> 1. 运行 \`speccore ask "为 ${platform} 端补充页面结构和组件设计"\`\n`;
+            md += `> 2. AI 会读取 010-requirements/ 中「${platform} 端需求」章节，自动提取页面清单\n`;
+            md += `> 3. 或手动编辑此文件，参考需求文档中的功能描述\n`;
         }
         md += `\n## 2. 组件设计\n\n`;
         const platformComponents = uiPatterns.components.filter(c => c.page.includes(platform) || c.type.includes(platform));
@@ -2384,4 +2459,131 @@ function guessModule(apiPath, features) {
     }
     return segments[1] || '—';
 }
+// ============================================================
+// 【新增】按端分割需求内容
+// ============================================================
+/**
+ * 将需求文档按端分割，提取每个端的专属内容
+ * @param fullContent 完整的需求文档内容
+ * @param platforms CONSTITUTION.md 定义的端列表
+ * @returns Record<platform, content> 每个端的专属内容
+ */
+function splitContentByPlatform(fullContent, platforms) {
+    const result = {};
+    const lines = fullContent.split('\n');
+    // 1. 识别端标题的正则模式（支持多种写法）
+    const platformPatterns = platforms.map(p => ({
+        platform: p,
+        // 匹配: "## APP 端需求" / "## H5端需求" / "## Admin 端" / "## miniapp"
+        regex: new RegExp(`^#{1,4}\\s*.*?(?:${p}|${p.toUpperCase()}|${p.charAt(0).toUpperCase() + p.slice(1)}).*?(?:端|需求|$)`, 'i')
+    }));
+    // 2. 扫描文档，找到每个端的起始位置
+    const platformStartLines = {};
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        for (const { platform, regex } of platformPatterns) {
+            if (regex.test(line) && !(platform in platformStartLines)) {
+                platformStartLines[platform] = i;
+            }
+        }
+    }
+    // 3. 提取每个端的内容（从该端标题到下一个端标题之前）
+    for (const platform of platforms) {
+        if (!(platform in platformStartLines))
+            continue;
+        const startLine = platformStartLines[platform];
+        let endLine = lines.length; // 默认到文档末尾
+        // 查找下一个端的起始位置
+        for (const [otherPlatform, otherStart] of Object.entries(platformStartLines)) {
+            if (otherPlatform !== platform && otherStart > startLine) {
+                endLine = Math.min(endLine, otherStart);
+            }
+        }
+        // 提取内容并去除 Markdown 标题标记
+        const content = lines.slice(startLine, endLine).join('\n');
+        result[platform] = content;
+    }
+    return result;
+}
+// ============================================================
+// 【新增】从文件路径或内容推断所属的端
+// ============================================================
+/**
+ * 端名语义映射表：将各种写法映射到标准端名
+ * 支持：中文端名、英文缩写、混合写法等
+ */
+const PLATFORM_ALIAS_MAP = {
+    // H5 移动端
+    'h5': ['h5', 'h5移动端', 'h5移动', 'mobile', '移动端', '手机浏览器', 'web mobile'],
+    // Admin 后台管理
+    'admin': ['admin', '后台管理端', '后台', '管理端', 'web', 'pc', '桌面端', '管理后台', 'dashboard'],
+    // App 客户端
+    'app': ['app', '客户端', 'ios', 'android', 'native', '原生', '移动端app', '手机app'],
+    // 小程序
+    'miniapp': ['miniapp', '小程序', '微信小程序', '支付宝小程序', 'miniprogram'],
+    // 后端服务
+    'backend': ['backend', '后端', '服务', 'api', 'server', '服务端', '微服务']
+};
+/**
+ * 根据文件路径或内容推断该文档属于哪个端
+ * @param filePath 文件路径
+ * @param content 文件内容
+ * @param platforms CONSTITUTION.md 定义的端列表
+ * @returns 推断出的端名，或 null（无法推断）
+ */
+function inferPlatformFromPathOrContent(filePath, content, platforms) {
+    // 1. 从文件路径推断（优先级最高）
+    const pathLower = filePath.toLowerCase();
+    // 检查路径中是否包含端名目录，如: 010-requirements/app/REQUIREMENT.md
+    for (const platform of platforms) {
+        const platformPatterns = [
+            new RegExp(`[/\\\\]${platform}[/\\\\]`, 'i'), // /app/ 或 \app\
+            new RegExp(`[/\\\\]${platform}-`, 'i'), // /app-xxx.md
+            new RegExp(`[/\\\\]${platform}_`, 'i'), // /app_xxx.md
+        ];
+        for (const pattern of platformPatterns) {
+            if (pattern.test(pathLower)) {
+                return platform;
+            }
+        }
+    }
+    // 检查文件名本身，如: app-requirement.md
+    const fileName = filePath.split(/[/\\]/).pop()?.toLowerCase() || '';
+    for (const platform of platforms) {
+        if (fileName.startsWith(platform + '-') ||
+            fileName.startsWith(platform + '_') ||
+            fileName.includes('-' + platform + '.') ||
+            fileName.includes('_' + platform + '.')) {
+            return platform;
+        }
+    }
+    // 【新增】2. 语义映射匹配：尝试将内容中的中文端名映射到标准端名
+    const firstLines = content.split('\n').slice(0, 50).join('\n');
+    for (const [standardPlatform, aliases] of Object.entries(PLATFORM_ALIAS_MAP)) {
+        // 只检查这个标准端名是否在 platforms 列表中
+        if (!platforms.includes(standardPlatform))
+            continue;
+        // 检查是否有别名出现在内容中
+        for (const alias of aliases) {
+            const aliasPattern = new RegExp(alias, 'i');
+            if (aliasPattern.test(firstLines)) {
+                logger_1.logger.info(`   🔄 语义映射: "${alias}" → "${standardPlatform}"`);
+                return standardPlatform;
+            }
+        }
+    }
+    // 3. 从文件内容推断（精确匹配标准端名）
+    for (const platform of platforms) {
+        const patterns = [
+            new RegExp(`^#{1,4}\\s*.*?(?:${platform}|${platform.toUpperCase()}|${platform.charAt(0).toUpperCase() + platform.slice(1)}).*?(?:端|需求)`, 'im'),
+            new RegExp(`(?:^|\n)>?.*?(?:${platform}|${platform.toUpperCase()}).*?(?:端|平台|前端|后端)`, 'im'),
+        ];
+        for (const pattern of patterns) {
+            if (pattern.test(firstLines)) {
+                return platform;
+            }
+        }
+    }
+    return null; // 无法推断
+}
 //# sourceMappingURL=analyze-engine.js.map