☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
codebuddy在无网络时核心ai功能不可用，仅支持有限本地交互：插件版依赖缓存静态资源；私有化部署可全功能离线运行；vs code版降级为规则匹配补全；桌面版仅保留基础编辑功能。
如果您在没有网络连接的环境中启动 codebuddy，其核心功能将受到显著限制。codebuddy 的多数智能能力依赖于云端模型推理与实时上下文分析，离线状态下无法访问远程服务节点。以下是针对离线环境可用性的具体说明：
一、本地缓存与预加载资源的有限可用性
CodeBuddy 在首次联网使用时会缓存部分轻量级资源，例如基础语法模板、常见快捷指令提示词、UI 界面配置及少量本地化语言包。这些内容可在离线时维持界面基本渲染和静态交互，但不包含任何代码生成、错误修复或语义理解能力。您仍可打开插件面板、切换 Craft/Chat 标签页、查看历史对话列表（若此前已同步至本地），但所有输入将无法触发有效响应。
1、检查本地缓存是否存在：在 Android Studio 中进入 Settings > Plugins > CodeBuddy > Manage > Show Plugin Folder。
2、定位 cache 子目录，观察是否存在以 .json 或 .bin 结尾的非空文件（如 prompt_cache_v2.bin）。
3、若该目录为空或仅含零字节文件，则表明无有效离线资源可用。
二、私有化部署模式下的离线可行性
当采用私有化部署方案时，CodeBuddy 的模型与服务组件全部运行于客户内网环境，此时无需外网连接即可执行完整 AI 推理流程。该模式要求预先在本地服务器部署腾讯云提供的 CodeBuddy 私有服务包，并完成模型权重加载、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、确保插件版本不低于 v2.4.1：在 VS Code 扩展面板中搜索 CodeBuddy Craft，点击“Details”查看版本号。
2、手动触发离线模式：断开设备网络，打开任意 .java 文件，在类声明后换行并输入 public static void，观察是否出现 main 方法骨架建议。
3、若未出现建议，检查 settings.json 中是否启用 "codebuddy.fallbackToStaticAnalysis": true。
四、CodeBuddy IDE 桌面版的离线运行边界
独立安装的 CodeBuddy IDE（非插件形态）在首次启动时强制要求登录并同步用户配置，此过程必须联网。成功登录后，IDE 会将项目元数据、最近会话快照及部分模型分片缓存至本地 ~/.codebuddy/cache 目录。此后即使断网，仍可打开已有项目、编辑源码、使用基础编辑器功能（查找替换、多光标、语法高亮），但Craft 模式完全不可用，Chat 输入框呈灰色禁用状态。
1、验证缓存完整性：在终端执行 ls -lh ~/.codebuddy/cache | grep -E "(session|project)"，确认存在非零大小的 session_*.json 文件。
2、强制启动离线会话：关闭所有网络接口，执行 codebuddy --no-network --open-folder /path/to/existing/project。
3、观察底部状态栏是否显示 “Offline mode active (limited features)” 提示。
