请为以下JavaScript函数添加逐行功能注释，说明每个参数含义、返回值类型、异常分支处理逻辑。function countWords(text) { if (!text || typeof text !== "string") return 0; return text.trim().split(/\s+/).filter(Boolean).length; }
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要给一段没人维护的旧代码快速补上可读性注释，避免花半天时间逐行猜逻辑，又怕AI乱写导致后续调试踩坑。
确认混元接入状态
打开腾讯云控制台 → 进入【混元大模型】服务页 → 查看右上角“已开通”标识是否亮起。未开通需先点击“立即开通”，否则后续所有请求都会返回403错误。
确保你已在【API密钥管理】中创建了密钥对，并【SecretKey仅首次显示，关闭页面后不可找回】。若已丢失，必须重新生成并更新本地配置。
准备待注释的代码片段
复制纯代码文本（不含文件名、路径、console.log等调试残留），长度建议控制在800行以内。超过1200行时，混元可能截断响应或遗漏关键函数上下文。
删除所有已有注释（// 和 /* */），只保留原始逻辑代码。混元对“已有注释+新需求”的混合输入容易产生冗余或冲突解释。
在代码最上方空两行，用中文写一句明确指令，例如：“请为以下JavaScript函数添加逐行功能注释，说明每个参数含义、返回值类型、异常分支处理逻辑。”
通过API提交注释请求
方法一：使用curl命令行（适合单次快速验证）
在终端执行：
curl -X POST "https://api.hunyuan.cloud.tencent.com/v1/chat/completions" \<br>-H "Authorization: Bearer YOUR_API_KEY" \<br>-H "Content-Type: application/json" \<br>-d '{"model":"hunyuan-pro","messages":[{"role":"user","content":"请为以下JavaScript函数添加逐行功能注释，说明每个参数含义、返回值类型、异常分支处理逻辑。\n\nfunction countWords(text) {\n if (!text || typeof text !== \"string\") return 0;\n return text.trim().split(/\s+/).filter(Boolean).length;\n}"}]}'
方法二：用Python脚本批量处理（推荐用于多文件）
新建annotate.py，填入标准requests调用模板，把代码字符串赋值给content字段，运行即可。注意headers中Authorization前缀必须是Bearer，不是APIKey或Token。
方法三：直接在混元Web控制台对话页粘贴（适合调试语义）
进入控制台对话界面，粘贴带指令的完整文本，发送。观察首句回复是否准确识别出语言和函数用途——若它误判成Python或描述成“统计字符数”，说明指令表述模糊，需重写。
校验与落地注释
第一步：检查返回注释是否覆盖全部逻辑分支。重点核对if (!text || typeof text !== "string")这类守卫条件是否有对应说明，缺失即判定为无效响应，需调整prompt重试。
第二步：将返回的注释块复制回原代码对应位置，注意缩进对齐。混元有时会在注释末尾多加一个空行或换行符，保存前手动删掉，否则可能破坏ESLint校验。
第三步：用VS Code安装“Comment Anchors”插件，选中刚插入的注释→右键→“Toggle Anchor”，自动生成可跳转标记。这一步能立刻验证注释是否真被编辑器识别为有效文档。
第四步：执行npm run lint或对应项目的静态检查命令。如果出现“JSDoc missing for function parameter”类报错，说明混元漏写了某个参数注释，此时不要修改代码去迁就AI，而是把报错行连同上下文再喂给混元，加一句“请补充第5行参数text的JSDoc @param 描述”。
