必须通过外网中转设备预先获取完整离线资源并完成本地初始化；具体包括：一、在外网机下载或构建离线安装包及模型；二、校验后解压至标准路径；三、配置离线运行时环境并启动；四、验证各功能模块完全离线可用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要在无网络连接的环境中部署Qoder开发环境，但无法直接访问官网下载安装包，则必须通过外网中转设备预先获取完整离线资源并完成本地初始化。以下是实现Qoder离线安装包下载与开发环境部署的可执行路径：
一、在外网中转机获取Qoder离线安装包
该步骤确保所有运行依赖、核心二进制文件及预置模型被一次性打包，规避内网环境下因缺失远程组件导致的初始化中断或功能降级。
1、访问Qoder中文官网下载页：https://qoder.com/zh
2、定位对应操作系统的离线安装包，优先选择明确标注offline或bundle字样的发布版本（例如：qoder-cli-v0.2.7-linux-amd64-offline.tar.gz 或 Qoder-offline-v0.3.2-windows-x64.zip）
3、若官网未提供显式离线包，则在联网机器上执行构建命令：npx offline-pack @qoder-ai/qodercli，生成含全部依赖的归档文件
4、同步下载配套资源：从https://huggingface.co/Qwen/Qwen1.5-0.5B手动拉取模型权重，保存至本地目录/tmp/qoder-models/
5、将安装包、requirements-offline.txt、qoder-models/整体压缩为单一离线分发包，命名为qoder-airgap-full-v0.3.2.tar.gz
二、校验并解压至离线主机指定路径
该步骤验证传输完整性并建立标准部署结构，防止因文件损坏或路径错位引发CLI无法识别或WebUI启动失败。
1、将U盘挂载至离线服务器，确认文件存在：ls -l /mnt/usb/qoder-airgap-full-v0.3.2.tar.gz
2、比对SHA256值：sha256sum /mnt/usb/qoder-airgap-full-v0.3.2.tar.gz，须与中转机输出完全一致
3、创建标准化部署根目录：mkdir -p /opt/qoder/{cli,models,webui}
4、解压主程序至CLI目录：tar -zxvf /mnt/usb/qoder-airgap-full-v0.3.2.tar.gz -C /opt/qoder/cli/
5、解压模型至models目录：tar -zxvf /mnt/usb/qoder-airgap-full-v0.3.2.tar.gz -C /opt/qoder/models/ --strip-components=1 qoder-models/
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、配置本地运行时环境与离线启动参数
该步骤绕过所有网络鉴权与远程配置加载逻辑，强制Qoder使用本地模型路径、禁用自动更新检查，并绑定内网IP暴露服务端口。
1、赋予CLI执行权限：chmod +x /opt/qoder/cli/bin/qodercli
2、写入系统PATH：echo 'export PATH="/opt/qoder/cli/bin:$PATH"' >> /etc/profile && source /etc/profile
3、执行离线初始化：qodercli init --offline --model-path /opt/qoder/models/Qwen1.5-0.5B
4、修改WebUI启动配置，将host由默认0.0.0.0改为内网固定IP（如192.168.10.50）
5、启动服务：qodercli webui --host 192.168.10.50 --port 7860
四、验证离线功能可用性
该步骤确认所有模块均不触发外部HTTP请求，仅依赖本地文件系统与进程间通信完成完整工作流。
1、检查CLI基础响应：qodercli --version，输出应为v0.3.2且无任何网络超时日志
2、访问浏览器地址：http://192.168.10.50:7860，页面加载应无404或资源缺失提示
3、上传任意本地代码文件并提交OneCode分析请求，观察是否返回结构化结果而非“模型加载失败”错误
4、执行终端命令：qodercli chat "如何修复Python中ModuleNotFoundError?"，确认响应来自本地模型而非云端API
5、查看进程监听状态：netstat -tuln | grep :7860，确认仅绑定内网IP，未监听公网接口
