带验收标准的功能开发

目标：{{一句话描述要实现的功能}}

约束：
- 沿用仓库现有的代码风格、目录结构和依赖，不要引入新的库，除非你先说明理由并等我同意。
- 改动范围限制在：{{允许改动的目录或文件}}
- 不要动：{{禁止改动的部分}}

验收标准（全部满足才算完成）：
1. {{标准一，例如：新接口在参数缺失时返回 400 并带明确错误信息}}
2. {{标准二}}
3. 新增或更新对应的测试，并且 {{测试命令}} 全部通过。
4. typecheck 与 lint 无新增报错。

请按「先说方案 → 我确认 → 再动手」的节奏来。方案阶段只列要改哪些文件、各自改什么，不要贴完整代码。