自动化错误恢复机制

问题背景

Agent 在跑文件 I/O、网络请求和依赖安装时，常见失败是路径不存在、权限不对、超时或 ModuleNotFoundError。若每次都要人工改路径、重试或换方案，长任务很容易在中途断掉，且同类错误会在新会话里反复出现。

技能如何工作

本技能把错误处理拆成分类 → 自动修复 → 降级 → 记录与学习几条线。

• 错误分类：按文件操作、网络请求、工具/依赖调用等维度归类，并区分严重程度，便于选策略。
• 自动修复：例如文件不存在时创建父目录；权限不足时调整权限；编码异常时轮询多种编码；网络超时用指数退避重试；触达 API 速率限制则等待后重试；模块缺失尝试安装，版本冲突则建议/创建虚拟环境。
• 降级方案：主路径失败时切换到备用实现（文档中涉及 OCR、PDF 生成、中文文本处理等场景的降级）。
• 记录与跨会话学习：结构化写入错误日志（如 error_log.json），做错误模式分析，并可将结论同步到 MEMORY.md，减少重复踩坑。
• 主动预防：任务开始前走预检查清单，结合历史模式给出修复建议。

集成方式包括装饰器 @with_error_recovery（可配置异常类型、重试次数、fallback_func），以及显式调用各类 auto_fix_* 与 pre_check_before_task()。

适用边界

策略针对 SKILL 文档中列出的错误类型与场景设计，不能替代业务逻辑层面的正确性校验。自动安装依赖、改权限等操作在受限环境可能失败或不被允许；降级路径需你自行实现并传入 fallback_func。跨会话学习依赖持久化日志与 MEMORY 更新策略，需与项目安全与隐私要求对齐。