animated drawings运行报错需逐层排查：架构冲突时限定~/.condarc的subdirs为osx-arm64和noarch；pyopengl缺失gl库需按系统安装对应开发包并严格指定3.15版本；图像标注失败须检查输入格式、模型文件完整性及gpu显存；json配置错误用python -m json.tool精准定位；包导入失败需确认setup.py和__init__.py存在并执行pip install -e .
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Animated Drawings运行时提示报错，说明模型加载、图像处理或配置文件环节已中断，必须逐层验证基础依赖与输入条件才能继续生成动画。
Conda环境创建失败：架构冲突问题
在Apple Silicon设备上执行conda create --name animated_drawings python=3.8.13报错，提示osx-64与osx-arm64不匹配。
第一步：检查~/.condarc文件内容，确认是否混入了https://repo.anaconda.com/pkgs/main等x86通道。
第二步：用文本编辑器打开~/.condarc，将subdirs字段强制限定为M1/M2专用架构：
【subdirs: - osx-arm64 - noarch】
第三步：清空conda缓存并重建环境，避免旧包残留干扰：
conda clean --all && conda create --name animated_drawings python=3.8.13 --yes
PyOpenGL安装失败：系统图形库缺失
执行pip install -e .时编译报错，提示找不到GL/gl.h或libGL.so，本质是操作系统未提供OpenGL开发头文件与运行时库。
方法一（Ubuntu/Debian）：
sudo apt-get update && sudo apt-get install libgl1-mesa-dev libglu1-mesa-dev freeglut3-dev
方法二（macOS）：
brew install freeglut → 这一步不能跳过，Homebrew默认不安装freeglut，而PyOpenGL 3.1.5编译时强依赖它。
完成后立即安装指定版本：pip install PyOpenGL==3.1.5 → 版本必须严格匹配，高版本会触发ABI不兼容错误。
图像标注失败：人物检测不到
运行image_to_animation.py后生成的JSON标注为空，或关节坐标全为[0,0]，说明OpenPose人体检测器未触发有效推理。
① 检查输入图像：必须为RGB三通道、无EXIF旋转标记的JPEG/PNG，尺寸建议在512×512到1024×1024之间。超宽比（如9:16竖图）会导致关键点严重偏移。
② 验证模型路径：确认models/pose_coco.pth文件真实存在且大小不为0。若从Git LFS下载中断，该文件可能仅含placeholder文本。
③ 强制重载检测器：在脚本开头插入import torch; torch.cuda.empty_cache()，防止GPU显存残留干扰新模型加载。
配置文件验证失败：JSON格式错误
启动动画生成时报错json.decoder.JSONDecodeError，指向某一行有非法字符，常见于手动编辑配置时误粘贴中文标点或换行符。
用VS Code打开config.json，启用“显示所有字符”功能（Ctrl+Shift+P → Toggle Render Whitespace），重点检查逗号后是否有全角空格、引号是否为中文双引号“”、末尾是否多出逗号。
用python -m json.tool config.json命令校验——如果报错，终端会直接指出第几行第几个字符非法，这是最准的定位方式。
AnimatedDrawings包无法导入
Python交互式环境中执行import animated_drawings失败，提示ModuleNotFoundError，说明包未正确安装或路径未注册。
进入项目根目录，确认存在setup.py和animated_drawings/__init__.py两个文件。
激活conda环境后，执行pip install -e .（注意末尾的英文句点），该命令会将当前目录作为可编辑包安装进环境，而非复制文件。
若仍失败，检查sys.path输出中是否包含项目根目录路径——没有则说明-e安装未生效，需重新运行安装命令。
