管家婆经营日报

当老板想先看昨天的利润时，不该先去翻系统菜单

在 ERP 环境里，经营日报并不是一个“没有数据”的问题，而是“数据太多、口径太散”。销售额、采购额、收款、付款、库存货值、净现金流通常分别散落在不同模块：有人从仪表板找销售，有人去翻库存，有人还要去核对银行流水。等到几个数字凑齐，早会已经结束。

这个技能要解决的是：让经营者用一句自然语言拿到一份口径一致的昨日经营全貌，而不是每次先打开菜单、点模块、筛日期。

自然语言先被结构化，再路由到日报动作

技能的核心入口是自然语言理解。当用户说“发一下昨日经营日报”这类典型表达时，会命中日报意图；口语变体也会被识别，例如：

• 库存 / 存量 / 余量
• 入库 / 进货 / 收货
• 出库 / 出货 / 发货
• 收款 / 回款 / 进账

如果用户只说“菜单”“功能菜单”“帮助”或“?”，则返回功能列表，而不是直接执行业务查询。

解析完成后，技能会路由到 ReplenishmentAssistant.handle()，并传入：

• action: "daily_report"
• entities: 由 NLP 引擎或模型输出的实体槽位

当前日报主要需要抽取 time_range 实体。系统也支持 top_n 等通用查询参数，默认时间范围为最近 30 天，默认返回 10 条。

报告不只罗列数字，还会附带分析

查询会落到真实数据源 H3ERP SQL Server 账套 yszt，把昨日经营数据整理成 Markdown 表格或列表。返回的结构化结果至少包含：

• reply: 给用户看的格式化文本
• action: 当前路由动作名，用于追踪和调试

在文本之后，系统会追加 📊 智能分析与建议。这部分由 _make_analysis() 统一生成，包含分析结论和可行动建议。当环境变量 AI_API_KEY 有效时，分析由 LLM 增强；否则自动降级为规则引擎兜底。

适用边界与注意点

这个技能适合日常经营概览、昨日复盘和快速查询。它不替代完整财务对账，也不会把经营结论直接写成不可逆的业务数据。

需要注意：

• 写操作，如开单、审批、申请，只生成草稿和预览，不会直接写入 ERP 数据库 yszt
• 时间范围支持本月、上月、本周、上周、今年、最近 N 天、前 N 天等口语解析
• 演示路径来自 erp_core/procurement/service.py，仅在 H3ERP_ENABLED=false 时启用
• 真实查询路径来自 erp_core/h3erp/service.py

相关实现分布在 procurement_scenarios/replenishment_assistant.py、ai_dialog_layer/nlp_engine.py 和 erp_core 的数据访问层。