要实现高质量可视化报表，需明确结构化输入主题、配置credentials.json启用API、通过LUI语言界面迭代优化、本地Docker部署保障一致性，并正确嵌入HTML报表至第三方系统。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望使用雾象Fogsight将抽象概念转化为具备逻辑表达与视觉叙事能力的动态可视化内容，但当前输出结果未达预期或缺乏结构化呈现效果，则可能是由于输入提示不明确、API配置缺失或未启用交互式调优机制。以下是实现高质量可视化报表效果的具体操作路径：
一、明确输入主题并结构化描述
雾象Fogsight依赖大语言模型对输入语义进行深度解析，并据此生成镜头脚本与视觉映射逻辑。模糊或过于宽泛的主题（如“人工智能”）易导致旁白泛化、画面元素松散；而加入限定维度（如学科领域、目标受众、核心矛盾）可显著提升报表级信息密度与教学有效性。
1、打开 http://127.0.0.1:8000 或访问 fogsight.ai 网站界面。
2、在输入框中键入带有上下文约束的主题，例如：“面向初中生的光合作用流程图解，含叶绿体结构标注、能量转化箭头与双语旁白”。
3、避免使用纯名词短语，确保包含动作动词、空间关系与认知层级关键词（如“对比”“步骤分解”“因果链”）。
二、配置credentials.json启用高级渲染能力
Fogsight默认调用本地LLM接口生成基础脚本，但完整可视化报表所需的多模态协同（如动态图表嵌入、SVG矢量转场、时间轴同步配音）需通过有效API密钥激活后端引擎。未配置或密钥失效将导致输出仅含静态帧序列，无法形成报表所需的连续逻辑流。
1、定位项目根目录下的 demo-credentials.json 文件。
2、复制该文件并重命名为 credentials.json。
3、用文本编辑器打开 credentials.json，填入您申请的 Google Gemini 2.5 Pro API_KEY 及对应 BASE_URL（如 https://generativelanguage.googleapis.com/v1beta ）。
4、保存文件后重新运行 python start_fogsight.py 启动服务。
三、使用LUI语言界面迭代优化报表结构
初始生成的动画可能未完全匹配用户对信息优先级、节奏控制与视觉权重的预期。Fogsight内置的语言用户界面（LUI）支持自然语言指令实时干预生成过程，是构建专业级可视化报表的关键环节，而非一次性输出即定稿。
1、等待首版动画生成完成后，在对话框中输入调整指令，例如：“将第三幕的二氧化碳分子运动轨迹改为红色虚线箭头，并延长停留2秒”。
2、继续追加指令：“在左上角添加‘知识要点’浮动标签，显示‘光反应发生于类囊体膜’”。
3、输入：“导出为HTML格式，保留所有交互控件与时间轴滑块”。
4、确认修改生效后点击“导出报表”，系统将打包含内联CSS/JS的单HTML文件，可直接嵌入教学平台或知识管理系统。
四、本地部署Docker容器保障报表一致性
当需要批量生成标准化可视化报表（如系列课程动画、企业培训模块），本地Python环境易受依赖版本冲突影响，导致同一输入在不同机器上输出差异。Docker镜像封装了完整运行时栈，确保渲染逻辑、字体渲染、音频同步等关键环节零偏差。
1、确保系统已安装 Docker Desktop 并启动守护进程。
2、执行命令拉取官方镜像：docker pull fogsightai/fogsight:latest。
3、创建挂载目录存放 credentials.json 和导出报表：mkdir -p ~/fogsight-data/{config,export}。
4、运行容器并映射端口与卷：docker run -d -p 8000:8000 -v ~/fogsight-data/config:/app/config -v ~/fogsight-data/export:/app/export --name fogsight fogsightai/fogsight。
5、浏览器访问 http://localhost:8000 即可开始报表制作，所有生成物自动落盘至 ~/fogsight-data/export。
五、嵌入HTML报表至第三方系统
Fogsight导出的HTML文件为自包含式资源包，内嵌所有脚本、样式与媒体资产，但若需集成至CMS、LMS或内部BI看板，须确保宿主页面允许执行内联JavaScript及Canvas渲染，否则将退化为静态截图。
1、从 export 目录获取生成的 report_XXXXX.html 文件。
2、在目标系统支持HTML组件的位置，粘贴以下代码片段：。
3、若宿主系统禁用iframe沙箱，改用 。
4、检查浏览器开发者工具Console面板，确认无 "Blocked script execution" 或 "Canvas is tainted" 报错。
