speccore 8.3.333 → 8.3.340

package/dist/commands/doc2spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doc2spec.d.ts","sourceRoot":"","sources":["../../src/commands/doc2spec.ts"],"names":[],"mappings":"AA4EA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAerF;AAyCD,eAGA,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS7C,CAAC;AAYF,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwD9E;AA2nBD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,EACpB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CA+Yf"}
+{"version":3,"file":"doc2spec.d.ts","sourceRoot":"","sources":["../../src/commands/doc2spec.ts"],"names":[],"mappings":"AA4EA;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAerF;AAyCD,eAGA,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS7C,CAAC;AAYF,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwD9E;AAyUD,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAEzD,sCAAsC;AACtC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAkBD,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAenG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,MAAM,GACf;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAqCzD;AA2XD,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,EAAE,SAAS,GAAG,aAAa,CAAC;CACrC;AAgDD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,EACpB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,IAAI,CAAC,CAgaf;AAsfD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,MAAM,EAAE,GACf;IAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAqBjE"}

package/dist/commands/doc2spec.js

@@ -3,7 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PANDOC_FORMAT_MAP = void 0;
 exports.fixImageRefs = fixImageRefs;
 exports.doc2specCommand = doc2specCommand;
+exports.buildTitleOutline = buildTitleOutline;
+exports.parseTitleRenames = parseTitleRenames;
+exports.applyTitleRenames = applyTitleRenames;
 exports.splitDocumentToUnits = splitDocumentToUnits;
