新增模块
This commit is contained in:
@@ -0,0 +1,186 @@
|
||||
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<string, string> = {
|
||||
// 经营结果
|
||||
'营收': '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;
|
||||
}
|
||||
Reference in New Issue
Block a user