3. 安装：通过 npm 安装

这是最简单、最推荐的安装方式——不需要 Rust 工具链，npm 会自动下载与你系统匹配的预编译二进制。

3.1 一行命令安装

npm install -g @omicverse/omicos

安装完成后，验证：

omicos --help         # 能打印用法说明即安装成功

注意：omicos 没有 --version 这个 flag（omicos --version 会报 unexpected argument）。版本号要在守护进程运行后，通过 HTTP 接口查询：curl -sS http://127.0.0.1:5055/api/version（或 /health 响应里的 version 字段）。

3.2 它是怎么工作的（原理）

@omicverse/omicos 是一个 wrapper（包装）包，本身不含二进制。它通过 npm 的 optionalDependencies 声明了六个平台子包，npm 会根据你的 os 和 cpu 只安装匹配的那一个：

包里的 bin/omicos.js 是一个薄壳，运行时直接 exec 已安装的原生二进制。所以你敲 omicos，实际跑的是 Rust 编译出来的本体，没有 Node 运行时开销。

3.3 常见问题

Q: 提示 command not found: omicos？

npm 全局 bin 目录不在 PATH 里。运行 npm bin -g 查看该目录（如 /usr/local/bin 或 ~/.npm-global/bin），把它加进 PATH：

export PATH="$(npm bin -g):$PATH"   # 写进 ~/.zshrc 或 ~/.bashrc

Q: 权限报错（EACCES）？

不要用 sudo npm install -g。推荐改用用户级全局目录：

npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
npm install -g @omicverse/omicos

Q: 安装了但平台子包没装上？

确认 npm 版本够新（≥ 7，能正确处理 optionalDependencies），且没有用 --no-optional 标志。

3.4 升级

omicos 内置自动更新器：启动时会轮询云端发布清单（manifest），发现新版本会在后台下载、做 SHA-256 校验、原子替换二进制，下次启动生效。所以多数情况下你不需要手动升级。

如需手动升级到最新版：

npm install -g @omicverse/omicos@latest

下一步

二进制装好后，还需要配置 Python 分析环境，才能真正运行分析——进入第 4 章：配置 Python 分析环境。