import type { MetricNode } from '../data/sqlite'; /** * 离线意图理解:把用户的一句话拆成「意图 + 指标实体 + 假设参数」。 * 纯关键词规则(仅中文),无网络依赖,与 answers.ts 组成单轮问答的本地智能引擎。 */ export type Intent = | 'overview' // 经营概况 | 'query' // 指标查询 | 'compare' // 对比分析(产品线 / 区域) | 'attribute' // 归因分析 | 'forecast' // 趋势预测 | 'whatif' // 假设模拟 | 'anomaly' // 异常检测 | 'escalate' // 升级处置 | 'advice' // 行动建议 | 'risk' // 风险矩阵 | 'fallback'; // 兜底引导 export interface ParsedAsk { intent: Intent; /** 抽取到的指标 code(查询/归因/预测/模拟的对象) */ metricCode?: string; /** 假设模拟:目标值(绝对值)与增量(相对当期)二选一 */ absValue?: number; deltaValue?: number; /** 对比分析的范围 */ compareScope?: 'product' | 'region'; /** 原始问句(保留大小写用于展示) */ raw: string; } /* ── 意图关键词:命中优先级即数组顺序 ─────────────────────────────────── */ const INTENT_KEYS: [Intent, string[]][] = [ ['whatif', ['如果', '假如', '假设', '要是', '提升到', '提高到', '降到', '变成', '变为', 'what if', 'whatif', 'simulate']], ['forecast', ['预测', '预计', '下月', '下个月', '下季度', '未来', '走势会', '会怎样', '会达到', '能支撑', '支撑', '能跑多远', '够不够', 'forecast']], ['escalate', ['升级', 'escalat', '上报']], ['anomaly', ['红色', '告警', '预警', '异常', '超标', '不达标', '哪些指标', '偏离']], ['attribute', ['为什么', '为何', '原因', '主因', '归因', '怎么回事', 'why']], ['advice', ['怎么处理', '怎么办', '建议', '措施', '方案', '对策', '怎么改', '怎么提升', '怎么压降', 'suggest', 'advice']], ['compare', ['对比', '比较', '哪个更', '哪个最', '排名', '产品线', '区域', '地域', '各家', '排行']], ['risk', ['风险', 'risk']], ['overview', ['概况', '总览', '整体', '大盘', '全局', '经营状况', '经营情况', '健康度', 'overview', 'summary']], ]; /* ── 指标别名:口语 / 简称 → code(与节点中文名互补,最长优先) ── */ const ALIASES: Record = { // 经营结果 '营收': 'R01', '收入': 'R01', '营业额': 'R01', '增长': 'R02', '增速': 'R02', '同比': 'R02', '净利润': 'R03', '利润': 'R03', '现金流': 'R13', 'cf': 'R13', '在手订单': 'R10', 'backlog': 'R10', '在手': 'R10', '新增订单': 'R08', '新订单': 'R08', '订单': 'R08', // 盈利质量 '毛利率': 'R04', '毛利': 'R04', '净利率': 'R05', 'ebitda': 'R06', 'roe': 'Q01', '负债率': 'Q03', '资产负债率': 'Q03', 'ccc': 'Q08', '现金转换': 'Q08', '现金周期': 'Q08', // 运营效率 '存货': 'E01', '库存': 'E01', '库存周转': 'E01', '呆滞': 'E01', '应收': 'E03', '账期': 'E03', '人均': 'E05', '人效': 'E05', '计划准确': 'DR-14', '安全库存': 'DR-15', // 研发动能 '研发费用': 'G01', '研发投入': 'G01', '研发费率': 'G01', '里程碑': 'G02', '按期率': 'G02', '新品贡献': 'G03', '上市周期': 'G04', '新品周期': 'G04', '设计变更': 'G06', '变更件数': 'G06', '复用率': 'G07', '通用件': 'G07', '在研': 'G08', '专利': 'G05', // 市场客户 '漏斗': 'M01', '转化率': 'M01', 'ltv': 'M02', 'cac': 'M02', '留存': 'M04', '大客户留存': 'M04', '线索': 'DR-12', '响应时效': 'DR-13', '响应速度': 'DR-13', // 生产供应 'oee': 'P01', '平衡率': 'P02', '交付': 'R12', '交期': 'R12', '及时率': 'R12', '双源': 'K01', '可用率': 'DR-07', '性能稼动': 'DR-08', '良品率': 'DR-09', '品质': 'DR-09', // 数智化 '渗透': 'D01', 'ai渗透': 'D01', '成熟度': 'D02', 'ai成熟': 'D02', '数据资产': 'D05', '在线率': 'D05', '治理': 'DR-10', '主数据': 'DR-10', '模型上线': 'DR-11', // 风险 '敞口': 'RK01', '风险指数': 'RK01', '合规事件': 'RK02', // 驱动因子(归因高频对象) '大客户订单': 'DR-01', '渠道': 'DR-02', '覆盖': 'DR-02', '单价': 'DR-03', '高毛利占比': 'DR-04', '高毛利产品': 'DR-04', '物料成本': 'DR-05', '关键物料': 'DR-05', '汇率': 'DR-06', // 八大维度 '财务': 'D-R', '盈利质量': 'D-Q', '质量': 'D-Q', '效率': 'D-E', '研发': 'D-G', '动能': 'D-G', '市场': 'D-M', '客户': 'D-M', '生产': 'D-P', '供应': 'D-P', 'ai': 'D-D', '数字化': 'D-D', '数智': 'D-D', 'dx': 'D-D', '风险韧性': 'D-K', '总览': 'OV', '健康度': 'OV', '经营': 'OV', }; /** 指标实体抽取:别名 + 节点中文名 + code 全匹配,最长别名优先(在手订单 > 订单) */ export function extractMetricCode(text: string, flat: MetricNode[]): string | undefined { const entries: [string, string][] = []; flat.forEach(n => { entries.push([n.name_zh, n.code], [n.code.toLowerCase(), n.code]); }); Object.entries(ALIASES).forEach(([alias, code]) => entries.push([alias, code])); entries.sort((a, b) => b[0].length - a[0].length); for (const [alias, code] of entries) { if (alias.length >= 2 && text.includes(alias)) return code; } return undefined; } /** 假设模拟的数值解析:绝对值(提升到 40)与增量(提升 2pt / +2) */ function extractHypothesis(text: string): { absValue?: number; deltaValue?: number } { const m = text.match(/([-+]?\d+(?:\.\d+)?)/); if (!m) return {}; const num = parseFloat(m[1]); if (Number.isNaN(num)) return {}; // 「提升到 / 降到 / 达到」→ 绝对值;「提升 2pt / 下降 2 / +2」→ 增量 const before = text.slice(0, m.index ?? 0); const isAbs = /到|至|达到|为|变成/.test(before) && !/[-+]/.test(m[1]); const isPt = /pt|点/i.test(text.slice(m.index ?? 0)); if (isAbs) return { absValue: num }; if (m[1].startsWith('-') || m[1].startsWith('+')) return { deltaValue: num }; if (isPt) return { deltaValue: num }; return { absValue: num }; } /** * 意图解析主入口。 * @param raw 用户原话 * @param ctx flat=全量节点;selectedCode=当前选中指标(实体缺失时的上下文兜底) */ export function parseIntent( raw: string, ctx: { flat: MetricNode[]; selectedCode?: string; }, ): ParsedAsk { const text = raw.toLowerCase(); // 意图:按优先级找第一个命中的关键词组 let intent: Intent = 'fallback'; for (const [it, keys] of INTENT_KEYS) { if (keys.some(k => text.includes(k))) { intent = it; break; } } // 实体:抽取到的优先,其次沿用当前选中节点(上下文兜底) const extracted = extractMetricCode(text, ctx.flat); const metricCode = extracted ?? ctx.selectedCode; // 问句里确实点到了指标但没命中任何意图词 → 视为查询; // 纯闲聊(无抽取实体)保持 fallback,不因选中节点而误判 if (intent === 'fallback' && extracted) intent = 'query'; // 问“怎么样/多少”却没说对象 → 给经营概览;归因/预测无对象时由 answers 用默认指标 if (intent === 'query' && !metricCode) intent = 'overview'; const out: ParsedAsk = { intent, metricCode, raw }; if (intent === 'whatif') { Object.assign(out, extractHypothesis(text)); } if (intent === 'compare') { out.compareScope = /区域|地域|大区|地区/.test(text) ? 'region' : 'product'; } return out; }