补类型标注/修 lint 警告

请先运行一次类型检查/lint 工具，列出当前警告的分类和数量（不用逐条列全部，按类型归类统计即可）。然后按类型分批修复，每一批只处理一种类型的警告（比如先处理缺失的返回类型标注，再处理未使用的变量），改完一批就重新跑一次检查工具确认这批警告清零、再跑一次测试确认没有引入回归，然后才能进入下一批。不要为了消除警告而改变函数的实际行为，也不要用忽略注释（如 # type: ignore）批量掩盖问题，除非确实是工具的误报并说明理由。全程在新分支上进行。