feat(asset-ai): generate contextual presentations and drilldown plans

docs/asset-ai-composition.md

@@ -0,0 +1,30 @@
+# 资产 AI 自主组合分析
+
+## 行为
+
+问数分两阶段：先规划并查询，再把已计算的结果汇总交给 DeepSeek 设计展示和下一步交互。简单问题通常一次查询规划和一次展示规划；多项结果共用一次展示规划调用。复合问题由 DeepSeek 在一次 JSON 规划中拆成最多四项不同的查询，并选择指标卡、图表、统计表或明细；数据由既有后台查询和计算产生。模型不会生成可执行的 SQL、HTML 或 JavaScript。
+
+例如“华东的4.5T库存有多少？待交车占库存多少？按城市展示库存分布，并列出哪些异动车辆即将到期”，可组合库存指标、城市库存图和即将到期异动明细。待交车、异动已包含在库存内，占比的分母是完整筛选范围的库存，不受图表 Top N 截断影响。零分母时明确不计算占比。
+
+AI 根据问题与实际结果，自主决定信息块顺序、重点指标、柱图/环图/折线、表格列和下钻目标。多项分析可由 AI 选择分页切换或连续排列；前端保持 Web/H5 的紧凑尺寸与统一操作区。切换项目同时切换追问范围；点击分组原位更新所属项目，其他项目保留。每项均有自己的服务端会话结果 ID，可独立下钻、返回、导出和反馈。复制整份回答包含所有项目及其统计范围与口径。
+
+无法生成有效计划的部分列入“尚未回答”；数据源执行失败的项目显示错误和单独重试入口。健康项目照常返回。缺口沿用原有需求记录存储，保存失败会如实提示。该记录用于产品需求改进，不会自动训练或修改模型。
+
+## 协议与维护
+
+规划层沿用单项 `plan`，可选 `queries: [{id,title,question,plan,display}]`；每项独立规范化和验证，避免整句的一个业务状态覆盖全部项目。普通单项响应维持兼容格式。
+
+结果层增加 `sections: [{id,title,question,display,result?,error?}]`。每个成功的 `result` 仍使用既有结果协议。父分析和子分析均保留各项汇总上下文 `analyses`，供“第二项”“这些待交车”等追问选择对应分析。AI 下钻入口按服务端会话保存的目标查询执行，并绑定实际点击的分组或日期。每次下钻完成后重新设计展示和下一步入口；不再走固定的维度遍历顺序。
+
+所有项目使用同一轮授权后的车辆快照。交还车事件仍按既有数据源查询；不同数据源不承诺事务级同时快照。导出会按当前权限重新查询，数据可能随业务更新变化。模型只选择现有数据与计算能力；财务损失、历史库存等未接入能力仍不能生成真实结论。
+
+展示协议为 `presentation: {title, blocks, interactions}`。`blocks` 是有序的语义信息块，可配置 summary、narrative、metrics、chart、table；指标、列和图形序列绑定已有结果字段，事实数字由后台数据提供。叙述支持 `{{metric:指标名称}}` 引用。`interactions` 保存 AI 生成的目标查询和操作名称，客户端只提交入口 ID 与点击的数据点，后台再按当前权限查询。
+
+AI 展示规划不可用时，保留查询结果并回退基础展示，明确提示回退。停止生成会取消后续展示规划。展示定义本身不会直接执行浏览器脚本，也不会生成数据库查询语句。
+
+## 验证
+
+- `src/server/routes/asset-assistant/composition.test.ts`：复合查询的授权范围、首项/次项故障隔离、单次车辆快照、跨项上下文、子项下钻、无效计划部分降级、占比分母和切换区域。
+- `src/server/routes/asset-assistant/planner.test.ts`：自主规划协议、独立业务语义、展示回退及过滤条件继承。
+- `src/modules/assets/assistant/conversation-presentation.test.ts`：子项原位替换、保留其他项目、历史范围恢复。
+- 已对真实 DeepSeek 接口使用合成车辆做单次复合规划验证，未使用生产车辆数据。