展开本页目录
开始前准备什么
- 下载本题完整练习包，区分待实现 starter 与作者完成 reference。
- 按README准备本题原生依赖；所有输入均为原创或明确标注的本地fixture。
- 本地练习不需要付费模型Key；真实模型调用未执行，MiniLM题另有明确实际推理说明。
- 准备注册插件
- 先运行行为
- 执行Ruff修复
- 复现加载失败
- 限定保留导入
- 再查无用导入
- 同时验收两侧
下载本题完整练习工程
原创输入、待完成starter、作者reference及实际运行产物，依README本地准备依赖。
查看启动命令与执行边界
环境要求、具体操作、产物核对与未运行范围。
1. 准备注册插件
输入有csv与json两个原创插件，导入模块时注册到REGISTRY。app里另有真正无用的math导入，方便区分相同F401提示背后的不同作用。
2. 先运行行为
先执行app，确认两个插件确实加载。没有行为基线，就无法判断自动修复有没有改变注册机制。
本地启动与复现
text
cd reference
python3 verify.py3. 执行Ruff修复
运行原生ruff check --select F401 --fix，默认会删除看似未使用的导入。保留修复前后源码与实际CLI输出。
4. 复现加载失败
再次执行app，注册列表缺失并触发断言。这个故意失败来自真实Python模块执行，不是只在文中警告自动修复可能有风险。
5. 限定保留导入
只对负责注册的两条导入标明局部noqa: F401，继续允许删除math。不要全局关闭F401，否则真正无用的导入也会消失在检查之外。
6. 再查无用导入
新增一个无用random导入，原生Ruff仍应报F401。修复策略需要既保护注册行为，又保持普通静态检查有效。
7. 同时验收两侧
最终同时执行插件行为与Ruff检查，两个插件完整、真正无用导入已删。本题使用局部合同，不宣称所有side effect import都应永久保留；Claude Code账号未运行。
怎样确认已经完成
- 自动修复前后实际运行插件，能够复现注册丢失。
- 局部保留两条注册导入后csv/json插件恢复，真正无用导入被删除。
- 新增无用random仍触发F401，未全局关闭规则。
常见问题
AI一键修完Ruff，为什么插件反而加载不了了？
某些import靠模块执行注册插件，F401无法从普通名称使用看到这份副作用。本题自动删除后真实注册断言失败。
未使用的import哪些能删，哪些需要保留注册行为？
只对明确注册合同的导入局部保留，同时修复真正无用项。再新增无用import验Ruff仍报错，行为和静态检查两侧都要过。
哪些部分实际运行，哪些需要独立验证？
Ruff原生F401自动修复真实破坏插件注册；局部保留注册导入后两插件恢复，新增无用导入仍报错。 目标AI助手账号生成、云平台部署和生产环境不在本次执行范围。