用途:检测可安全删除的无用代码,帮助识别清理候选。仅报告发现,不执行删除,删除是另一项独立任务。默认聚焦生产代码(ols/ 目录),除非明确要求,否则跳过测试。
主要流程:
- 确定范围。可选择分支模式(仅当前分支相对 main 改动的文件)或全量模式(扫描整个 ols/ 目录)。分支模式使用命令:git diff --name-only origin/main -- 'ols/' | grep '.py$'
- 运行 Vulture:uvx vulture <target> --min-confidence 80。阈值 80 可减少噪声,更低置信度的结果更可能是误报。
- 运行 Pylint 未使用检查:uv run pylint --disable=all --enable=unused-import,unused-variable,unused-argument,unreachable <target>,并与 Vulture 结果交叉引用以提高置信度。
- 过滤误报。常见误报包括:Pydantic 的 model_validator/field_validator(由 Pydantic 调用)、FastAPI 依赖函数(通过 Depends() 注入)、eq/hash/str 等魔术方法(Python 隐式调用)、配置 YAML 中使用的常量、抽象方法的实现、init.py 中再导出的导入。
- 分类发现:明确未使用且无动态引用者可标记为移除;可能被动态或外部使用者为“待验证”,移除前需用 rg "<名称>" ols/ tests/ 搜索字符串引用;Pydantic/FastAPI/魔术方法等为误报,跳过。
报告内容:每项发现需含文件与行号、未使用对象类型(函数、类、导入、变量)、置信度(Vulture 百分比)、分类(移除/验证/误报),并汇总总数、可安全移除数量及预估节省行数。
限制:Vulture 存在误报,需逐项分类;仅通过动态分发使用的代码不算死代码;本技能不负责删除操作。