功能定位：为什么必须“离线初始化”
HelloWorld IDE 以“零配置一键运行”著称，但官方默认流程会尝试拉取云端 70B 大模型与最新编译链补丁。在内网、政企、竞赛机房等无外网场景，首次双击桌面图标将卡在“Fetching components…”，既无法调用 AI 补全，也无法运行 C/C++ 以外的语言。离线初始化就是把所有依赖预置到本地，使 AI 推理、编译器、调试器、课堂评测等核心功能在断网状态下立即可用。
与常见“离线安装包”不同，HelloWorld 的离线包仅包含基础运行时；首次初始化仍需在“能短暂联网”或“已下载完整依赖镜像”的电脑上完成一次自解压与校验，生成 .hello 离线索引。此后整个目录可整体复制到内网终端，实现 U 盘级分发。
前置条件与版本前提
1. 安装包：从官网“Offline Edition”通道获取的 hello-offline-2026.05-{platform}.zip，体积 ≤ 200 MB。
2. 系统要求：Windows 10 1903+/macOS 12+/主流 Linux 内核 5.4+，x86_64 或 ARM64 均可。
3. 临时环境：至少 2 GB 磁盘剩余空间，用于解压后的 .hello/cache 目录；如要启用本地 7B 模型，需额外 4 GB 内存。
操作路径：Windows 桌面端（带图示例）
步骤 1：准备离线依赖镜像
在一台可联网电脑完成“在线初始化”后，HelloWorld 会在用户目录生成 .hello/offline-bundle 文件夹，内含语言运行时、AI 权重与课堂模板。将该文件夹与安装包一并拷贝到内网共享盘或 U 盘。
步骤 2：解压与首次启动
- 把 hello-offline-2026.05-win-x64.zip 解压到 D:\Tools\HelloWorld（路径无中文空格）。
- 将离线镜像整个复制到 D:\Tools\HelloWorld\.hello\offline-bundle，覆盖空目录。
- 双击 HelloWorld.exe，首次启动会自动校验 SHA-256 清单；若提示“offline-bundle incomplete”，请检查是否漏拷 AI 模型文件（大小约 3.8 GB）。
步骤 3：验证断网可用性
启动后按 Ctrl+Shift+P → 输入“network offline”→ 执行“模拟离线模式”，状态栏出现飞机图标。新建 Python 文件，键入 print("hello")，点击绿色运行按钮，若 2 秒内终端回显 hello，则初始化成功。
操作路径：macOS 与 Linux 差异
macOS：解压后拖入 /Applications，离线镜像放 ~/Library/Application Support/HelloWorld/.hello/offline-bundle；若系统阻止运行，需在“隐私与安全”手动允许。
Linux：解压即绿色目录，首次启动前给 hello-world 二进制赋可执行权限 chmod +x；离线镜像默认读 $XDG_DATA_HOME/HelloWorld/.hello，也可通过 --offline-bundle 参数指定路径，方便 NFS 共享。
课堂/机房批量部署脚本
经验性观察：高校机房 60 台 Win11 云终端，使用以下批处理可在 15 分钟内完成分发与初始化，CPU 占用峰值 <30%。
@echo off set SRC=\\TeacherPC\\HelloWorld\\offline-bundle set DST=C:\ProgramData\HelloWorld\.hello\ xcopy "%SRC%" "%DST%" /E /Y /Q start "" "C:\Program Files\HelloWorld\HelloWorld.exe" --verify-offline
脚本执行后，教师端可在“课堂管理”面板看到所有学生端状态灯由灰变绿，即表明离线初始化通过。
常见失败分支与回退方案
| 现象 | 根因 | 处置 |
|---|---|---|
| 启动白屏 30 秒后退出 | .NET 3.5 与内置运行时冲突 | 控制面板移除旧版 .NET 3.5，重启 |
| AI 补全提示“model unreachable” | offline-bundle 未含 7B 权重 | 重新拷贝 model.gguf 文件，大小≈3.8 GB |
| 绿色运行按钮报 503 Sandbox Quota | 匿名用户每日 100 次限额 | 登录课堂账号或加入教师组，限额提升至 1000 次 |
不适用场景清单
- 需要云端 70B 模型的高阶推理：离线 7B 模型在千行级 C++ 模板上的补全质量经验性观察下降约一档，且不支持多文件跨工程建议。
- 依赖 npm、Cargo 实时拉取最新库的前端/Rust 项目：离线包仅内置常用库快照，版本冻结在发布日，无法执行 cargo add。
- 企业合规要求“开箱即审”：离线初始化后仍需手动运行合规脚本生成 ISO/27042-2026 报告，不能直接用于生产上线。
最佳实践 6 条（检查表）
- 先在外网机完成一次“全量初始化”，确保 .hello/offline-bundle ≥ 4.2 GB。
- 复制前执行 --export-bundle 参数，生成独立压缩包，避免漏拷隐藏文件。
- 内网终端统一关闭自动更新（Settings → Update → Disable），防止学生误点升级后缺依赖。
- 课堂环境提前用 --classroom-id 参数预登录，绿色运行限额自动提升。
- 每季度用 --verify-offline 校验 SHA-256，发现缺失即回拷教师母版。
- 重要考试前 24 h 冻结共享目录写入权限，避免权重文件被篡改。
FAQ（结构化数据）
离线初始化后还能用 AI 纠错吗？
可以，默认调用本地 7B 模型，断网仍能给出语法与逻辑提示，但复杂跨文件重构建议不如云端 70B 模型。
拷贝到另一台电脑后需要重新激活吗？
不需要激活，HelloWorld 离线版无在线许可证验证；但课堂高级功能（>50 人评测）需登录教师账号。
如何确认离线包完整？
启动时加参数 --verify-offline，若返回“All 4 312 files matched”即完整；如提示缺失，请重新拷贝 offline-bundle。
总结与下一步
内网离线初始化 HelloWorld IDE 的核心，就是“先在外网机一次性拉全依赖，再整体搬运”。只要保证 offline-bundle 完整、关闭自动更新、用 --verify-offline 定期校验，就能在断网机房获得与云端一致的“零配置运行”体验。下一步，建议你：① 把本文检查表打印贴于教师机；② 用脚本把母版目录设为只读；③ 每季度关注官网“Offline Edition”增量补丁，确保语言运行时与安全补丁同步。完成这三步，课堂开局 5 分钟即可全员敲出第一行 hello world。
