升鲜宝AI助手 E-R 图与操作说明书(三）---升鲜宝生鲜配送供应链管理系统源代码服务

升鲜宝供应链及收银系统源代码服务

218人浏览 · 2026-06-06 22:24:00

升鲜宝供应链及收银系统源代码服务 · 2026-06-06 22:24:00 发布

升鲜宝AI助手 E-R 图与操作说明书

适用对象：产品、研发、测试、实施、运维、业务管理员

一、文档说明

本说明书用于指导“升鲜宝供应链系统”中的一级功能菜单“AI助手”进行建设、理解和使用。文档包含两大部分：

• 第一部分：升鲜宝 AI 数据库表结构 E-R 关系说明。

• 第二部分：AI助手操作说明书，覆盖 9 个二级模块与 70 个三级功能页面。

系统定位：AI助手是升鲜宝供应链系统中的一个一级业务模块，不是独立系统。其核心目标是通过“指标标准化 + 预警自动化 + 报表智能化 + 预测决策化 + 知识库语义化 + 模型治理化”提升供应链经营分析能力。

二、AI 助手功能结构总览

一级菜单：AI助手

序号	二级模块	三级功能页面	页面作用
1	智能工作台	AI经营驾驶舱	展示销售、采购、库存、毛利、预警等核心指标总览，并以卡片、图表、排行榜形式输出当日经营态势。
2	智能工作台	今日异常待办	集中查看今日需处理的缺货、临期、价格异常、损耗异常、任务失败等待办事项。
3	智能工作台	AI智能问数	通过自然语言提问，自动生成安全 SQL、执行查询并输出图表与文字分析结论。
4	智能工作台	AI经营日报	每天自动生成经营摘要，包含核心指标变化、异常提示和经营建议。
5	智能工作台	AI预警概览	汇总预警中心触发的事件数量、等级、处理状态与处理时效。
6	智能工作台	常用问题收藏	沉淀高频问数问题与模板，便于一键复用。
7	智能工作台	我的订阅推送	查看个人已订阅的报表、预警与快报，以及最近推送结果。
8	经营分析	采购分析	分析采购金额、数量、单价波动、采购集中度、到货履约情况。
9	经营分析	销售订单分析	分析销售额、订单量、客单价、客户结构、取消率等。
10	经营分析	库存周转分析	分析库存金额、库龄、周转天数、库存结构与安全库存。
11	经营分析	缺货与滞销分析	识别缺货 SKU、滞销 SKU，并给出补货或清理建议。
12	经营分析	配送履约分析	分析配送准时率、签收时效、延迟、拒收与异常线路。
13	经营分析	财务毛利分析	分析毛利率、成本变化、费用分摊、客户/商品毛利异常。
14	经营分析	供应商履约分析	分析供应商到货、价格、质量、及时率与综合评分。
15	经营分析	质检溯源分析	分析质检结果、批次溯源、异常批次与风险追踪。
16	指标中心	指标分类	按业务域和层级管理指标分类目录。
17	指标中心	指标定义	维护指标编码、名称、统计周期、业务域、单位、维度等。
18	指标中心	指标口径维护	维护指标公式、统计规则、过滤条件与口径说明。
19	指标中心	指标取数SQL	维护指标 SQL 版本、测试状态、发布状态与参数。
20	指标中心	指标快照	查看定时计算生成的指标结果快照。
21	指标中心	指标看板配置	配置驾驶舱和分析页中图表组件与看板布局。
22	指标中心	指标权限配置	配置不同角色可查看的指标范围。
23	预警中心	预警规则	配置预警规则、阈值逻辑、触发条件和作用范围。
24	预警中心	预警事件	查看已触发的所有预警事件并进行处理闭环。
25	预警中心	缺货预警	专门查看缺货类预警与补货建议。
26	预警中心	临期预警	专门查看临期商品预警与处置建议。
27	预警中心	采购价异常	监控采购价波动超阈值的事件。
28	预警中心	毛利异常	监控毛利率低于阈值或大幅波动的事件。
29	预警中心	损耗异常	监控报损率、损耗金额异常变化。
30	预警中心	推送策略	配置站内信、短信、企业微信、邮件等消息渠道和推送时间。
31	报表中心	报表模板	定义日报、周报、月报、专题报告的结构和内容。
32	报表中心	AI日报	查看按日生成的 AI 分析报表。
33	报表中心	AI周报	查看按周生成的 AI 分析报表。
34	报表中心	AI月报	查看按月生成的 AI 分析报表。
35	报表中心	专项分析报告	针对专题场景生成的深度分析报告。
36	报表中心	报表任务	管理报表生成任务与调度状态。
37	报表中心	报表生成记录	查看已生成报表的历史记录与生成状态。
38	报表中心	报表导出下载	下载 PDF、Word、Excel 等报表产物。
39	预测决策	销量预测	预测未来销量趋势和关键 SKU 销量。
40	预测决策	补货建议	基于销量、库存、安全库存生成补货建议。
41	预测决策	库存优化	基于库存结构与周转结果给出优化建议。
42	预测决策	采购建议	结合销量预测、库存、供应商履约给出采购建议。
43	预测决策	调拨建议	结合门店/仓库库存差异给出调拨建议。
44	预测决策	供应商评分	生成供应商多维评分结果。
45	预测决策	经营建议闭环	汇总系统输出的经营建议，并跟踪处理状态。
46	预测决策	采纳效果评估	评估已采纳建议的后续效果。
47	知识库与语义	知识库管理	管理知识库主对象与业务域分类。
48	知识库与语义	文档管理	上传制度、SOP、报表解释、术语资料等文档。
49	知识库与语义	分段向量检索	查看与测试文档分段向量检索效果。
50	知识库与语义	业务术语库	维护供应链业务术语、同义词、别名。
51	知识库与语义	表字段语义	维护业务表字段的中文解释、语义标签和是否敏感。
52	知识库与语义	业务表映射	维护业务对象与源表、字段之间的映射关系。
53	知识库与语义	问数样例库	维护标准问数样例和推荐问法。
54	知识库与语义	RAG检索测试	测试知识库召回、重排与引用效果。
55	模型配置	API密钥配置	维护供应商 API Key、额度、失效时间和用途范围。
56	模型配置	大模型配置	维护模型清单、默认参数、上下文长度和成本。
57	模型配置	模型参数方案	按场景维护温度、top_p、输出长度等参数方案。
58	模型配置	助手角色配置	按业务场景配置助手角色和职责。
59	模型配置	提示词模板	维护系统提示词与场景提示词模板。
60	模型配置	工具函数配置	维护 AI 可调用的工具函数与接口能力。
61	模型配置	调用额度配置	维护调用配额、限流、成本控制。
62	模型配置	敏感词与脱敏	维护敏感词策略与输出脱敏规则。
63	审计与权限	模型调用日志	审计模型调用次数、耗时、成本和错误信息。
64	审计与权限	问数日志	审计自然语言问数请求与执行结果。
65	审计与权限	工具调用日志	记录工具函数调用情况。
66	审计与权限	生成SQL审计	审计 AI 生成 SQL 的安全性与执行情况。
67	审计与权限	成本与Token统计	统计模型调用成本、输入/输出 token 用量。
68	审计与权限	异常调用监控	监控调用失败、限流、超时、异常用量等。
69	审计与权限	菜单授权	配置 AI助手菜单与按钮权限。
70	审计与权限	多语言菜单维护	维护菜单国际化内容与多语言资源。

三、AI 数据库表结构总览

AI助手当前核心数据库共 29 张表，分为模型与会话、知识库与语义、指标与看板、预警与消息、报表与预测、审计与日志六大域。

表名	用途说明
ai_api_key	外部模型供应商 API 密钥、额度与到期管理
ai_model	大模型清单与默认参数配置
ai_prompt_template	提示词模板及版本发布
ai_chat_conversation	会话主表
ai_chat_message	会话消息明细
ai_knowledge	知识库主表
ai_knowledge_document	知识库文档表
ai_knowledge_segment	知识分段/向量切片表
ai_scm_data_asset	供应链数据资产登记
ai_scm_field_semantic	字段语义与指标/维度/筛选属性
ai_scm_business_mapping	业务对象映射与语义映射
ai_scm_metric_category	指标分类
ai_scm_metric	指标定义
ai_scm_metric_sql	指标取数 SQL 版本
ai_scm_metric_result	指标计算结果/快照
ai_scm_dashboard	指标看板/驾驶舱布局配置
ai_scm_report_template	报表模板
ai_scm_report_task	报表生成任务
ai_scm_warning_rule	预警规则
ai_scm_warning_event	预警事件
ai_scm_push_strategy	消息推送策略
ai_scm_message	消息中心消息
ai_scm_subscription	用户订阅
ai_scm_nlq_template	问数样例/模板
ai_scm_nlq_log	智能问数执行日志
ai_scm_forecast_result	预测结果
ai_scm_recommendation	建议/闭环建议结果
ai_scm_model_call_log	模型调用日志
ai_scm_operation_log	操作审计日志

四、AI 数据库 E-R 图

以下 E-R 图以“逻辑关系”为主，用于说明表与表之间的业务关联和内在调用关系。

01_总览ER图

02_指标预警报表预测ER图

03_知识库语义问数ER图

04_模型配置与审计ER图

五、核心表关系说明

主表	关系	从表	关系说明
ai_api_key	1:N	ai_model	一个 API Key 可供多个模型配置复用
ai_model	1:N	ai_chat_message	消息记录可标记实际使用的模型
ai_model	1:N	ai_knowledge	知识库可绑定 embedding/rerank 模型
ai_model	1:N	ai_scm_nlq_log	问数日志记录所用模型
ai_model	1:N	ai_scm_forecast_result	预测结果记录模型来源
ai_model	1:N	ai_scm_model_call_log	所有模型调用统一记录
ai_prompt_template	1:N	ai_scm_report_template	报表模板可引用提示词模板
ai_chat_conversation	1:N	ai_chat_message	一次会话下有多条消息
ai_knowledge	1:N	ai_knowledge_document	一个知识库有多份文档
ai_knowledge	1:N	ai_knowledge_segment	一个知识库有多条分段
ai_knowledge_document	1:N	ai_knowledge_segment	一个文档会被切分成多个分段
ai_scm_data_asset	1:N	ai_scm_field_semantic	一个数据资产下有多字段语义定义
ai_scm_metric_category	1:N	ai_scm_metric	一个指标分类下有多个指标
ai_scm_data_asset	1:N	ai_scm_metric	一个指标可指定来源数据资产
ai_scm_metric	1:N	ai_scm_metric_sql	一个指标可有多个 SQL 版本
ai_scm_metric	1:N	ai_scm_metric_result	一个指标产生多期结果
ai_scm_metric	1:N	ai_scm_warning_rule	一个指标可绑定多条预警规则
ai_scm_push_strategy	1:N	ai_scm_warning_rule	多个规则可复用同一推送策略
ai_scm_warning_rule	1:N	ai_scm_warning_event	一条规则会产生多次事件
ai_scm_warning_event	1:N	ai_scm_recommendation	一个事件可生成多条处理建议
ai_scm_report_template	1:N	ai_scm_report_task	一个模板可派生多个报表任务
ai_scm_subscription	N:1	ai_scm_report_template	订阅可指向报表模板或其他目标对象
ai_scm_nlq_template	1:N	ai_scm_nlq_log	样例问题被使用后形成问数日志

六、模块之间的调用关系总说明

AI助手内部各模块并非孤立，而是形成了“业务数据 → 数据资产 → 指标 → 预警/报表/预测 → 建议 → 推送/审计”的完整闭环。

• 模型配置为所有 AI 能力提供底座，负责模型、API Key、Prompt、工具函数、额度和安全策略。

• 知识库与语义为 AI 问数、RAG 检索、术语解释和字段理解提供语义支撑。

• 指标中心是数据标准层，为经营分析、预警、报表和预测提供统一指标口径与结果。

• 预警中心消费指标结果和规则，触发预警事件并通过推送策略通知用户。

• 报表中心消费指标结果、预警事件和提示词模板，生成日报、周报、月报与专项报告。

• 预测决策模块消费历史指标、分析结果与模型能力，输出销量预测、补货建议、采购建议等结果。

• 审计与权限记录所有模型调用、问数、工具调用、SQL 生成与操作过程，保证可追溯。

典型调用链路示意：

• 业务源表（OMS/PUR/WMS/TMS/FIN/TRACE） → ai_scm_data_asset / ai_scm_field_semantic → ai_scm_metric / ai_scm_metric_sql → ai_scm_metric_result。

• ai_scm_metric_result → ai_scm_warning_rule → ai_scm_warning_event → ai_scm_push_strategy / ai_scm_message。

• ai_scm_metric_result + ai_prompt_template → ai_scm_report_template → ai_scm_report_task → 报表文件。

• ai_scm_metric_result + 历史经营数据 + ai_model → ai_scm_forecast_result → ai_scm_recommendation。

• ai_knowledge / ai_knowledge_document / ai_knowledge_segment + ai_scm_data_asset / ai_scm_field_semantic → AI智能问数 / RAG检索测试。

七、各二级模块作用与操作说明

7.1 智能工作台

AI助手的统一入口，承接驾驶舱总览、待办、问数、日报、预警概览与个人订阅内容，是日常高频使用的首页工作区。

三级功能页面	功能作用	主要操作步骤
AI经营驾驶舱	展示销售、采购、库存、毛利、预警等核心指标总览，并以卡片、图表、排行榜形式输出当日经营态势。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
今日异常待办	集中查看今日需处理的缺货、临期、价格异常、损耗异常、任务失败等待办事项。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
AI智能问数	通过自然语言提问，自动生成安全 SQL、执行查询并输出图表与文字分析结论。	输入问题/检索词 → 系统生成结果 → 查看明细 → 验证引用或 SQL → 收藏/保存。
AI经营日报	每天自动生成经营摘要，包含核心指标变化、异常提示和经营建议。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
AI预警概览	汇总预警中心触发的事件数量、等级、处理状态与处理时效。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
常用问题收藏	沉淀高频问数问题与模板，便于一键复用。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
我的订阅推送	查看个人已订阅的报表、预警与快报，以及最近推送结果。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。

7.2 经营分析

围绕采购、销售、库存、配送、财务、供应商与质检溯源等业务场景提供多维经营分析，所有分析结果可作为预警、报表与预测决策的上游输入。

三级功能页面	功能作用	主要操作步骤
采购分析	分析采购金额、数量、单价波动、采购集中度、到货履约情况。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
销售订单分析	分析销售额、订单量、客单价、客户结构、取消率等。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
库存周转分析	分析库存金额、库龄、周转天数、库存结构与安全库存。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
缺货与滞销分析	识别缺货 SKU、滞销 SKU，并给出补货或清理建议。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
配送履约分析	分析配送准时率、签收时效、延迟、拒收与异常线路。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
财务毛利分析	分析毛利率、成本变化、费用分摊、客户/商品毛利异常。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
供应商履约分析	分析供应商到货、价格、质量、及时率与综合评分。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
质检溯源分析	分析质检结果、批次溯源、异常批次与风险追踪。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。

7.3 指标中心

负责指标的全生命周期管理，包括分类、定义、口径、取数SQL、快照结果、看板配置与权限配置，是 AI 问数、预警、报表、预测的统一数据标准层。

三级功能页面	功能作用	主要操作步骤
指标分类	按业务域和层级管理指标分类目录。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
指标定义	维护指标编码、名称、统计周期、业务域、单位、维度等。	新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。
指标口径维护	维护指标公式、统计规则、过滤条件与口径说明。	新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。
指标取数SQL	维护指标 SQL 版本、测试状态、发布状态与参数。	新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。
指标快照	查看定时计算生成的指标结果快照。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
指标看板配置	配置驾驶舱和分析页中图表组件与看板布局。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
指标权限配置	配置不同角色可查看的指标范围。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。

7.4 预警中心

负责预警规则定义、事件触发、主题预警、推送策略与闭环处理，是异常识别与提醒的核心控制台。

三级功能页面	功能作用	主要操作步骤
预警规则	配置预警规则、阈值逻辑、触发条件和作用范围。	新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。
预警事件	查看已触发的所有预警事件并进行处理闭环。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
缺货预警	专门查看缺货类预警与补货建议。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
临期预警	专门查看临期商品预警与处置建议。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
采购价异常	监控采购价波动超阈值的事件。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
毛利异常	监控毛利率低于阈值或大幅波动的事件。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
损耗异常	监控报损率、损耗金额异常变化。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
推送策略	配置站内信、短信、企业微信、邮件等消息渠道和推送时间。	新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。

7.5 报表中心

负责 AI 日报、周报、月报、专项报告模板与任务生成，并向导出下载、订阅推送等能力输出标准化结果。

三级功能页面	功能作用	主要操作步骤
报表模板	定义日报、周报、月报、专题报告的结构和内容。	新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。
AI日报	查看按日生成的 AI 分析报表。	选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。
AI周报	查看按周生成的 AI 分析报表。	选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。
AI月报	查看按月生成的 AI 分析报表。	选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。
专项分析报告	针对专题场景生成的深度分析报告。	选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。
报表任务	管理报表生成任务与调度状态。	选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。
报表生成记录	查看已生成报表的历史记录与生成状态。	选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。
报表导出下载	下载 PDF、Word、Excel 等报表产物。	选择时间与模板 → 生成报表/查询记录 → 查看内容 → 导出下载/订阅推送。

7.6 预测决策

基于指标、历史经营数据与模型能力生成销量预测、补货建议、库存优化、采购建议等建议结果，并形成建议闭环与采纳评估。

三级功能页面	功能作用	主要操作步骤
销量预测	预测未来销量趋势和关键 SKU 销量。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
补货建议	基于销量、库存、安全库存生成补货建议。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
库存优化	基于库存结构与周转结果给出优化建议。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
采购建议	结合销量预测、库存、供应商履约给出采购建议。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
调拨建议	结合门店/仓库库存差异给出调拨建议。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
供应商评分	生成供应商多维评分结果。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
经营建议闭环	汇总系统输出的经营建议，并跟踪处理状态。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
采纳效果评估	评估已采纳建议的后续效果。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。

7.7 知识库与语义

为问数、RAG 检索、术语解释、表字段语义理解提供底层知识能力，是 AI 理解业务语言和数据对象的关键基础设施。

三级功能页面	功能作用	主要操作步骤
知识库管理	管理知识库主对象与业务域分类。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
文档管理	上传制度、SOP、报表解释、术语资料等文档。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
分段向量检索	查看与测试文档分段向量检索效果。	输入问题/检索词 → 系统生成结果 → 查看明细 → 验证引用或 SQL → 收藏/保存。
业务术语库	维护供应链业务术语、同义词、别名。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
表字段语义	维护业务表字段的中文解释、语义标签和是否敏感。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
业务表映射	维护业务对象与源表、字段之间的映射关系。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
问数样例库	维护标准问数样例和推荐问法。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
RAG检索测试	测试知识库召回、重排与引用效果。	输入问题/检索词 → 系统生成结果 → 查看明细 → 验证引用或 SQL → 收藏/保存。

7.8 模型配置

配置 API 密钥、大模型、模型参数、角色、提示词、工具函数、额度与敏感词，决定 AI 能力的可用范围、成本与安全边界。

三级功能页面	功能作用	主要操作步骤
API密钥配置	维护供应商 API Key、额度、失效时间和用途范围。	新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。
大模型配置	维护模型清单、默认参数、上下文长度和成本。	新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。
模型参数方案	按场景维护温度、top_p、输出长度等参数方案。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
助手角色配置	按业务场景配置助手角色和职责。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
提示词模板	维护系统提示词与场景提示词模板。	新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。
工具函数配置	维护 AI 可调用的工具函数与接口能力。	新增/编辑 → 填写主信息 → 保存 → 测试/校验 → 发布/启用。
调用额度配置	维护调用配额、限流、成本控制。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。
敏感词与脱敏	维护敏感词策略与输出脱敏规则。	进入页面 → 设置筛选条件/参数 → 执行查询或操作 → 查看图表/列表/结果 → 导出/推送/保存。

7.9 审计与权限

负责模型调用、问数、工具调用、SQL 审计、成本统计、异常监控与菜单授权，保障系统的可追溯、安全和合规。

三级功能页面	功能作用	主要操作步骤
模型调用日志	审计模型调用次数、耗时、成本和错误信息。	查询日志 → 查看调用详情/异常信息 → 导出日志/分析成本 → 追踪问题。
问数日志	审计自然语言问数请求与执行结果。	查询日志 → 查看调用详情/异常信息 → 导出日志/分析成本 → 追踪问题。
工具调用日志	记录工具函数调用情况。	查询日志 → 查看调用详情/异常信息 → 导出日志/分析成本 → 追踪问题。
生成SQL审计	审计 AI 生成 SQL 的安全性与执行情况。	查询日志 → 查看调用详情/异常信息 → 导出日志/分析成本 → 追踪问题。
成本与Token统计	统计模型调用成本、输入/输出 token 用量。	查询日志 → 查看调用详情/异常信息 → 导出日志/分析成本 → 追踪问题。
异常调用监控	监控调用失败、限流、超时、异常用量等。	查询日志 → 查看调用详情/异常信息 → 导出日志/分析成本 → 追踪问题。

八、AI 助手操作说明书（按业务流程）

8.1 指标建设流程

• 步骤1：进入“指标分类”，建立采购、销售、库存、配送、财务、供应商、质检等分类目录。

• 步骤2：进入“指标定义”，新增指标编码、名称、统计周期、业务域、单位和维度信息。

• 步骤3：进入“指标口径维护”，补充公式说明、过滤条件、口径备注。

• 步骤4：进入“指标取数SQL”，编写或维护取数 SQL，进行测试并发布。

• 步骤5：进入“指标快照”，查看定时任务计算出的指标结果。

• 步骤6：进入“指标看板配置”，将关键指标发布到驾驶舱和分析页面。

• 步骤7：进入“指标权限配置”，限制不同角色可查看的指标范围。

8.2 预警建设与处理流程

• 步骤1：进入“预警规则”，选择对应指标，定义触发条件、阈值、作用范围和预警等级。

• 步骤2：进入“推送策略”，配置通知渠道、接收人、触发时机和静默时间。

• 步骤3：系统按规则扫描指标结果，触发后写入“预警事件”。

• 步骤4：业务人员进入“预警事件”或主题预警页面（缺货预警、临期预警、采购价异常、毛利异常、损耗异常）查看详情。

• 步骤5：处理人录入处理结果、原因、措施，形成闭环。

8.3 报表生成流程

• 步骤1：进入“报表模板”，定义日报/周报/月报/专项报告结构、章节、指标清单和提示词。

• 步骤2：进入“报表任务”，手工或定时下发生成任务。

• 步骤3：系统生成后在“报表生成记录”中保留结果。

• 步骤4：进入“报表导出下载”，下载 Word/PDF/Excel 等结果文件。

• 步骤5：如需自动触达，可配合“我的订阅推送”和“推送策略”进行消息发送。

8.4 智能问数与知识库流程

• 步骤1：先在“知识库管理、文档管理、业务术语库、表字段语义、业务表映射、问数样例库”中准备知识与语义基础。

• 步骤2：进入“AI智能问数”输入自然语言问题，例如“本周毛利异常的商品有哪些？”。

• 步骤3：系统结合字段语义、样例模板、业务表映射生成安全 SQL，并记录到“问数日志”和“生成SQL审计”。

• 步骤4：系统执行查询并输出图表、表格和文字分析。

• 步骤5：如需验证检索效果，可进入“RAG检索测试”和“分段向量检索”。

8.5 预测与建议流程

• 步骤1：进入“销量预测”，生成未来期间销量预测结果。

• 步骤2：系统结合库存现状，自动在“补货建议、库存优化、采购建议、调拨建议”中输出建议内容。

• 步骤3：系统可根据采购、配送、质量等历史表现生成“供应商评分”。

• 步骤4：所有建议统一汇总到“经营建议闭环”，并在“采纳效果评估”中跟踪采纳前后效果。

8.6 模型配置与治理流程

• 步骤1：进入“API密钥配置”，维护各模型供应商 API Key 和额度信息。

• 步骤2：进入“大模型配置”和“模型参数方案”，维护模型清单、默认参数和场景参数。

• 步骤3：进入“助手角色配置”和“提示词模板”，定义不同业务场景下的角色与提示词。

• 步骤4：进入“工具函数配置”，给模型开放可调用的后端工具函数。

• 步骤5：进入“调用额度配置”“敏感词与脱敏”，设置成本控制和输出安全规则。

九、各三级页面的上游输入、核心处理、输出去向

序号	三级功能	上游输入	核心处理	输出去向
1	AI经营驾驶舱	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
2	今日异常待办	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
3	AI智能问数	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
4	AI经营日报	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
5	AI预警概览	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
6	常用问题收藏	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
7	我的订阅推送	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
8	采购分析	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
9	销售订单分析	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
10	库存周转分析	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
11	缺货与滞销分析	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
12	配送履约分析	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
13	财务毛利分析	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
14	供应商履约分析	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
15	质检溯源分析	业务源数据 / 配置表 / 用户输入	查询、计算、分析、生成、推送、记录	页面展示 / 报表 / 预警 / 建议 / 日志
16	指标分类	数据资产、字段语义、业务表	定义指标、维护SQL、计算快照	分析页、预警、报表、预测
17	指标定义	数据资产、字段语义、业务表	定义指标、维护SQL、计算快照	分析页、预警、报表、预测
18	指标口径维护	数据资产、字段语义、业务表	定义指标、维护SQL、计算快照	分析页、预警、报表、预测
19	指标取数SQL	数据资产、字段语义、业务表	定义指标、维护SQL、计算快照	分析页、预警、报表、预测
20	指标快照	数据资产、字段语义、业务表	定义指标、维护SQL、计算快照	分析页、预警、报表、预测
21	指标看板配置	数据资产、字段语义、业务表	定义指标、维护SQL、计算快照	分析页、预警、报表、预测
22	指标权限配置	数据资产、字段语义、业务表	定义指标、维护SQL、计算快照	分析页、预警、报表、预测
23	预警规则	指标结果、规则配置、推送策略	规则判断、事件生成、消息推送、闭环处理	消息中心、工作台、报表、建议
24	预警事件	指标结果、规则配置、推送策略	规则判断、事件生成、消息推送、闭环处理	消息中心、工作台、报表、建议
25	缺货预警	指标结果、规则配置、推送策略	规则判断、事件生成、消息推送、闭环处理	消息中心、工作台、报表、建议
26	临期预警	指标结果、规则配置、推送策略	规则判断、事件生成、消息推送、闭环处理	消息中心、工作台、报表、建议
27	采购价异常	指标结果、规则配置、推送策略	规则判断、事件生成、消息推送、闭环处理	消息中心、工作台、报表、建议
28	毛利异常	指标结果、规则配置、推送策略	规则判断、事件生成、消息推送、闭环处理	消息中心、工作台、报表、建议
29	损耗异常	指标结果、规则配置、推送策略	规则判断、事件生成、消息推送、闭环处理	消息中心、工作台、报表、建议
30	推送策略	指标结果、规则配置、推送策略	规则判断、事件生成、消息推送、闭环处理	消息中心、工作台、报表、建议
31	报表模板	指标结果、预警事件、提示词模板	模板渲染、AI生成、任务调度、导出	文件下载、订阅推送、操作留痕
32	AI日报	指标结果、预警事件、提示词模板	模板渲染、AI生成、任务调度、导出	文件下载、订阅推送、操作留痕
33	AI周报	指标结果、预警事件、提示词模板	模板渲染、AI生成、任务调度、导出	文件下载、订阅推送、操作留痕
34	AI月报	指标结果、预警事件、提示词模板	模板渲染、AI生成、任务调度、导出	文件下载、订阅推送、操作留痕
35	专项分析报告	指标结果、预警事件、提示词模板	模板渲染、AI生成、任务调度、导出	文件下载、订阅推送、操作留痕
36	报表任务	指标结果、预警事件、提示词模板	模板渲染、AI生成、任务调度、导出	文件下载、订阅推送、操作留痕
37	报表生成记录	指标结果、预警事件、提示词模板	模板渲染、AI生成、任务调度、导出	文件下载、订阅推送、操作留痕
38	报表导出下载	指标结果、预警事件、提示词模板	模板渲染、AI生成、任务调度、导出	文件下载、订阅推送、操作留痕
39	销量预测	历史指标、库存、销量、模型参数	预测、推荐、评估	建议闭环、采纳评估、报表
40	补货建议	历史指标、库存、销量、模型参数	预测、推荐、评估	建议闭环、采纳评估、报表
41	库存优化	历史指标、库存、销量、模型参数	预测、推荐、评估	建议闭环、采纳评估、报表
42	采购建议	历史指标、库存、销量、模型参数	预测、推荐、评估	建议闭环、采纳评估、报表
43	调拨建议	历史指标、库存、销量、模型参数	预测、推荐、评估	建议闭环、采纳评估、报表
44	供应商评分	历史指标、库存、销量、模型参数	预测、推荐、评估	建议闭环、采纳评估、报表
45	经营建议闭环	历史指标、库存、销量、模型参数	预测、推荐、评估	建议闭环、采纳评估、报表
46	采纳效果评估	历史指标、库存、销量、模型参数	预测、推荐、评估	建议闭环、采纳评估、报表
47	知识库管理	文档、术语、表字段、样例问题	切分、向量化、语义映射、检索	问数、RAG、解释说明
48	文档管理	文档、术语、表字段、样例问题	切分、向量化、语义映射、检索	问数、RAG、解释说明
49	分段向量检索	文档、术语、表字段、样例问题	切分、向量化、语义映射、检索	问数、RAG、解释说明
50	业务术语库	文档、术语、表字段、样例问题	切分、向量化、语义映射、检索	问数、RAG、解释说明
51	表字段语义	文档、术语、表字段、样例问题	切分、向量化、语义映射、检索	问数、RAG、解释说明
52	业务表映射	文档、术语、表字段、样例问题	切分、向量化、语义映射、检索	问数、RAG、解释说明
53	问数样例库	文档、术语、表字段、样例问题	切分、向量化、语义映射、检索	问数、RAG、解释说明
54	RAG检索测试	文档、术语、表字段、样例问题	切分、向量化、语义映射、检索	问数、RAG、解释说明
55	API密钥配置	供应商配置、模型能力、提示词	参数管理、成本控制、安全脱敏	所有 AI 调用场景
56	大模型配置	供应商配置、模型能力、提示词	参数管理、成本控制、安全脱敏	所有 AI 调用场景
57	模型参数方案	供应商配置、模型能力、提示词	参数管理、成本控制、安全脱敏	所有 AI 调用场景
58	助手角色配置	供应商配置、模型能力、提示词	参数管理、成本控制、安全脱敏	所有 AI 调用场景
59	提示词模板	供应商配置、模型能力、提示词	参数管理、成本控制、安全脱敏	所有 AI 调用场景
60	工具函数配置	供应商配置、模型能力、提示词	参数管理、成本控制、安全脱敏	所有 AI 调用场景
61	调用额度配置	供应商配置、模型能力、提示词	参数管理、成本控制、安全脱敏	所有 AI 调用场景
62	敏感词与脱敏	供应商配置、模型能力、提示词	参数管理、成本控制、安全脱敏	所有 AI 调用场景
63	模型调用日志	调用行为、SQL、操作行为	审计、监控、统计、授权	风控治理、问题排查、合规
64	问数日志	调用行为、SQL、操作行为	审计、监控、统计、授权	风控治理、问题排查、合规
65	工具调用日志	调用行为、SQL、操作行为	审计、监控、统计、授权	风控治理、问题排查、合规
66	生成SQL审计	调用行为、SQL、操作行为	审计、监控、统计、授权	风控治理、问题排查、合规
67	成本与Token统计	调用行为、SQL、操作行为	审计、监控、统计、授权	风控治理、问题排查、合规
68	异常调用监控	调用行为、SQL、操作行为	审计、监控、统计、授权	风控治理、问题排查、合规

十、角色与权限建议

• 系统管理员：负责模型配置、菜单授权、多语言维护、所有日志审计。

• AI运营管理员：负责指标、预警、报表、知识库、样例库、提示词模板运营。

• 业务分析员：负责经营分析、问数、驾驶舱、报表查看与专题分析。

• 采购/库存/财务/配送负责人：重点使用相关分析页、预警页和建议页。

• 普通业务用户：查看与自身权限相关的驾驶舱、消息、日报、订阅内容。

十一、安全与审计要求

• 自然语言问数生成的 SQL 必须只允许 SELECT，只能查询授权表，且必须进行行数限制。

• 所有模型调用必须写入 ai_scm_model_call_log，并记录模型、场景、耗时、token 和成本。

• 所有关键操作必须写入 ai_scm_operation_log，包括新增/修改/删除/发布/启停。

• AI 输出内容需经过敏感词与脱敏策略过滤，防止泄露客户、价格、财务等敏感信息。

• 消息推送需遵守静默时段、订阅状态和接收范围控制，避免骚扰式通知。

十二、实施与上线建议

• 建议先建设：模型配置、指标中心、预警中心、报表中心、知识库与语义。

• 第二阶段建设：经营分析、AI智能问数、预测决策。

• 第三阶段完善：成本审计、异常监控、多语言维护、建议闭环与效果评估。

• 上线前需完成：权限联调、数据源联调、指标口径确认、SQL 安全测试、模型成本压测、推送通道测试。

十三、附件

附件一：AI 数据库 E-R 图（已嵌入文档，共 4 张）。

附件二：AI 核心表清单（29 张）。

附件三：AI 助手 9 大模块 / 70 个三级功能页面说明。

AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

三相逆变器PQ控制模型仿真研究（simulink仿真实现）

随着分布式光伏发电、风力发电、储能系统等新能源发电单元的大规模并网，三相逆变器作为电能变换与电网交互的核心设备，其功率控制性能直接决定新能源并网的稳定性、可靠性与电能质量。PQ恒功率控制是三相并网逆变器的主流控制策略，可实现逆变器有功、无功功率的独立精准调控，适配新能源发电功率波动、电网调压调频等复杂运行场景。本文以三相并网逆变器为研究对象，系统阐述PQ控制的核心架构与工作机理，搭建完整的逆变器P

AtomGit开源社区

Apollo- 分布式部署下的配置同步：跨机房配置的同步策略与实操

AtomGit开源社区

发电机故障暂态仿真及电压电流变化特性研究（Simulink仿真实现）

发电机作为电力系统的核心发电设备，其运行稳定性直接决定整个电网的安全可靠水平。电网运行过程中各类突发故障会引发发电机电磁暂态过程，造成机端电压、定子电流、转子电流等电气参数剧烈波动，严重时会导致设备损坏、机组脱网甚至系统性停电事故。为精准掌握发电机故障状态下的电气量变化规律，本文依托电力系统电磁暂态仿真平台搭建标准发电机仿真模型，模拟三相短路、单相接地短路、两相短路等典型电网故障场景，系统分析不同