codex-collab

请与 Codex 协作，重构这个 Python 函数，提升可读性并保持行为不变：<粘贴代码>。请先说明重构方案，再给出修改后的代码和关键差异。

输出重构思路、改进后的代码，以及主要变更说明。

请与 Codex 一起分析以下报错日志，定位根因并给出修复建议：<粘贴日志>。如果可能，请提供最小可行修复补丁。

输出问题根因分析、修复步骤，并附上可执行的补丁建议。

请与 Codex 协作，为这个模块补充单元测试和边界条件测试：<粘贴代码或接口说明>。使用当前项目的测试框架，并解释覆盖了哪些场景。

输出可直接使用的测试代码，以及测试覆盖范围说明。