+exports.filterUnitsByTitles = filterUnitsByTitles;
 /**
  * doc2spec — 文档导入 → SpecCore Markdown
  *
@@ -400,14 +404,26 @@ async function processSingle(options) {
         //    从 MD 文件位置解析是错的——统一转为相对 MD 文件的正斜杠路径
         const mdDir = (0, path_1.dirname)(outputPath);
         content = (0, markdown_image_1.imgTagsToMarkdown)(fixImageRefs(content, mdDir, (0, path_1.join)(iterDir, '010-requirements', 'assets', 'extracted')));
-        // 4. 接口表格检测 + 提示
+        // 4. 图片引用注释（告知 Task 如何引用这些图）
+        // v8.3.75+: 修正 Task 引用路径（从 030-tasks/Task-NNN/00-specs/ 出发需 ../../../）
+        content = content.replace(/^#/, `# ${platform || '通用'}需求\n\n<!-- \n  原型图片路径: 010-requirements/assets/extracted/\n  converted/ 引用方式: ![原型](../assets/extracted/xxx.png)\n  Task 引用方式: ![原型](../../../010-requirements/assets/extracted/xxx.png)\n  所有 Task 共享此目录，无需重复存放。\n-->\n\n#`);
+        // 5. AI 标题规范化（v8.3.335+ / v8.3.337 默认关闭）：产品原文档标题常不规范，
+        //     用户明确要求（--normalize 或「按标准文档转换」）时按 SpecCore 标准标题体系
+        //     AI 语义重写标题（正文一字不动，H1 文档标题也由 AI 给出）。
+        //     调整前版本快照到 backup/。--no-ai / --task 场景跳过；AI 不可用时静默降级不阻断
+        let normalizeReport = null;
+        if (options.normalize === true && options.ai !== false && !taskId) {
+            const result = await normalizeTitlesWithAI(content, platform || sourceBase, outputPath);
+            if (result) {
+                content = result.content;
+                normalizeReport = { applied: result.applied, skipped: result.skipped.length, backupPath: result.backupPath };
+            }
+        }
+        // 6. 接口表格检测 + 提示
         const hasInterfaceTable = /\|\s*方法\s*\|/i.test(content) || /\|\s*METHOD\s*\|/i.test(content);
         if (!hasInterfaceTable) {
             content += `\n---\n> ⚠️ Word 自动转换，请在下方补充接口定义表格后运行 speccore execute：\n\n| 方法 | 路径 | 说明 |\n| :--- | :--- | :--- |\n| | | |\n`;
         }
-        // 5. 图片引用注释（告知 Task 如何引用这些图）
-        // v8.3.75+: 修正 Task 引用路径（从 030-tasks/Task-NNN/00-specs/ 出发需 ../../../）
-        content = content.replace(/^#/, `# ${platform || '通用'}需求\n\n<!-- \n  原型图片路径: 010-requirements/assets/extracted/\n  converted/ 引用方式: ![原型](../assets/extracted/xxx.png)\n  Task 引用方式: ![原型](../../../010-requirements/assets/extracted/xxx.png)\n  所有 Task 共享此目录，无需重复存放。\n-->\n\n#`);
         await (0, fs_extra_1.writeFile)(outputPath, content);
         // ── 更新 INDEX.md ──
         const indexPath = (0, path_1.join)(iterDir, '010-requirements', 'INDEX.md');
@@ -452,6 +468,19 @@ async function processSingle(options) {
         const fileStat = await (0, fs_extra_1.stat)(outputPath);
         logger_1.logger.success(`输出: ${outputPath} (${fileStat.size} bytes)`);
         logger_1.logger.info(`图片: ${imageCount} 张 → ${imageDir}/`);
+        // 标题规范化结果汇报（AI 重写统计 + 调整前快照位置）
+        if (normalizeReport) {
+            logger_1.logger.info(`📝 标题规范化: ${normalizeReport.applied} 处重写`);
+            if (normalizeReport.skipped > 0) {
+                logger_1.logger.info(`   ⚠️ ${normalizeReport.skipped} 处 AI 映射未匹配（章节原样保留）`);
+            }
+            if (normalizeReport.backupPath) {
+                logger_1.logger.info(`   💾 调整前快照: ${normalizeReport.backupPath}`);
+            }
+        }
+        else if (options.normalize === true && options.ai !== false && !taskId) {
+            logger_1.logger.info('💡 标题规范化跳过（未配置 AI provider）——可配置 SPECCORE_LLM_KEY 后重试');
+        }
         logger_1.logger.info(`接口表: ${hasInterfaceTable ? '✅' : '⚠️ 缺失（已追加提示）'}`);
         logger_1.logger.info(`🔍 质量: ${grade} ${report.score}/100 (${report.errors}错误 ${report.warnings}警告)`);
         logger_1.logger.info(`   详见: ${reportPath}`);
@@ -486,6 +515,182 @@ async function processSingle(options) {
         throw error;
     }
 }
+// ================================================================
+// AI 标题规范化（v8.3.335+）：转换后按 SpecCore 标准标题体系重写标题
+//
+// 设计原则：
+//   1. AI 只产「标题映射」，CLI 确定性回写——正文一字不动、行数不变，天然防丢章节
+//   2. 应用前把「规范化前版本」快照到 backup/，随时可回溯（用户要求「以防要用」）
+//   3. AI 不可用 / 映射质量差 → 静默跳过，绝不阻断转换主链路
+// ================================================================
+/** SpecCore 标准需求文档标题体系（AI 标题规范化的参照规范） */
+const STANDARD_DOC_TITLES = {
+    docTitleSuffix: '需求', // H1 格式：{文档名}需求
+    globalSections: [
+        // 全局章节标准名（项目级通用信息，不构成功能单元）
+        '文档概述', '产品定位', '项目背景', '目标用户', '用户画像',
+        '名词约定', '术语表', '功能架构', '非功能需求', '验收标准',
+        '上线计划', '风险与缓解', '关联文档',
+    ],
+    featurePrefix: '功能模块', // 功能章节格式：功能模块{中文序号}：{功能名}
+    featureSubsections: [
+        // 功能模块下常用子节标准名
+        '用户场景', '页面布局', '操作步骤', '业务规则', '异常场景处理', '验收标准',
+    ],
+};
+/** 提取文档标题大纲（含原层级），供 AI 参照重写（导出供测试） */
+function buildTitleOutline(content) {
+    return content.split('\n').filter((l) => /^#{1,6}\s+/.test(l)).join('\n');
+}
+/** 提取各章节开头内容（标题 + 首 3 行正文），给 AI 提供语义依据 */
+function buildSectionHeads(content) {
+    const lines = content.split('\n');
+    const heads = [];
+    for (let i = 0; i < lines.length; i++) {
+        if (!/^#{1,6}\s+/.test(lines[i]))
+            continue;
+        const body = [];
+        for (let j = i + 1; j < lines.length && body.length < 3 && !/^#{1,6}\s+/.test(lines[j]); j++) {
+            const t = lines[j].trim();
+            if (t)
+                body.push(t.slice(0, 80));
+        }
+        heads.push(`${lines[i]}\n${body.join('\n')}`);
+    }
+    return heads.join('\n\n');
+}
+/** 解析 AI 返回的标题映射 JSON（容忍 markdown 代码围栏等噪声，导出供测试） */
+function parseTitleRenames(text) {
+    try {
+        const cleaned = text.replace(/```(?:json)?\s*/gi, '').replace(/```/g, '').trim();
+        const start = cleaned.indexOf('{');
+        const end = cleaned.lastIndexOf('}');
+        if (start < 0 || end <= start)
+            return null;
+        const parsed = JSON.parse(cleaned.slice(start, end + 1));
+        const renames = (Array.isArray(parsed.renames) ? parsed.renames : [])
+            .filter((r) => r && typeof r.from === 'string' && typeof r.to === 'string' && r.from.trim() && r.to.trim())
+            .map((r) => ({ from: r.from.trim(), to: r.to.trim() }));
+        const docTitle = typeof parsed.docTitle === 'string' && parsed.docTitle.trim() ? parsed.docTitle.trim() : '';
+        return renames.length > 0 ? { renames, docTitle } : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * CLI 确定性回写标题映射：只替换标题行文字，正文一字不动。
+ * from 匹配时两侧都剥离章节编号（容忍 AI 带不带编号），同名标题按出现顺序一一对应。
+ * 未匹配到的 from 记入 skipped（章节原样保留），绝不静默丢章节。
+ */
+function applyTitleRenames(content, renames, docTitle) {
+    const lines = content.split('\n');
+    const used = new Set();
+    const skipped = [];
+    let applied = 0;
+    let h1Done = false;
+    for (let i = 0; i < lines.length; i++) {
+        const m = lines[i].match(/^(#{1,6})\s+(.+)$/);
+        if (!m)
+            continue;
+        const level = m[1].length;
+        const rawText = m[2].trim();
+        // H1：整行替换为 docTitle（文档唯一标题；AI 未给出时保持原样）
+        if (level === 1) {
+            if (!h1Done && docTitle) {
+                lines[i] = `# ${docTitle}`;
+                h1Done = true;
+                applied++;
+            }
+            continue;
+        }
+        // 其余标题：strip 编号前缀后与 from 精确匹配
+        const normalized = stripSectionNo(rawText).trim();
+        const idx = renames.findIndex((r, j) => !used.has(j) && stripSectionNo(r.from).trim() === normalized);
+        if (idx < 0)
+            continue;
+        used.add(idx);
+        // to 需为完整标题行（含 # 前缀，层级由 AI 决定）；未带前缀时沿用原层级兜底
+        lines[i] = /^#{1,6}\s+/.test(renames[idx].to) ? renames[idx].to : `${'#'.repeat(level)} ${renames[idx].to}`;
+        applied++;
+    }
+    for (let j = 0; j < renames.length; j++) {
+        if (!used.has(j))
+            skipped.push(renames[j].from);
+    }
+    return { content: lines.join('\n'), applied, skipped };
+}
+/** 标题规范化前，把「规范化前版本」快照到 010-requirements/backup/ */
+async function backupPreNormalizeContent(content, outputPath) {
+    try {
+        const backupDir = (0, path_1.join)((0, path_1.dirname)((0, path_1.dirname)(outputPath)), 'backup');
+        await (0, fs_extra_1.ensureDir)(backupDir);
+        const ts = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 14);
+        const backupPath = (0, path_1.join)(backupDir, `${(0, path_1.basename)(outputPath, '.md')}-${ts}.md`);
+        await (0, fs_extra_1.writeFile)(backupPath, content);
+        return backupPath;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * AI 标题规范化主编排：调用 LLM 产标题映射 → 回写 → 快照。
+ * 返回 null 表示跳过（AI 不可用/无有效映射），调用方原样保留文档。
+ */
+async function normalizeTitlesWithAI(content, docLabel, outputPath) {
+    try {
+        const outline = buildTitleOutline(content);
+        // 标题太少（<3 个）时文档无结构可调，直接跳过
+        if (outline.split('\n').filter(Boolean).length < 3)
+            return null;
+        const systemPrompt = [
+            '你是资深产品需求文档编辑。任务：把 PRD 文档的章节标题按 SpecCore 标准标题体系重写，正文一字不动。',
+            '',
+            'SpecCore 标准标题体系：',
+            `1. 文档唯一 H1 标题：{文档名}${STANDARD_DOC_TITLES.docTitleSuffix}（如「${docLabel}需求」）`,
+            `2. 全局章节（项目级通用信息，不算功能单元）归 H2，标准名：${STANDARD_DOC_TITLES.globalSections.join('、')}`,
+            `3. 功能模块归 H2，标题格式「${STANDARD_DOC_TITLES.featurePrefix}{中文序号}：{功能名}」（序号从「一」连续递增）`,
+            `   功能模块下子节归 H3，常用标准名：${STANDARD_DOC_TITLES.featureSubsections.join('、')}`,
+            '4. 层级理顺：H1 只留文档标题一个；层级不跳级（### 后不能直接 #####）',
+            '',
+            '重写规则：',
+            '- 只改标题行文字与层级，不改章节顺序，不增删章节',
+            '- 原标题语义映射到最接近的标准名（「背景介绍」→「项目背景」；「会议管理」→「功能模块一：会议室管理」）',
+            '- 编号连续：全局章节与功能模块共用同一组中文序号（一、二、三…），子节编号 x.1、x.2 连续',
+            '- 无法归类的章节保留原意、统一格式，不要强行套标准名',
+            '',
+            '严格只返回 JSON，不要输出任何 JSON 以外的文字：',
+            '{"renames":[{"from":"原标题文字","to":"## 新标题行"}],"docTitle":"新文档标题"}',
+            '- from：文档中该标题去掉「#」与编号前缀后的精确文字',
+            '- to：完整新标题行（必须含 # 前缀，层级由你决定）',
+            '- 覆盖除 H1 外的所有标题；H1 的新内容放 docTitle',
+        ].join('\n');
+        // 大文档只传前 20000 字符的章节抽样（大纲仍覆盖全文，语义依据够用）
+        const truncated = content.length > 20000;
+        const sample = truncated ? content.slice(0, 20000) : content;
+        const userPrompt = `文档标题大纲（含原层级）：\n\n${outline}\n\n` +
+            `各章节开头内容（语义依据${truncated ? '，文档较长仅抽样' : ''}）：\n\n${buildSectionHeads(sample)}`;
+        const providers = await (0, ask_llm_1.resolveAiProviders)('doc2spec');
+        const response = await (0, ask_llm_1.callLlm)(systemPrompt, userPrompt, providers, 3000);
+        if (!response)
+            return null;
+        const parsed = parseTitleRenames(response);
+        if (!parsed)
+            return null;
+        // 防丢章节：AI 映射命中过少说明输出质量差，放弃本次规范化（宁可不动也别改错）
+        const before = content;
+        const applied = applyTitleRenames(content, parsed.renames, parsed.docTitle);
+        if (applied.applied < Math.min(3, Math.ceil(parsed.renames.length / 2)))
+            return null;
+        // 应用前快照「规范化前版本」（用户要求备份以防要用）
+        const backupPath = await backupPreNormalizeContent(before, outputPath);
+        return { content: applied.content, applied: applied.applied, skipped: applied.skipped, backupPath };
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * --classify 模式：扫描 sources/ 下所有文件，AI 智能分类后输出到 staging/
  *
@@ -806,7 +1011,7 @@ async function readUnitTitle(unitDir) {
  * 将转换后的文档拆分为功能单元，写入 features/
  * v8.3.191+: 导出供 run 流水线「切分功能单元」步骤复用（对已转换文档切分，无需 --file）
  */
-async function splitDocumentToUnits(iterDir, outputPath, platformLabel, sourceFileName, translateEn, translateResponse, onDuplicate) {
+async function splitDocumentToUnits(iterDir, outputPath, platformLabel, sourceFileName, translateEn, translateResponse, onDuplicate, titles) {
     const content = await (0, fs_extra_1.readFile)(outputPath, 'utf-8');
     // v8.3.263: 收集同目录其它文档名（端级文档）——总纲文档（如 overview-requirements.md）
     // 的端级汇总章节与端文档切出的单元语义重复（文本层面不相似，Jaccard 拦不住），
@@ -924,6 +1129,22 @@ async function splitDocumentToUnits(iterDir, outputPath, platformLabel, sourceFi
         }
     }
     catch { }
+    // v8.3.334+: 标题过滤——用户指定只切某些标题的章节时，其余功能单元不参与
+    // 英译/写盘（不占序号）；globalSections 不受影响，照常归 overview
+    if (titles && titles.length > 0) {
+        const { kept, dropped, unmatched } = filterUnitsByTitles(units, titles);
+        units = kept;
+        if (dropped.length > 0) {
+            logger_1.logger.info(`   🎯 标题过滤: 指定 ${titles.length} 个标题，保留 ${kept.length}/${kept.length + dropped.length} 个单元`);
+            logger_1.logger.info(`   ⏭️  跳过 ${dropped.length} 个非指定单元: ${dropped.join('、')}`);
+        }
+        if (unmatched.length > 0) {
+            logger_1.logger.warn(`   ⚠️  以下标题未在文档中命中（检查名字/编号）: ${unmatched.join('、')}`);
+        }
+        if (units.length === 0) {
+            logger_1.logger.warn('   ⏹️  标题过滤后无剩余功能单元，仅处理全局章节（如有）');
+        }
+    }
     let written = 0;
     let skipped = 0;
     // v8.3.272+: 标题英译（循环外批量：LLM 翻译 + 缓存，失败回落拼音）
@@ -1720,6 +1941,37 @@ function stripSectionPrefix(t) {
         .replace(/^[（(][一二三四五六七八九十百\d]+[）)][、.．\s]*/, '')
         .trim();
 }
+/**
+ * v8.3.334+: 标题过滤——用户指定只切某些标题的章节时，过滤功能单元列表。
+ *
+ * 匹配语义：归一化（去章节编号前缀/去空白/小写）后双向包含——
+ *   「预订管理」命中「3.1 预订管理」「预订管理流程」；「预订管理」与「会议预订管理」也命中。
+ * 返回 kept（保留）/ dropped（被过滤的单元标题）/ unmatched（用户指定但未命中的标题名）。
+ */
+function filterUnitsByTitles(units, titles) {
+    const norm = (t) => stripSectionPrefix(t).toLowerCase().replace(/[\s　·•・]+/g, '');
+    const wanted = titles.map((t) => norm(t)).filter(Boolean);
+    const kept = [];
+    const dropped = [];
+    for (const u of units) {
+        const nt = norm(u.title);
+        const hit = nt.length > 0 && wanted.some((w) => w.includes(nt) || nt.includes(w));
+        if (hit)
+            kept.push(u);
+        else
+            dropped.push(u.title);
+    }
+    const unmatched = titles.filter((t) => {
+        const w = norm(t);
+        if (!w)
+            return false;
+        return !units.some((u) => {
+            const nt = norm(u.title);
+            return nt.length > 0 && (w.includes(nt) || nt.includes(w));
+        });
+    });
+    return { kept, dropped, unmatched };
+}
 function sanitizeUnitName(name) {
     return name
         .replace(/[^a-zA-Z0-9\u4e00-\u9fa5\-_]/g, '')