已确认codegeex插件启用并正确配置：需在intellij idea中启用v2.4.1+版插件，配置python 3.11+或java 17+ sdk，通过alt+enter或右键触发“generate docstring”，生成注释须含完整参数、返回值、异常说明，类型准确，无冗余描述，并手动补充边界条件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让智谱清言为一段真实可运行的代码自动生成规范、准确、带参数说明和边界条件提示的注释，而不是泛泛而谈“该函数用于处理数据”这类无效描述。
确认插件已启用并匹配语言环境
打开 IntelliJ IDEA → 点击左上角【File】→【Settings】→【Plugins】→ 搜索“CodeGeeX” → 确保状态为“Enabled”。【若未安装，请先从JetBrains插件市场下载v2.4.1及以上版本】
重启IDEA后，在任意.py或.java文件中右键 → 查看菜单是否出现“Generate Docstring”选项。没有则说明语言服务未加载，需检查项目SDK是否已正确配置为Python 3.11+或Java 17+。
选中目标代码块并触发注释生成
方法一：快捷键触发（推荐）
将光标置于函数名所在行 → 按下 Alt + Enter → 在弹出菜单中选择“Generate docstring” → 回车确认。
方法二：鼠标右键触发
用鼠标拖选整个函数定义（含def/class行及首行缩进）→ 右键 → 选择“Generate Docstring”。【注意：只选函数体内部代码会导致注释缺失函数签名信息】
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
这一步操作起来很简单，直接把文件拖进去就行。
校验并修正生成的注释内容
第一步：检查是否包含全部必需字段
对Python函数，必须含 @param（每个参数一行）、@return、@raises（如有异常抛出）；对Java方法，必须含 @param、@return、@throws，且参数名与源码完全一致。
第二步：验证参数类型标注是否准确
例如函数接收一个 pd.DataFrame，但生成注释写成“@param df: dict”，此时需手动改为“@param df: pandas.DataFrame”。模型可能混淆类型别名，尤其在未开启类型推断插件时。
第三步：删除冗余描述或模糊动词
如出现“进行数据处理”“完成逻辑判断”等空洞表述，直接删掉，替换为具体动作，例如“过滤status为'pending'的订单记录”。
第四步：补充边界条件说明（易漏项）
在 @return 后另起一行，加一句“# 注意：当输入为空列表时返回空字典”，这类信息模型不会主动添加，但生产环境必须明确。
