Merge remote-tracking branch 'origin/dev_New_pro' into dev_New_pro

zss

6 天以前 461fcac5e3089c4ba48e6e43b6bb88a88a1070d8

Merge remote-tracking branch 'origin/dev_New_pro' into dev_New_pro

 doc/20260522_²ÆÎñÖúÊÖÌáÎÊÓÅ»¯Ç°¶Ë±ä¸üÎĵµ.md

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,59 @@
# è´¢åŠ¡åŠ©æ‰‹æé—®ä¼˜åŒ–前端变更文档

更新时间：2026-05-22  
适用模块：财务智能助手（`/financial-ai`）

## 1. èƒŒæ™¯

当前首页财务助手快捷提问为：

1. `生成本周经营周报`
2. `为什么利润下降`
3. `哪个客户最赚钱`

问题点：

- ç¬¬ 3 æ¡é—®æ³•åœ¨éƒ¨åˆ†åœºæ™¯ä¸‹æ„å›¾å‘½ä¸­ä¸ç¨³å®šï¼Œå®¹æ˜“走普通文本回答，导致图表链接以原始 Markdown æ–‡æœ¬å±•ç¤ºï¼ˆå¦‚ `![...](https://local/generate_chart?options=...)`）。
- å¿«æ·æé—®ç¼ºå°‘时间范围和分析目标，结果稳定性与可解释性较弱。

## 2. å‰ç«¯å¿«æ·æé—®æ–‡æ¡ˆä¼˜åŒ–（必改）

建议将默认三条快捷提问调整为：

1. `生成本周经营周报（利润与现金流）`
2. `分析本月利润下降原因`
3. `近30天哪个客户利润贡献最高`

说明：

- ä¸‰æ¡é—®æ³•å‡å¸¦æ—¶é—´èŒƒå›´æˆ–分析目标，后端命中更稳定。
- ç¬¬ 3 æ¡ä¸Žâ€œæœ€èµšé’±å®¢æˆ·â€è¯­ä¹‰ä¸€è‡´ï¼Œä½†â€œåˆ©æ¶¦è´¡çŒ®æœ€é«˜â€æ›´æ˜Žç¡®ï¼Œé€‚合直接驱动利润分析结果页。

## 3. ä¸ŽåŽç«¯èƒ½åŠ›æ˜ å°„

| å¿«æ·æé—® | é¢„期命中能力 | é¢„期 `type` |
| --- | --- | --- |
| ç”Ÿæˆæœ¬å‘¨ç»è¥å‘¨æŠ¥ï¼ˆåˆ©æ¶¦ä¸ŽçŽ°é‡‘流） | ç»è¥æŠ¥å‘Šç”Ÿæˆ | `financial_operation_report` |
| åˆ†æžæœ¬æœˆåˆ©æ¶¦ä¸‹é™åŽŸå›  | è®¢å•åˆ©æ¶¦åˆ†æž | `financial_order_profit_analysis` |
| è¿‘30天哪个客户利润贡献最高 | è®¢å•åˆ©æ¶¦åˆ†æž | `financial_order_profit_analysis` |

后端已同步增强“最赚钱客户/客户利润最高/利润贡献最高”等同义问法识别，前端按以上文案改造后可直接联调。

## 4. èŠå¤©å†…容渲染兜底（建议改）

针对聊天返回文本中出现的图表 Markdown é“¾æŽ¥ï¼ˆ`https://local/generate_chart?options=...`），建议前端增加兜底处理：

1. è¯†åˆ« Markdown å›¾ç‰‡è¯­æ³•ä¸­çš„ `local/generate_chart` é“¾æŽ¥ã€‚
2. è§£æž `options` å‚数并转换为 ECharts `option` åŽæ¸²æŸ“图表组件。
3. è§£æžå¤±è´¥æ—¶ä¸å±•ç¤ºåŽŸå§‹é•¿é“¾æŽ¥æ–‡æœ¬ï¼Œå±•ç¤ºç»Ÿä¸€ç©ºæ€æç¤ºã€‚

## 5. è”调回归清单

1. ç‚¹å‡»å¿«æ·æé—® `生成本周经营周报（利润与现金流）`  
   - æ ¡éªŒè¿”回 `type=financial_operation_report`，并正常渲染摘要/建议/图表。
2. ç‚¹å‡»å¿«æ·æé—® `分析本月利润下降原因`  
   - æ ¡éªŒè¿”回 `type=financial_order_profit_analysis`，并展示亏损订单与客户利润排行。
3. ç‚¹å‡»å¿«æ·æé—® `近30天哪个客户利润贡献最高`  
   - æ ¡éªŒè¿”回 `type=financial_order_profit_analysis`，`summary.topCustomerByProfit` æœ‰å€¼ã€‚
