错误处理与降级策略

设计理念

任何错误都不应中断用户的创造流程。降级，不中断。

错误场景	检测方式	降级策略	告知用户
Python 3 不可用	`python3 --version` 失败	跳过 gacha.py，从 10 类预设方向中随机选择	"抽卡引擎需要 Python 3，已改用内置随机选择"

错误场景	检测方式	降级策略	告知用户
生图 skill 未安装	检查 skill 是否存在	输出完整提示词文本 + 手动生图平台说明	"未检测到可用的生图 skill，已输出提示词供手动使用"
生图 skill 调用失败	skill 返回错误	重试 1 次，仍失败则输出提示词文本	"生图失败，已输出提示词供手动使用"

错误场景	降级策略	告知用户
gacha.py 输出格式异常	从 10 类预设方向中随机选择	"抽卡结果解析失败，已改用内置随机"
任何未预期错误	记录错误信息，跳过该步骤，继续主流程	"遇到了一个问题：[错误简述]。已跳过继续"

markdown

> [警告] **[步骤名] 已降级**
> 原因：[发生了什么]
> 影响：[什么功能受限]
> 替代：[正在用什么兜底]
> 修复：[怎么恢复完整功能]

示例：

markdown

> [警告] **头像生成已降级**
> 原因：未检测到可用的生图 skill
> 影响：无法自动生成头像图片
> 替代：已输出完整提示词，可复制到 Gemini / ChatGPT 手动生成
> 修复：在当前环境中安装并启用经过审核的生图 skill