应启用Solidity专属微调模型、注入上下文锚点、绑定Foundry项目索引、切换Craft模式生成合约片段、配置MCP审计指令集。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用CodeBuddy开发以太坊或兼容EVM的区块链智能合约时发现Solidity代码补全响应迟滞、语义理解偏差或上下文跳转失效，则可能是由于当前模型对Solidity语法结构、Yul内联汇编、安全模式（如ReentrancyGuard、SafeMath替代方案）及常见漏洞模式（如整数溢出、未校验返回值）的专项覆盖不足。以下是针对该问题的多种应对方法：
一、启用Solidity专属语言模型微调配置
CodeBuddy支持动态加载针对特定语言优化的推理模型分支，Solidity需显式激活经混元代码模型v3.2.1微调的合约专用子模型，该子模型在OpenZeppelin合约库、Foundry测试用例及Ethereum Classic历史漏洞样本上完成强化训练。
1、在VS Code中打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）。
2、输入并选择“CodeBuddy: Open Model Configuration”。
3、在Language Models设置区域找到“Solidity”条目，将Model Variant下拉菜单切换为“hybrid-solidity-v3.2.1”。
4、勾选“Enable Context-Aware Contract Analysis”复选框。
5、点击“Apply & Restart Assistant”使配置生效。
二、手动注入合约上下文锚点
当CodeBuddy未能自动识别当前文件为Solidity合约或无法关联导入的接口（如IERC20、Ownable），可通过插入结构化注释锚点，强制注入合约语义上下文，引导模型准确理解继承链、状态变量作用域与函数可见性修饰符。
1、在合约文件顶部import语句下方添加多行注释块。
2、写入标准格式的@contract-context标记，例如：/// @contract-context inherits: Ownable, Pausable; interfaces: IERC20, IUniswapV2Router02; pragma: ^0.8.24。
3、确保该注释位于所有contract声明之前且无空行隔断。
4、保存文件后触发一次手动补全（Ctrl+Space），观察补全建议是否包含符合OpenZeppelin v4.9.3规范的_reentrancyGuard()调用模板。
三、绑定本地Foundry项目结构索引
CodeBuddy可读取Foundry项目的src/、lib/与script/目录结构，并基于forge build生成的cache/artifacts构建符号表。启用此功能后，补全将支持跨文件合约继承推导、事件参数自动匹配及自定义错误（custom errors）的精准签名提示。
1、确认项目根目录存在foundry.toml文件且已执行过forge build命令。
2、在CodeBuddy设置页中定位“Project Integration”模块。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
3、开启“Auto-detect Foundry Project”开关。
4、点击“Rescan Project Symbols”按钮，等待右下角状态栏显示“Solidity symbol index ready (N contracts indexed)”。
5、在.sol文件中输入emit MyEvent(，验证是否出现按字段类型排序的参数补全列表，包括address payable、uint256[] memory等完整类型修饰。
四、切换至Craft模式进行合约片段生成
对于复杂逻辑如闪电贷回调处理、多签执行验证或ERC-721批量转移，常规补全难以覆盖完整控制流。此时应调用Craft智能体，通过自然语言指令驱动多文件协同生成，该模式内置Solidity安全规则检查器，在生成阶段即拦截unchecked块、未初始化storage指针等高危模式。
1、点击侧边栏CodeBuddy图标，切换至Craft标签页。
2、在输入框中键入明确指令，例如："生成一个兼容ERC-1155的NFT合约，支持批量铸币、条件性转账冻结、以及gas优化的tokenURI重定向逻辑"。
3、在模型响应后出现的“Review & Insert”面板中，查看AI生成的require条件分组、internal函数命名风格及是否自动引入Strings.sol。
4、勾选“Validate with Slither Ruleset”选项后再确认插入。
5、插入完成后，立即在编辑器中检查是否存在Slither标记的HIGH风险项，如missing-zero-check或incorrect-shift。
五、配置自定义MCP指令集用于合约审计辅助
CodeBuddy支持通过MCP（Model Control Protocol）指令扩展补全行为。针对Solidity，可部署预置的audit-mcp包，该包将补全触发词映射至常见安全检查点，例如输入“reentrancy”即弹出带注释的非重入锁模板，输入“overflow”则推荐SafeCast库调用方式。
1、访问CodeBuddy插件设置中的“MCP Marketplace”页面。
2、搜索并安装“solidity-audit-mcp”官方包（版本号2026.05.01）。
3、安装后进入“Custom MCP Triggers”配置项。
4、添加新触发词：关键词设为“uncheck”，补全内容设为：// ⚠️ DANGEROUS: unchecked { } block detected. Prefer SafeMath or compiler 0.8+ built-in overflow checks.。
5、保存配置，随后在任意.sol文件中键入uncheck并触发补全，验证警告是否实时出现。
