新增模块

This commit is contained in:
2026-10-18 15:27:02 +08:00
parent 5b7d1e8f64
commit f2e6d2b3f1
228 changed files with 46089 additions and 11 deletions
+186
View File
@@ -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;
}