4. æ‰‹å·¥è¾“å…¥ `哪个客户最赚钱`、`哪个客户利润最高`  
   - æ ¡éªŒä»å‘½ä¸­ `financial_order_profit_analysis`，不再出现原始图表 Markdown é“¾æŽ¥ç›´å‡ºã€‚

 src/main/java/com/ruoyi/ai/assistant/FinancialIntentExecutor.java

@@ -45,7 +45,8 @@
        if (containsAny(text, "成本核算", "产品成本", "工序成本", "人工成本", "折旧", "材料损耗")) {
            return financialAgentTools.calculateIntelligentCost(memoryId, startDate, endDate, timeRange, keyword, limit);
        }
        if (containsAny(text, "利润分析", "订单利润", "亏损订单", "低利润", "最赚钱客户", "利润下降")) {
        if (containsAny(text, "利润分析", "订单利润", "亏损订单", "低利润",
                "最赚钱客户", "哪个客户最赚钱", "客户最赚钱", "利润最高客户", "利润贡献最高客户", "利润下降")) {
            return financialAgentTools.analyzeOrderProfit(memoryId, startDate, endDate, timeRange, keyword, limit);
        }
        if (containsAny(text, "库存资金", "库存积压", "呆滞库存", "资金占用", "周转率", "库存周转")) {
@@ -86,6 +87,15 @@
        }
        if ("为什么利润下降".equals(normalized)) {
            DateRange range = monthRange();
            return financialAgentTools.analyzeOrderProfit(memoryId, range.startDate(), range.endDate(), range.label(), null, 20);
        }
        if ("哪个客户最赚钱".equals(normalized)
                || "最近哪个客户最赚钱".equals(normalized)
                || "本月哪个客户最赚钱".equals(normalized)
                || "近30天哪个客户最赚钱".equals(normalized)
                || "哪个客户利润最高".equals(normalized)
                || "哪个客户利润贡献最高".equals(normalized)) {
            DateRange range = extractDateRange(text);
            return financialAgentTools.analyzeOrderProfit(memoryId, range.startDate(), range.endDate(), range.label(), null, 20);
        }
        return null;
@@ -216,6 +226,16 @@
                .replace("请", "")
                .replace("一下", "")
                .replace("为什么", "")
                .replace("哪个客户最赚钱", "")
                .replace("最近哪个客户最赚钱", "")
                .replace("本月哪个客户最赚钱", "")
                .replace("近30天哪个客户最赚钱", "")
                .replace("最赚钱客户", "")
                .replace("客户最赚钱", "")
                .replace("哪个客户利润最高", "")
                .replace("利润最高客户", "")
                .replace("哪个客户利润贡献最高", "")
                .replace("利润贡献最高客户", "")
                .replace("本月", "")
                .replace("本周", "")
                .replace("本年", "")

 src/main/resources/financial-agent-prompt.txt

@@ -6,6 +6,6 @@
2. å‘½ä¸­æˆæœ¬ã€åˆ©æ¶¦ã€åº“存资金、现金流、预警、驾驶舱、日报周报场景时，优先调用对应工具。
3. å·¥å…·è¿”回 JSON æ—¶ï¼Œç›´æŽ¥è¾“出原始 JSON å­—符串，不要额外包裹 Markdown，也不要在前后追加解释文本。
4. å½“用户问题缺少时间范围时，默认使用工具内置口径（如近30天、本月、近90天），并在后续可提醒用户补充范围。
5. ç”¨æˆ·é—®â€œä¸ºä»€ä¹ˆåˆ©æ¶¦ä¸‹é™â€â€œå“ªä¸ªè®¢å•äºæŸâ€â€œå“ªä¸ªå®¢æˆ·æœ€èµšé’±â€â€œå“ªä¸ªè½¦é—´/工序成本最高”等问题时，优先基于订单利润与工序成本分析工具作答。
5. ç”¨æˆ·é—®â€œä¸ºä»€ä¹ˆåˆ©æ¶¦ä¸‹é™â€â€œå“ªä¸ªè®¢å•äºæŸâ€â€œå“ªä¸ªå®¢æˆ·æœ€èµšé’±â€â€œå“ªä¸ªå®¢æˆ·åˆ©æ¶¦è´¡çŒ®æœ€é«˜â€â€œå“ªä¸ªè½¦é—´/工序成本最高”等问题时，优先基于订单利润与工序成本分析工具作答。
6. å›žç­”必须使用中文；若数据不足以得出结论，明确指出缺少哪些关键字段或筛选条件。
7. ç”¨æˆ·æåˆ°â€œä»Šå¹´/本月/今天/最近/上月/去年”等相对时间时，必须严格基于“当前日期”换算，禁止自行假设年份。