在minimax agent中为代码自动添加规范注释，须指定注释风格（如jsdoc或google python style）、语言偏好与作用域范围；未设置时默认无函数级注释，选错风格会导致格式错误；可通过全局设置、prompt声明或system指令指定注释深度；强制生效需校验注释标记、参数一致性及ide识别结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在MiniMax Agent中为生成的代码自动添加规范注释，需明确指定注释风格、语言偏好与作用域范围，否则输出的代码可能完全无注释或仅含模糊描述。
设置全局注释模板
进入Agent控制台 → 点击右上角头像 → 选择「Settings」→ 找到「Code Generation」模块 → 在「Comment Style」下拉菜单中选择「JSDoc」（JavaScript/TypeScript项目）或「Google Python Style」（Python项目）。
这一步必须完成，【未设置注释风格时，Agent默认不生成任何函数级注释】。若选错风格，比如给Python代码配JSDoc，会导致注释格式错误且无法被IDE识别。
为单次调用指定注释深度
方法一：在prompt中显式声明
输入请求时，在代码需求后追加一句：“请为每个函数添加完整JSDoc注释，包含@param、@returns和@throws。”
方法二：使用系统指令前缀
在消息开头添加：system: 注释级别=函数级+行内关键逻辑说明。该指令会覆盖全局设置，优先生效。
方法三：禁用注释（调试专用）
当需要比对原始逻辑时，写：“输出纯代码，不要任何注释、空行或解释性文字。” Agent将严格剔除所有注释块和文档字符串。
强制注释生效的三步校验
第一步：提交代码生成请求后，立即检查返回内容首行是否含/**或"""等注释起始标记；
第二步：随机点开一个函数，确认参数名与注释中@param字段完全一致——若出现@param x但函数签名是def func(a, b)，说明注释未绑定实际参数；
第三步：复制一段带注释的代码到VS Code，启用Pylance或ESLint插件，观察是否触发“Missing docstring”警告——【无警告才代表注释被正确识别】。
