幽灵注释需手动触发且依赖视图状态与插件配置：启用需右键选择“codegeex→ghost comment”，关闭选“hide ghost comment”，语言与粒度可在设置中调整，跨文件联动需项目索引完成并聚焦方法名触发。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在IDE中阅读代码时希望获得上下文感知的实时解释，但幽灵注释未自动显示或行为异常，则可能是由于功能未正确触发或当前视图状态不匹配。以下是启用与操控幽灵注释的具体操作路径：
一、启用幽灵注释（Ghost Comment）
该功能通过在代码行旁动态渲染轻量级解释性文本，不修改源码，实现沉浸式阅读体验。需确保已打开目标代码文件且插件处于激活状态。
1、在编辑器中打开任意源代码文件（如.java、.py、.ts等）。
2、将光标定位至待解释的代码行，或用鼠标选中一段函数/逻辑块。
3、右键单击选中区域或空白处，在弹出菜单中依次展开“CodeGeeX”→“Ghost Comment”。
4、等待右下角CodeGeeX图标短暂旋转，数秒后注释即以半透明灰色文字形式浮现于代码右侧空白区。
二、关闭幽灵注释
幽灵注释为非持久化覆盖层，关闭操作仅隐藏当前视图中的注释内容，不影响其他文件或后续调用。
1、保持当前代码文件处于焦点状态。
2、右键单击任意位置，在菜单中选择“CodeGeeX”→“Hide Ghost Comment”。
3、所有已渲染的幽灵注释将立即消失，代码编辑区恢复原始界面。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
三、切换注释语言与粒度
幽灵注释支持按语境动态调整解释深度与表述风格，语言偏好影响术语准确性与可读性。
1、进入IDE设置界面：VSCode中为“设置→Extensions→CodeGeeX”，IDEA中为“Settings→Other Settings→CodeGeeX”。
2、找到“Explanation: Language Preference”选项，点击下拉框选择“中文”或“English”。
3、在“Comment Granularity”选项中，拖动滑块选择“函数级”“语句级”或“表达式级”解释粒度。
4、保存设置后，新触发的幽灵注释将按所选参数生效。
四、跨文件上下文联动阅读
当阅读涉及多文件调用链的代码时，幽灵注释可结合workspace索引理解跨文件依赖关系，提供连贯语义解释。
1、确保项目根目录已在IDE中打开，且CodeGeeX已完成workspace索引（图标常亮）。
2、在当前文件中触发Ghost Comment，观察是否出现含“调用自xxx.java”的引用提示。
3、若未出现，将光标移至方法名上，再次右键→“CodeGeeX”→“Ghost Comment”。
4、注释区域将同步显示该方法在其他文件中的定义位置、参数传递路径及返回值流向说明。
