支持与排障
反馈问题与查找排障资料
Novaber · 内容核对
本页目录
先判断问题发生在哪一步
区分主程序安装、环境检查、镜像下载、模型准备、服务启动、任务处理和导出。只说“打不开”无法判断需要查哪一层。先记录最后成功的步骤,再复制紧接着出现的错误提示。
建议提供的复现信息
以下是帮助定位问题的信息建议,不要求公开原始私有素材。用可公开或已脱敏的最小样本复现更便于排查。
- 主程序版本;涉及应用时,补充应用名称和应用版本。
- Windows 版本、GPU 型号;涉及环境时补充 WSL 和 Docker 检查结果。
- 从哪一步开始、做了什么、期望结果和实际结果。
- 完整错误文字、发生时间及相关截图或日志片段。
- 是否每次发生,以及使用小样本能否复现。
提交前检查隐私
先移除密码、令牌、验证码、账户会话、私有路径和无关个人信息。日志只截取问题附近的必要部分;Gitee Issue 是公开入口,不要直接贴完整环境文件、账户数据或私有素材。
通过官网提交反馈
请先登录,再提交意见或投诉。
每个账户每天限提交一次,以北京时间零点为界。请填写具体情况(最多 5000 字),不要包含密码等敏感信息。我们将通过账户邮箱联系你。
安装排障与公开问题入口
先搜索是否已有相同问题;补充信息时沿用同一问题记录,避免拆成多条无法对应的反馈。
尚未定位失败阶段时,可先按常见问题索引查找;抠图去印的素材、修复与导出问题见应用常见问题。
GPU 或安装问题需要补充什么?
先按驱动与 CUDA 基线核对,再在反馈中补充以下证据:
- Windows 版本、GPU 型号与
nvidia-smi读取的完整驱动版本;主版本是否 ≥ 575,Windows 驱动是否 ≥ 576.57,以及项目 CUDA 12.9.1 基线的核对结果。 - 主程序、子应用和安装 Skill 的各自版本。使用 Skill 1.0.3 时,说明检测脚本与参考是否来自同一资料包。
- 检测报告的
checks.gpu.status、checks.gpu.reason和必要证据。低于主版本门槛为nvidia-driver-major-too-old,低于 Windows 基线为nvidia-driver-below-cuda-baseline;读不到版本、查询失败或权限受限应按实际状态记录。 - 容器 GPU 检查是否实际执行,以及应用启动、模型准备、小任务和导出分别进行到了哪一步。未测试的项目写明“未验证”。
nvidia-smi 的 CUDA Version 不作为实际应用运行时版本或已安装 Toolkit 的证明。分享报告前移除令牌、密码、完整私有路径和无关日志;报告字段的解释见安装诊断。