应启用混元模型、规范注释格式、注入RAG知识库、切换微信生态模式。具体包括：一、在设置中启用混元模型；二、使用半角单行注释并保持缩进对齐；三、通过.codebuddy/rag/zh-comment-spec.md注入自定义注释语义；四、在状态栏切换为微信小程序模式以激活领域专项解析。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用CodeBuddy进行开发时发现其对中文注释的响应不够精准或生成内容偏离预期，则可能是由于模型对中文语义上下文建模深度不足所致。以下是验证与提升其中文注释理解能力的具体操作路径：
一、核对当前模型配置是否启用混元模型
CodeBuddy采用双模型驱动架构，其中混元模型专为优化中文语义理解设计，其在中文注释生成准确率上较通用模型提升35%。若未启用该模型，将直接影响注释识别与代码转化质量。
1、打开CodeBuddy设置面板，进入「模型管理」页签。
2、检查当前激活模型是否为混元（HunYuan）系列模型，而非DeepSeek或GLM-4.7等侧重多语言泛化的模型。
3、如非混元模型，请点击对应模型右侧的「设为默认」按钮并重启IDE插件。
二、验证注释格式是否符合AST清洗规范
CodeBuddy在训练阶段对GitHub中文仓库语料进行了AST清洗，仅保留经静态语法树验证的生产级注释结构。非标准格式（如跨行未闭合的/**/块、缩进错位的//注释、混用中英文标点）可能被降权处理或跳过解析。
1、在待补全函数上方添加单行注释，格式为// 实现用户登录校验逻辑，避免使用/**/多行块注释。
2、确保注释与后续代码之间无空行，且缩进与函数体对齐。
3、删除注释中所有全角标点（如“。”、“，”），统一替换为半角符号。
三、启用RAG知识库注入项目专属注释范式
当项目存在自定义注释规范（如@desc、@author、@since等非Javadoc标签）时，CodeBuddy默认无法识别。通过RAG知识库注入，可使模型动态适配团队内部注释语义体系。
1、在项目根目录创建.codebuddy/rag/zh-comment-spec.md文件。
2、写入示例条目："@desc 表示业务功能摘要，等效于Javadoc中的@brief"。
3、保存后执行命令codebuddy rag reload --force触发知识库热更新。
四、切换至微信生态专用模式
CodeBuddy内置微信开发知识库，该模式下模型对小程序、云开发等场景中的中文注释具有更强的领域泛化能力，尤其在含“云函数”“wxml绑定”“wx.login拦截”等关键词时触发专项解析路径。
1、在VS Code状态栏点击CodeBuddy图标，选择「环境模式」。
2、从下拉菜单中选择微信小程序（WeChat MiniApp）而非通用Java/Python模式。
3、新建一个login.js文件，在顶部输入注释：// 调用微信授权接口获取code并提交至云函数。
