codebuddy在无网络时核心ai功能不可用，但可通过四种方式实现离线支持：一、本地缓存仅支持基础界面操作；二、私有化部署可全功能离线运行；三、vs code版启用规则匹配降级模式；四、桌面版集成llama.cpp实现本地模型推理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在无网络连接的环境中使用 CodeBuddy，其核心 AI 功能将无法正常响应。这是因为多数智能能力依赖云端模型推理与实时上下文分析，离线状态下无法访问远程服务节点。以下是针对离线可用性的多种实现路径：
一、本地缓存资源的有限交互能力
CodeBuddy 在首次联网时会预加载少量轻量级静态资源，用于维持基础界面渲染和静态操作，但不包含任何语义理解或代码生成能力。该模式适用于临时查看历史对话、切换标签页等非推理类交互。
1、检查本地缓存是否存在：在 Android Studio 中进入 Settings > Plugins > CodeBuddy > Manage > Show Plugin Folder。
2、定位 cache 子目录，观察是否存在以 .json 或 .bin 结尾的非空文件（如 prompt_cache_v2.bin）。
3、若该目录为空或仅含零字节文件，则表明无有效离线资源可用。
二、私有化部署下的全功能离线运行
当采用私有化部署方案时，CodeBuddy 的全部模型与服务组件均运行于客户内网环境，无需外网连接即可执行完整 AI 推理流程。该方式要求预先完成本地模型权重加载、API 网关配置及 IDE 插件 endpoint 重定向。
1、确认私有服务已启动：在部署服务器上执行 curl http://localhost:8080/health，返回 status: "UP" 即表示服务就绪。
2、修改 Android Studio 中 CodeBuddy 插件配置：进入 Settings > Tools > CodeBuddy > Backend URL，将默认地址替换为内网服务地址（如 http://192.168.10.5:8080）。
3、重启 IDE 并验证连接状态：插件右下角状态栏应显示 “Connected to private instance”。
三、VS Code 版本启用规则匹配降级模式
VS Code 版本的 CodeBuddy Craft 插件内置轻量级规则引擎，在检测到网络不可达时自动切换至本地 AST 分析与正则补全逻辑。该模式仅支持 import 补全、括号闭合、重复代码块识别等基础操作，不涉及自然语言理解或跨文件上下文推导。
1、确保已安装最新版 CodeBuddy Craft for VS Code（v2.8.3+）。
2、断开设备网络连接后，打开任意 .js 或 .py 文件，输入 import 观察是否触发自动补全提示。
3、若出现模块路径建议列表，则表明规则引擎已激活；若无响应，请检查插件日志中是否存在 "fallback mode activated" 字样。
四、桌面版集成 llama.cpp 本地模型推理
CodeBuddy 桌面版（v2.7.0+）支持通过 llama.cpp 加载 GGUF 格式量化模型，在满足硬件条件前提下实现完全离线的代码生成与错误修复。该方案需手动配置模型路径与 GPU 层参数，并限制最大上下文长度以适配本地显存。
1、下载适配的 tc-code-enterprise-202604.qwen3-int4.gguf 模型文件至 ~/codebuddy/models/ 目录。
2、编辑 ~/codebuddy/config/local_config.json，设置 model_path 为该文件绝对路径，engine 为 llama.cpp，n_gpu_layers 为 48。
3、启动桌面版并进入 Settings > Advanced > Local Inference，勾选 Enable local model execution 后保存生效。
