技能介绍

解决什么问题

管家婆 ERP（H3ERP SQL Server 账套 yszt）里的收款数据分散在单据表里，业务人员想回答“最近回款多少、哪个客户欠得最多”这类问题，往往要手工筛选单据类型、日期和往来单位，再导出汇总。本技能把这一步压缩成一句自然语言：说“看看本月回款”或“上周进账 Top 5 的客户”，就能拿到结构化结果和一段分析建议。

技能如何工作

技能本身不直连数据库，而是作为后端 ReplenishmentAssistant.handle() 的路由入口：

意图与实体抽取：NLPEngine 从用户话里识别收款查询意图，填充 time_range、top_n、partner 三个槽位；LLM 路径下模型直接输出 JSON，规则路径由 _extract_entities 兜底。
动作路由：内部固定以 action: "receipts" 调用查询服务，entities 由后端自动填充。
格式化与分析：返回的 dict 至少包含 reply（Markdown 表格/列表）和 action；_make_analysis() 在回复末尾追加“📊 智能分析与建议”段落，给出结论与可执行建议。
参数默认值：time_range 默认最近 30 天，top_n 默认 10 条；时间表达支持本月/上月/本周/上周/今年/最近N天/前N天等口语说法。
能力降级：.env 中 AI_API_KEY 有效时走 LLM 增强分析，否则退回规则引擎。

适用边界

只读定位：本技能只做收款单查询，不包含开单、审批或申请类写操作；写操作类只生成草稿与预览，不写入 yszt 账套。
依赖后端：必须启动 ERP 后端服务；H3ERP_ENABLED=false 时走演示数据路径，erp_core/h3erp/service.py 才是真实库路径。
菜单入口：用户输入“菜单/功能菜单/帮助/?”时会展示全部功能列表，收款查询只是其中一项。