7. 启动 omicOS：cli 模式（终端）

omicos cli 把守护进程和聊天界面合二为一，在终端里直接开一个 TUI（文本界面）聊天窗口，完全不需要浏览器。这是 SSH / HPC 环境的首选。

7.1 一条命令搞定

cd ~/your-workspace
omicos cli

它会：自动起本机守护进程 → 注册成一个 (cli) 进程 → 进入 ratatui 聊天窗口。omicos cli 等价于 omicos cli chat，chat 是默认子命令。

7.2 聊天界面键位

按键 作用
Enter 发送消息（输入法选字时按 Enter 选字不会误触发送）
Shift + Enter 换行（写多行消息）
Esc 退出

7.3 cli 与 serve 的关键差异

omicos cli 和 omicos serve 共享同一套参数，但默认值不同，这点容易踩坑：

维度 omicos serve omicos cli
默认 --data-dir .omicos .omicos/cli
默认 --upstream-base-url serve 无默认值 https://auth.omicos.cn（两者都可用 env OMICOS_UPSTREAM_BASE_URL 覆盖）
进程标识 local-<workspace_id> local-<workspace_id>-cli
进程显示名 原名 原名 + (cli)
日志 支持 --debug true / --log-filter stdout 被 TUI 占用，只能用 RUST_LOG

重要： 因为 data-dir 不同，serve 模式和 cli 模式的会话历史是互相隔离的、不互通。在网页端的进程选择器里，带 (cli) 后缀的和不带后缀的是两个独立命名空间。如果你在 cli 里聊的内容在网页端"看不到历史"，多半是选错了进程。

7.4 cli 专属参数（ChatArgs）

除了共享的守护进程参数，cli 模式还有几个聊天专用参数：

参数 作用
--process <id> 连接到指定的云端进程，而不是本地。例如在笔记本上连一台远程 HPC 节点上跑的 omicOS 进程。
--session <id> 恢复指定会话（默认恢复最近活跃的会话）。
--new 强制开一个新会话。

--process 是远程使用的利器：你可以在本地终端里，直接挂到云端某台机器的分析进程上聊天，详见远程部署配方。

7.5 与 serve 互斥

omicos cli 和 omicos serve 共享同一把工作区锁（.omicos/serve.pid），同一个工作区目录里二者不能同时运行。需要并存的话，给其中一个换 --data-dir。

7.6 调日志

cli 模式下 stdout 被 TUI 占满，--debug / --log-filter 用不了。要看日志只能用环境变量：

RUST_LOG=omicos_core=debug omicos cli

下一步

results matching ""

    No results matching ""