codebuddy可在无网络环境下通过私有化部署、关闭联网组件、预载知识库、启用离线测试生成器及配置本地git上下文实现核心功能。需依次完成本地模型加载、禁用遥测与更新、安装语言包、使用离线测试生成、设置本地git为上下文源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在无网络连接环境下继续使用CodeBuddy的核心辅助功能，例如代码补全、本地测试生成与基础代码解释，则需依赖其离线就绪能力。以下是实现CodeBuddy断网离线使用的具体步骤：
一、启用私有化部署模式并加载本地模型
私有化部署模式可将CodeBuddy的推理引擎与模型完全运行于用户本地设备，所有AI处理过程不发起任何外部HTTP请求，彻底规避网络依赖。
1、启动CodeBuddy独立IDE，在右上角点击用户头像，选择【系统设置】→【部署模式】。
2、将部署模式切换为【私有化部署】，点击【确认切换】并接受本地服务初始化提示。
3、进入【AI模型管理】页面，点击【添加本地模型】，浏览并选中已预置的GGUF格式模型文件（如deepseek-coder-1.5b-q4_k_m.gguf）。
4、设置模型名称为“Coder-Offline”，上下文长度设为4096，线程数设为CPU物理核心数，勾选【启用llama.cpp本地推理】。
5、点击【保存并加载】，等待状态栏显示“模型加载成功，当前处于离线推理模式”。
二、关闭全部联网组件与遥测服务
即使模型本地运行，若后台仍激活遥测上报、自动更新检查或云端词典同步，仍将触发DNS解析与连接尝试，导致功能异常或弹出网络错误提示。
1、在【安全与隐私】设置页中，将【遥测数据收集】、【自动检查更新】、【云端代码片段库同步】三项开关全部设为关闭状态。
2、点击【强制重置网络配置】按钮，清除存储在%LOCALAPPDATA%\CodeBuddy\config\network.json中的所有远程端点地址。
3、重启CodeBuddy应用，观察底部状态栏是否显示“离线模式：已激活”标识。
三、预载离线代码知识库与语言支持包
CodeBuddy部分高级能力（如多语言语法理解、框架API补全）依赖本地嵌入式知识库；断网前必须完成该知识库的完整下载与索引构建，否则将降级为纯文本匹配模式。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
1、保持联网状态下，进入【扩展管理】→【语言支持包】，勾选目标语言（如Python、Java、TypeScript）及对应框架（React、Spring Boot、FastAPI）。
2、点击【批量下载并安装】，等待进度条完成且提示“共安装7项离线语言包，索引已构建完毕”。
3、断开网络后，在任意代码文件中输入import或class等关键字，验证是否仍能弹出上下文感知的补全建议。
四、使用离线测试生成器替代云端服务
CodeBuddy的测试用例生成功能默认调用云端微服务；启用离线测试生成器后，将改用本地规则引擎与预置模板库，支持边界值分析、空输入覆盖及常见断言结构生成。
1、打开一个含函数定义的.py或.java文件，右键选择【CodeBuddy】→【生成测试用例（离线版）】。
2、在弹出窗口中确认函数签名无误，点击【生成】。
3、查看新生成的test_*.py文件，确认其中包含assertEqual、assertRaises等标准断言，且未出现HTTP请求相关代码。
五、配置本地Git仓库作为默认上下文源
断网时，CodeBuddy无法访问远程仓库获取项目结构信息；将其上下文锚点切换至本地Git工作区，可维持对模块依赖、函数调用链与接口契约的准确识别能力。
1、确保当前项目根目录下存在.git文件夹，且已执行过至少一次git add .与git commit。
2、在CodeBuddy设置中进入【项目上下文】→【代码源配置】，将【主上下文源】设为“本地Git仓库”。
3、点击【重建项目图谱】，等待提示“图谱构建完成，共识别23个模块与87个公开接口”。
