用途：作为 QuickBI 数据分析的统一入口，自动识别用户意图并路由到对应模块，无需手动选择。
主要能力：文件问答（上传 Excel/CSV 经 Quick BI API 智能分析）；数据集问答（对平台数据集做自然语言查询，自动选表匹配）；文档解析（解析 PDF/Word/Excel/CSV/图片，提取文本与关键字段生成结构化 Excel）；仪表板技能生成（将 QuickBI 仪表板转为数据查询技能）；数据洞察（对数据集做深度解读与趋势分析）；数据报告（基于分析结果自动生成专业报告）。
使用方式：按意图路由，含“报告/复盘/总结报告/分析报告”等关键词优先走数据报告；“解读/洞察/趋势”走数据洞察；具体指标查询走问答模块；提供仪表板 URL 时按意图走技能生成或数据洞察。上传 ≥5 个非结构化文档时须先做文档解析再路由。图表以 Markdown 图片语法 作为唯一交付方式，须原样写入回复正文，且单次回复完成。
配置：分层配置，优先级为环境变量 ACCESS_TOKEN、工作区 <workspace-dir>/.qbi/smartq-chat/config.yaml、全局 ~/.qbi/config.yaml、包内 default_config.yaml。未配置 api_key/api_secret 时自动注册试用凭证，试用到期由服务端错误码 AE0579100004 控制。
限制：需安装 pip install requests pyyaml matplotlib numpy；仪表板技能生成需浏览器自动化能力；数据集问答需有目标数据集问答权限；文件问答仅支持 xls、xlsx、csv，单文件 ≤5MB；文档解析本地解析需 brew install tesseract tesseract-lang，单文件 ≤5MB，本地失败回退远程 OCR，未知类型需用户确认后再生成 Excel。不用于与 QuickBI 数据分析无关的任务。