9. 命令与参数速查

omicos 全部命令与参数，集中成表。基线版本 0.3.29。

9.1 命令树

omicos
├── serve                  HTTP 守护进程 + 浏览器 UI（无子命令时的默认）
├── cli                    终端聊天界面 + 内嵌守护进程
│   ├── chat               交互式聊天（cli 的默认子命令）
│   ├── login              设备码配对登录
│   └── logout             登出 cli 保存的账户
├── login                  邮箱 / 密码登录（终端，无需浏览器）
├── env
│   ├── setup              安装 / 修复 Python 分析环境
│   ├── doctor             诊断 Python 与 kernel 可用性
│   └── list               以 JSON 列出候选 Python 环境
├── hpc                    服务器 / HPC 的交互式环境向导，选完直接 serve
├── a2a                    Agent2Agent 对外端点（0.3.29 之后的版本提供）
│   ├── enable / disable   开 / 关端点
│   ├── status             判断端点会不会挂载，不会的话给出原因
│   └── key
│       ├── create         签发一枚 API key（密钥只显示这一次）
│       ├── list           列出已签发的 key（只有 id 和标签）
│       └── revoke <id>    吊销一枚 key，下一次请求即生效
└── recover-conversations  把隔离期之前的旧会话归属到当前账户（运维用）

查看这份列表：

omicos --help

预期输出（节选）：

Rust runtime core for OmicOS

Usage: omicos [OPTIONS] [COMMAND]

Commands:
  login
  serve
  cli                    Terminal chat client (TUI) — talks to a running omicos process over HTTP+SSE. See `omicos cli --help`
  env                    Manage the bundled Python analysis environment (the shared kernel)
  a2a                    Manage the Agent2Agent (A2A) endpoint: on/off, API keys, status
  hpc                    Guided setup for servers / HPC: choose (or install) a Python env for the kernel, optionally make it the default, then serve. Interactive
  recover-conversations  Attribute quarantined pre-isolation conversations after the operator has verified that this account exclusively owns the local data root
  help                   Print this message or the help of the given subcommand(s)

Options:
      --host <HOST>  [default: 127.0.0.1]
      --port <PORT>  [default: 5055]
      …
  -h, --help         Print help
  -V, --version      Print version

查版本：

omicos --version

预期输出：

omicos 0.3.29+a1b2c3d

9.2 serve 参数

顶层的 omicos（不带子命令）接受这组参数。

9.3 cli 参数

守护进程参数：

cli 模式下界面占满屏幕，--debug / --log-filter 不可用，只能用 RUST_LOG 环境变量。

聊天参数：

子命令： omicos cli chat（默认）、omicos cli login、omicos cli logout。

9.4 login 参数

9.5 cli login 参数

9.6 env 参数

9.7 hpc 参数

omicos hpc 接受全部 serve 参数（选完环境后原样应用），外加：

9.8 a2a 参数（0.3.29 之后的版本提供）

Agent2Agent 端点让外部智能体按 A2A 协议调用本机 omicos。需要 pro 及以上订阅。具体协议与对接方式见进阶（三）：A2A 协议与外部智能体互操作。这里只列命令。

排查端点为什么没起来，用 status：

omicos a2a status

预期输出（未开启时）：

A2A endpoint status
  config      : /Users/you/.omicos/a2a.json
  keys        : /Users/you/.omicos/a2a_keys.json
  enabled     : false
  exposed agent: omicverse_omni
  plan        : pro (A2A requires pro or higher — ok)
  active keys : 0
  file parts  : inline limit 100 MiB; url parts disabled
  artifacts   : files up to 1024 KiB ship inline; larger ones as /a2a/v1/artifacts URLs
  bind host   : 127.0.0.1 (loopback)

  endpoint    : NOT mounted — disabled. Enable with `omicos a2a enable`.

  discovery   : /.well-known/agent-card.json (always anonymous)

9.9 recover-conversations 参数

认领「账户隔离」上线前遗留的、无归属旧会话到当前登录账户名下。日常用不到。只在从很老的版本升级、旧会话不显示时才需要。

先干跑：

omicos recover-conversations --dry-run

预期输出：

Recovery preview: 12 recoverable non-empty conversations (9 ownerless, 3 current OS-user anonymous); 0 conflicting ownership rows. No files changed.

确认数字无误后执行：

omicos recover-conversations --expected-count 12 --confirm-exclusive-data-root

预期输出：

Recovered 12 conversations locally; cloud upload remains disabled until each conversation is explicitly continued or deleted.

9.10 serve vs cli 默认值对照

这些默认值只在 cli 自己起守护进程时成立。工作区里已经有 serve 在跑时，omicos cli 会直接连上它，此时用的是 serve 的数据目录和进程身份。

几乎每个参数都有对应的环境变量可以覆盖，完整清单见第 10 章：环境变量参考。