请为下面这段代码生成一份面向开发者的使用文档，要求包含：1）功能概述（一句话）；2）函数签名与参数说明（含类型、是否必填、默认值、取值范围）；3）返回值说明；4）一个完整可运行的调用示例；5）常见错误及修复建议。不要解释代码逻辑，只输出文档内容。代码如下：def batch_upload_files(file_list: list[str], timeout: int = 30, max_retries: int = 3) -> dict[str, bool]: ...
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让腾讯混元大模型为一段已有代码自动生成清晰、可读、带示例的使用文档，而不是靠人工逐行注释或翻查手册。
确认代码已就绪并明确文档用途
确保你要生成文档的代码是完整可运行的（哪怕只是片段），且你心里清楚这份文档给谁看：是给新同事快速上手？给API调用方说明入参规则？还是嵌入到项目README里？【用途不明确会导致生成的文档缺乏上下文和关键约束】。比如一段处理Excel的Python函数，若目标读者是后端开发，就该强调参数类型、异常抛出；若是运营同学，则要突出“怎么填表格”“点哪里执行”这类操作指引。
在混元控制台或客户端中构造精准提示词
打开腾讯混元大模型网页版（console.cloud.tencent.com/hunyuan/start）或已配置好hunyuan-pro模型的AI客户端（如Chatbox），新建对话。
输入以下结构化提示，注意保留换行和标点：
请为下面这段代码生成一份面向开发者的使用文档，要求包含：1）功能概述（一句话）；2）函数签名与参数说明（含类型、是否必填、默认值、取值范围）；3）返回值说明；4）一个完整可运行的调用示例；5）常见错误及修复建议。不要解释代码逻辑，只输出文档内容。代码如下：def batch_upload_files(file_list: List[str], timeout: int = 30, max_retries: int = 3) -> Dict[str, bool]: ...
使用hunyuan-code专用模型提升准确率
方法一：在API调用时显式指定模型为 hunyuan-code。该模型专为代码理解优化，对函数签名、类型注解、异常路径识别更稳定，尤其适合Python/JavaScript/Java等主流语言。
方法二：若用网页控制台，默认模型可能为hunyuan-pro。此时需在提示词开头加一句：“你是一名资深Python SDK文档工程师，请严格按hunyuan-code模型的能力输出”，能显著降低参数误判率。
【跳过这步直接用hunyuan-pro处理复杂类型注解（如Union[Path, str]或嵌套泛型），大概率导致参数说明错漏】。
校验并轻量编辑生成结果
第一步：检查参数类型是否与原代码一致，特别注意Optional、Any、字典键约束等易被简化的类型——hunyuan-code虽强，但遇到from typing import *导入时仍可能丢失细节。
第二步：确认示例代码能否真正粘贴即跑。混元有时会虚构不存在的模块名（如把from utils.helper import retry写成from retry_utils import retry），需手动修正为项目真实路径。
第三步：删掉生成文档里所有“本文档由AI生成”“仅供参考”等冗余声明——技术文档必须干净、权威、无免责声明痕迹。
