Bug修复助手

它解决什么问题

在 Python 项目里，很多低层 Bug 不是靠读一遍代码就能发现：日期排序忘记 reverse=True、嵌套列表误用 .append([...])、if x = y 这类赋值误写、缺少冒号、裸 except: 吞异常，都会在运行时或评审中暴露。若再对多个文件做人工搜索和替换，既容易漏，也容易误伤。

Bug修复助手 面向这类确定性、可模式化的 Python 问题，把扫描、修复和可选 AI 分析组织成可直接被 Agent 调用的库。

核心工作方式

它不以独立 CLI 为主，而是提供 bug_fixer.py，由 AI 或自动化流程调用。常用入口包括：

• analyze(code, filename="input", use_ai=True)：分析代码片段，执行扫描和自动修复，可选返回 AI 分析。
• scan_file(filepath, auto_fix=True)：扫描单个 .py 文件，默认写回修复结果。
• scan_directory(directory=".")：扫描目录下所有 Python 源码，并跳过 .git、__pycache__、node_modules、虚拟环境和构建目录。

内置规则分为两类。第一类是本地确定性规则，无需外部 API，毫秒级处理，例如把日期场景下的 sorted(...) 补上 reverse=True、把嵌套列表 .append([...]) 改成 .extend([...])、把 if x = y 修正为 if x == y、补上缺失冒号、把裸 except: 改成 except Exception:。可变默认参数如 def f(x=[]) 会被标记为 NEEDS-REVIEW，不自动修改，避免影响运行时语义。

第二类是AI 深度分析。配置 SILICONFLOW_API_KEY 后，可调用 SiliconFlow（DeepSeek-V3）检查复杂业务逻辑、潜在空指针或类型问题、SQL 注入/XSS 等安全风险、性能与并发问题，以及代码可读性。若 Key 未配置、网络失败或超时，系统会降级为确定性规则结果，而不是直接中断。

适用边界

这个技能适合快速清理 Python 项目中高频语法误用和低级模式 Bug，不适合替代人工 Code Review 或复杂算法审查。它只扫描 .py 文件，不处理 JS/Go 等其它语言；自动写回会覆盖原文件，批量修复前建议先提交版本控制；超大型文件会整文件读入内存，建议拆分处理；自动修复保证语法层面更稳，但不保证业务语义一定正确，尤其涉及排序方向和比较语义时，需要开发者确认。