Fitten_Code离线模式探讨：局域网或无网环境下的功能受限说明

先说几个关键点：当 Fitten Code 进入离线模式后，那些依赖云端模型的核心功能确实会“罢工”——这是它的设计逻辑决定的。不过，这并不意味着它完全变成了一堆没用的代码。

简单来说，离线模式下的 Fitten Code，更像是一个功能精简版的本土编辑器。它保留了最基础的编辑和本地操作能力，但所有需要联网调用的高级功能都会自动屏蔽。下面我们拆开来看。

离线模式下仍可使用的功能

当你打开编辑器，软件一检测到外网断了，它会立刻切换到受限离线模式。这时候，下面这些基础操作还是可以放心使用的：

• 本地代码编辑：语法高亮、括号匹配、基础折叠，这些都不受影响。
• 缓存片段库调用：前提是之前你已经手动把这些代码片段保存到了本地。
• 文件系统浏览和多标签页管理：文件树、多窗口切换，一切照旧。
• 本地 Git 操作：包括 commit、diff、log，只要本地 Git 环境已经配好。
• 自定义快捷键与主题设置：修改后即时生效，配置文件存放在

  【%APPDATA%FittenCodeconfig.json】
  。

完全不可用的功能及原因

所有需要实时远程调用的功能，在离线状态下都会灰显或直接报错“网络不可用”。具体情况如下：

• 代码补全：原本由模型驱动的 IntelliSense+ 补全功能会失效，只保留语言服务器（比如 TypeScript 的 tsserver）提供的静态补全。
• 自然语言生成：生成注释、函数说明、单元测试等按钮，点击后会弹出“请检查网络连接”的提示框，不会有任何回退逻辑。
• 错误诊断解释：比如 ESLint 报错的通俗化解读，原始错误码照常显示，但不会给出扩展说明。

• 实时协作编辑：Shared Session 功能启动即失败，不会创建本地 mock 会话。
• 云端设置同步：登录状态会保留，但同步开关强制禁用。

  【这意味着你修改的设置不会上传，重装软件后会全部丢失】
• 远程开发容器：连接目标主机时，如果该主机本身没有外网，且没有预装 Fitten Code Server 离线包，就会初始化失败。

启用局域网内有限协同的配置步骤

如果你的局域网中已经部署了 Fitten Code Gateway（v2.4.0+）并完成了证书信任，那么部分服务是可以恢复的。操作并不复杂：

管理员在网关服务器上执行命令 fitten-gw serve --offline-mode=false，确保服务监听在 https://192.168.x.x:8443。

每台客户端打开 Fitten Code → 设置 → 扩展 → Fitten Core → Gateway URL，填入局域网地址（例如 https://192.168.1.100:8443）。

重启编辑器。客户端会自动校验证书并建立 TLS 连接。此时，AI 补全、错误解释、协作会话这三项功能会恢复，但仅限于该子网内的通信。

有一点需要特别提醒：证书必须由网关自签名 CA 签发，并且客户端需要提前将 CA 根证书导入系统信任库。否则，连接会被拦截，而且不会给你明确的错误提示——这是最容易被忽视的陷阱。