Trae离线使用指南：断网时的核心功能与限制详解
在隔离的内网或离线环境中使用Trae时，部分依赖云端服务的功能会受限。了解断网状态下的功能可用性，有助于您规划离线开发工作流。
一、必须联网才能使用的功能
Trae的智能核心功能深度集成云端AI服务，其运行完全依赖外部API调用与实时云端推理。网络连接中断将直接导致以下功能不可用。
1. 智能代码补全与生成：此功能需将当前代码上下文实时发送至云端大语言模型进行处理，以获取结构化建议。断网状态下，智能代码补全与生成功能将完全失效。
2. Builder模式应用构建：无论是多步骤任务规划、跨文件代码修改还是自动化测试执行，均由云端的AI决策引擎驱动。离线环境下无法启动Builder模式。
3. MTC非代码任务处理：处理产品文档、运营方案或数据分析报告等任务，需要调用具备多模态理解能力的云端模型。无网络连接时，MTC相关任务流程将无法加载。
4. 文件内容深度解析：对PDF、PPTX、CSV等格式文件进行语义提取与摘要，依赖于云端专用的解析微服务。目前本地客户端无此功能的替代实现。
二、可在离线环境正常工作的功能
Trae的基础开发功能设计为本地化运行，以下能力不发起任何外网请求，仅依赖客户端与预置资源即可稳定工作。
1. 纯文本编辑与语法高亮：所有主流编程语言的词法分析与代码着色均由本地IDE内核驱动。网络状态对此功能无任何影响，您可以流畅地进行代码编写。
2. 本地开发服务器预览：运行如 npm run dev 或 python -m http.server 等命令启动本地服务器后，通过127.0.0.1等本地端口进行网页访问与调试完全正常。
3. 文件系统操作：创建、重命名、删除、移动文件与文件夹等操作，直接调用操作系统原生API。整个过程无需网络参与。
4. 已配置本地模型的有限推理：若您已提前部署Ollama或trae-core等本地模型，可进行基础的问答与简单的代码解释。但复杂的、需要多步链式推理的任务通常无法处理。
三、有条件离线可用的功能
部分功能的离线可用性取决于前置配置。提前完成相应的本地化设置，是确保这些功能在断网时正常工作的关键。
1. 代码调试与断点执行：与VS Code兼容的调试器本身可离线运行，但前提是您已在本地安装好对应语言的调试适配器，例如Python Debug Adapter。
2. Git版本控制操作：针对本地仓库的 commit, diff, log, branch 等操作可正常执行。然而，涉及远程仓库交互的 push/pull/fetch 命令会因网络中断而失败。
3. 本地工具链调用：对于 bash_tool, edit_tool 等工具，若已通过 --offline-cache-dir 等参数预下载所需资源并配置好路径，则断网时执行脚本、替换文本、生成JSON等确定性操作是可行的。
4. 项目结构索引与跳转：该功能基于对本地文件的扫描来构建符号表，因此支持如Ctrl+Click跳转到定义、查找引用等操作，无需依赖任何网络索引服务。