首次运行与缓存
首次运行与缓存
安装包携带固定版本的轻量启动器。首次执行 fnos-cli --version、--help 或业务命令时，启动器只下载当前执行主机对应的一份 CLI，按包内 SHA-256 校验后运行。下载提示写入 stderr，不混入业务 JSON；安装 Skill 文档不会触发下载，跳过 npm 安装脚本也能首次运行。
首次使用需要联网访问一个可用下载源。缓存准备好后，同一产品、版本和平台的后续调用无需连接下载站。缓存位于当前用户的系统缓存目录下，以命令、版本和平台隔离，无需管理员权限，不修改 PATH，也不读取旧产品登录态。
更新 npm 包或重新安装 Skill 是显式升级；已有入口继续使用自己固定的版本，不会自动升级或删除其他版本。下载失败后重新执行原命令即可重试。校验失败不会执行下载内容；若提示缓存损坏，先确认没有初始化进程运行，再移除提示的缓存目录并重试。残留锁同样只在确认初始化进程已停止后清理。
镜像配置
下载顺序是 GitHub Release、用户配置的兼容 npm 二进制镜像、公共 npmmirror。启动器优先读取环境变量 npm_config_registry；没有设置时，npm 可用则读取 npm config get registry 的有效值。缓存已存在时不再读取这些配置或访问下载站。
镜像基址须为不含用户名、密码、查询参数、空白或反斜杠的 HTTPS URL，可包含企业路径前缀。默认 npmjs registry 不提供二进制接口，会被跳过。镜像使用 /-/binary/fnos-cli/v<版本>/<资产名> 路径；普通 npm registry 可能没有此接口，失败后会继续下一源。环境变量设为空字符串时跳过自定义镜像。
所有源获取同一个固定版本，并使用包内摘要校验。网络或 HTTP 失败会继续下一源；成功收到的内容若大小或摘要不符，立即停止，本次不会尝试其他来源。所有来源都失败后可重新执行原命令。公共镜像的可用性取决于对应产品、版本资产的收录与同步；客户端具备回退逻辑不代表镜像已完成收录。
自动同步自 skills/fnos-cli/runtime-setup.md（fnos-cli 0.5.1）。请勿直接编辑本页，修改请提交到上游仓库 fnnas-labs/fnos-cli-skill。