需在外网校验离线包完整性后导入内网，配置cli环境、启用offline模式harness、加载本地技能与模型桩，最后启动离线webui并验证日志分析任务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在无网络环境下部署QoderWake私有化开发环境，需绕过所有云端验证、模型拉取与API心跳机制，仅依赖本地文件完成核心服务初始化、技能绑定与离线Harness引擎启用，确保数字员工可在内网服务器或隔离终端上稳定执行日志分析、代码审查等确定性任务。
准备离线安装包并校验完整性
该步骤必须在外网中转机完成，否则内网无法获取可信签名与哈希值。未校验的安装包一旦损坏，会导致qodercli init --offline失败且无明确报错提示。
1、访问Qoder中文官网下载页 https://qoder.com/zh/download，查找标注为 「offline」 或 「airgap」 的完整安装包，如 【qoderwake-v1.0.2-linux-amd64-offline.tar.gz】；若未找到，立即切换至手动构建模式：运行 npm install -g @qoder-ai/qoderwake && npx offline-pack @qoder-ai/qoderwake 生成归档。
2、同步下载配套文件：GPG签名公钥 qoder-release-signing-key.asc、SHA256校验清单页（https://qoder.com/zh/docs/installation/checksums）中对应版本的哈希值、以及模型桩文件 stub_qwen3.5_v1.bin。
3、将全部文件打包为单一压缩包，通过U盘导入内网目标主机。
4、在内网机器上执行：sha256sum qoderwake-v1.0.2-linux-amd64-offline.tar.gz，比对输出是否与外网记录完全一致；若不一致，立即中止后续操作——【损坏包不可修复，必须重传】。
解压并配置本地CLI运行环境
Linux系统需显式赋权并注入PATH，否则qodercli命令将提示“command not found”，且该错误不会在安装脚本中自动捕获。
方法一：标准路径部署
1、创建部署目录：mkdir -p /opt/qoder/cli
2、解压至指定位置：tar -zxvf qoderwake-v1.0.2-linux-amd64-offline.tar.gz -C /opt/qoder/cli/
3、赋予二进制执行权限：chmod +x /opt/qoder/cli/bin/qodercli
4、写入系统级PATH：echo 'export PATH="/opt/qoder/cli/bin:$PATH"' >> /etc/profile && source /etc/profile
方法二：用户级轻量部署（适合单人调试）
1、解压到家目录：tar -zxvf qoderwake-v1.0.2-linux-amd64-offline.tar.gz -C ~/qoder-offline/
2、直接调用绝对路径执行：~/qoder-offline/bin/qodercli --version，无需修改PATH。
启用离线Harness引擎与本地技能集
这是离线模式生效的核心开关。若跳过此步，即使CLI能运行，所有任务仍会卡在“connecting to cloud scheduler”状态。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
第一步：修改核心配置文件
1、打开 /opt/qoder/cli/config/core.yaml（若不存在则新建）
2、在 harness: 区块下严格添加三行（注意缩进为两个空格）：
mode: offline
fallback_strategy: local_only
max_reconnect_attempts: 0
第二步：加载离线技能
1、禁用全部联网型Connector：qodercli connector disable --all --force
2、启用本地日志分析技能：qodercli skill enable local-log-analyzer
3、验证状态：qodercli skill status local-log-analyzer，输出中必须同时出现 active: true 和 offline_capable: true。
加载模型桩并启动离线WebUI
离线模式不加载真实大模型，而是用协议桩模拟接口行为。若桩文件路径错误或未加载，qodercli run 命令将返回“model not ready”且无法重试。
1、确认桩文件已就位：ls /opt/qoder/cli/runtime/protocol-stub/stub_qwen3.5_v1.bin，若提示“No such file”，立即从U盘拷贝该文件至此路径。
2、执行加载命令：qodercli model load --stub --path /opt/qoder/cli/runtime/protocol-stub/stub_qwen3.5_v1.bin
3、检查加载结果：qodercli model status，确认输出中 model_type 为 stub、online 为 false、ready 为 true。
4、启动WebUI：qodercli webui --host 0.0.0.0 --port 7860 --offline，浏览器访问 http://:7860 即可进入离线工作界面。
5、执行一次端到端验证：qodercli run --task "analyze-log /var/log/syslog | head -n 5"，输出应为结构化JSON格式的日志片段，无任何网络请求痕迹。
