若Fogsight生成AI动画时出现数据异常，需依次排查：一、本地环境（Python 3.9～3.11、PyTorch≥2.1.0、ilogtail存在、credentials.json权限及密钥合法）；二、LLM接口连通性（curl测试响应、服务进程、模型路径与权重）；三、动画编排引擎（日志关键词、ffmpeg、临时帧、Stable Diffusion进程）；四、输入内容与预处理（语义长度、特殊符号、规则屏蔽、Base64编码）；五、双语旁白合成（TTS模型加载、音频设备、共享内存缓冲区）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用雾象Fogsight生成AI动画时出现数据异常（如输入主题后无响应、动画卡在加载、旁白缺失、分镜脚本错乱或输出画面静止），则可能是由于本地运行环境配置偏差、模型服务中断或输入解析链路中断所致。以下是排查此问题的步骤：
一、检查本地运行环境与依赖状态
本地化部署是Fogsight的核心运行模式，依赖项缺失或版本冲突会直接导致数据解析失败或生成流程中断。需确认Python环境、模型加载器及插件服务是否处于就绪状态。
1、打开终端，执行 python3 --version，确认版本为3.9～3.11；
2、进入Fogsight项目根目录，运行 pip list | grep torch，验证PyTorch是否为2.1.0及以上且CUDA版本匹配；
3、执行 ls -l /usr/local/ilogtail/，检查ilogtail日志采集组件是否存在（用于监控LLM调用链路）；
4、查看 credentials.json 文件权限是否为600，内容中API密钥字段是否为空或含非法字符。
二、验证LLM接口连通性与响应质量
LLM是Fogsight的逻辑中枢，负责将输入主题转化为结构化脚本。若其返回空响应、JSON格式错误或超时，将导致后续动画编排引擎无法获取有效指令。
1、在终端中执行 curl -X POST http://localhost:8000/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"qwen3","messages":[{"role":"user","content":"用熵增定律生成30秒动画分镜"}]}'；
2、观察返回是否含 "choices":[{...}] 且 "finish_reason":"stop"；
3、若返回 503 Service Unavailable，说明LLM服务未启动，需检查 llm_server.py 进程；
4、若返回内容含大量乱码或非JSON结构，检查 qwen3 模型权重路径是否指向正确目录，且 model.bin 文件大小不为0字节。
三、定位动画编排引擎阻塞点
动画编排引擎依据LLM输出的JSON脚本调度视觉生成、转场合成与音效注入。任一环节未收到预期输入或超时等待，均会导致数据流中断或输出异常。
1、查看 /var/log/fogsight/engine.log 最近10行，搜索关键词 "script parse failed" 或 "timeout waiting for render"；
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
2、确认 ffmpeg 是否已安装并可执行：运行 ffmpeg -version，输出应含“Copyright (c) 2000-2025”字样；
3、检查 /tmp/fogsight_render/ 目录下是否存在临时帧序列（如 frame_0001.png 至 frame_0030.png），缺失则表明视觉生成模块未触发；
4、运行 ps aux | grep stable-diffusion，验证Stable Diffusion WebUI进程是否存活且显存占用>2GB。
四、审查输入内容与预处理规则
Fogsight对输入主题存在语义长度与实体约束。过短、含特殊符号、或触发安全过滤机制的输入，会被前置清洗模块截断或替换，导致后续生成失真。
1、在Web界面输入框中键入 "欧拉定理"（不含引号、空格、标点），点击生成，观察是否正常产出微积分课件动画；
2、若失败，改用CLI命令：python cli_gen.py --topic "Euler's theorem" --lang zh-en，绕过前端JS校验；
3、检查 config/preprocess_rules.yaml 中 blocklist_keywords 字段是否误包含“定理”“熵”等基础术语；
4、手动编辑 input_queue.json，将原始输入字段替换为Base64编码字符串，避免UTF-8解析歧义。
五、核验双语旁白合成模块状态
双语旁白依赖TTS服务链路，异常常表现为无声、单语种输出、语音重复或时长严重偏离设定值，根源多为音频缓冲区溢出或语言模型未加载。
1、进入 /opt/fogsight/tts/ 目录，运行 python tts_healthcheck.py；
2、检查输出中 "zh-CN model loaded: True" 与 "en-US model loaded: True" 是否均为True；
3、执行 arecord -l，确认系统识别到音频采集设备（即使仅用于测试）；
4、查看 /dev/shm/tts_buffer 共享内存段大小，若小于 64MB，需修改 tts_config.ini 中 buffer_size = 67108864。
