9. 命令与参数速查

本章是一份纯参考——把 omicos 的全部命令和参数集中成表，方便随时查阅。

9.1 命令树

omicos
├── serve              HTTP 守护进程 + 浏览器 UI（无子命令时的默认）
├── cli                终端 TUI 聊天 + 内嵌守护进程
│   ├── chat           交互式聊天（cli 的默认子命令）
│   └── login          设备码配对登录（终端，从另一设备授权）
├── login              邮箱 / 密码登录（终端，无需浏览器）
└── env
    ├── setup          安装 / 修复 Python 分析环境
    └── doctor         诊断 Python 与 kernel 可用性

9.2 serve 参数

参数 类型 默认 说明
--host string 127.0.0.1 绑定地址
--port u16 5055 HTTP 端口
--data-dir path .omicos 工作区数据目录
--upstream-base-url string serve 无默认 本地 /api/* 代理回退目标（云同步 escape hatch）；env OMICOS_UPSTREAM_BASE_URL。不开启云端中继（中继由登录的 process_token 决定）
--kernel-base-url string 无 远程 IPython kernel 地址；env OMICOS_KERNEL_BASE_URL；设置则跳过本地环境引导
--no-browser flag 关（即默认开浏览器） 不自动打开浏览器（裸开关）
--debug bool（带值） false 开启调试日志，须写成 --debug true，不是裸开关
--log-filter string 无 tracing 过滤表达式；env OMICOS_LOG_FILTER

9.3 cli 参数

cli 复用全部 serve 的守护进程参数（但默认值不同，见下），并额外提供聊天参数：

守护进程参数（默认值差异）：

参数 cli 默认
--data-dir .omicos/cli（serve 是 .omicos）
--upstream-base-url https://auth.omicos.cn（serve 无默认值；两者都可由 env OMICOS_UPSTREAM_BASE_URL 覆盖）

cli 模式下 stdout 被 TUI 占用，--debug / --log-filter 不可用，只能用 RUST_LOG 环境变量。

聊天参数（ChatArgs）：

参数 类型 说明
--process string 连接到指定的云端进程（如远程 HPC 节点）
--session string 恢复指定会话（默认恢复最近活跃会话）
--new flag 强制开新会话

9.4 login 参数

参数 默认 说明
--server https://auth.omicos.cn 认证服务地址
--email （交互提示） 邮箱
--password （交互提示） 密码
--name （取 conda env 名或目录名） 进程显示名
--force 关 已登录也强制重新认证
--status 关 只校验登录状态，打印后退出
--logout 关 登出并删除凭证

9.5 cli login 参数

参数 默认 说明
--server https://auth.omicos.cn 认证服务地址（仅设备码流程）
--logout 关 登出

9.6 env 参数

子命令 参数 说明
env setup --force 即使环境已存在也重新 uv sync
env setup --yes 非交互，自动确认
env doctor （无参数） 诊断并打印环境信息

9.7 serve vs cli 默认值对照

维度 serve cli
--data-dir .omicos .omicos/cli
--upstream-base-url serve 无默认值 https://auth.omicos.cn
日志方式 --debug true / --log-filter / RUST_LOG 仅 RUST_LOG
进程标识 local-<workspace_id> local-<workspace_id>-cli
界面 浏览器 SPA + 可选仪表盘 终端 TUI

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

results matching ""

    No results matching ""