CodeBuddy在无网络时核心AI功能不可用，仅支持有限本地交互：插件版依赖缓存静态资源；私有化部署可全功能离线运行；VS Code版降级为规则匹配补全；桌面版仅保留基础编辑功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在没有网络连接的环境中启动 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 语句、闭合括号、重复代码块识别等，不涉及自然语言理解或跨文件上下文推导。
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 问题
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)” 提示。
