6. 启动 omicOS：serve 模式（浏览器）
omicos serve 是最常用的启动方式：起一个本地守护进程，然后用浏览器进入网页端操作。直接敲 omicos 等同于 omicos serve（serve 是默认子命令）。
6.1 最小用法
cd ~/your-workspace # 进入你想放数据 / notebook 的目录
omicos serve
终端会停住并打印类似：
[omicos] online: Local <dir> OmicOS (local-...)
[omicos] listening: http://127.0.0.1:5055
[omicos] opening: https://app.omicos.cn/#/?ws=127.0.0.1%3A5055&auto=true
随后会自动打开浏览器，进入网页端 app.omicos.cn。网页端会直接 attach 到当前这个本地端口，你就能开始聊天分析了。
如果浏览器没自动弹出，把终端打印的 opening: 那行 URL 复制到浏览器手动打开即可。
6.2 核心参数
| 参数 | 默认值 | 说明 | |
|---|---|---|---|
--host <地址> |
127.0.0.1 |
监听地址。默认只绑本机回环，安全。 | |
--port <端口> |
5055 |
HTTP 端口。 | |
--data-dir <路径> |
.omicos |
工作区数据目录（会话、轨迹、锁文件等）。 | |
--upstream-base-url <URL> |
无（serve 无默认值；env OMICOS_UPSTREAM_BASE_URL） |
本地 /api/* 代理回退目标（云同步 escape hatch）。不开启云端中继、也不决定 kernel 位置，详见远程章节。 |
|
--kernel-base-url <URL> |
无 | 远程 IPython kernel 地址。设了它会跳过本地 Python 环境引导。 | |
--no-browser |
（默认开浏览器） | 不自动打开浏览器（裸开关，不带值）。服务器场景常用。 | |
| `--debug <true\ | false>` | false |
打开调试日志，需带值（omicos serve --debug true），不是裸开关。 |
--log-filter <表达式> |
无 | 自定义 tracing 日志过滤器；对应环境变量 OMICOS_LOG_FILTER。 |
完整参数表见第 9 章：命令与参数速查。
6.3 服务器 / 无界面场景：--no-browser
在没有图形界面、或不希望弹浏览器的机器上：
omicos serve --no-browser
守护进程照常启动监听，只是不尝试唤起浏览器。你之后从别的机器的浏览器接入（见远程部署）。
6.4 工作区锁：一个目录只能起一个
omicos 在 <工作区>/.omicos/serve.pid 放一把锁，保证同一个工作区目录只能有一个守护进程。如果你在同一目录重复 omicos serve，会报：
omicos serve already running on this workspace
解决：要么 Ctrl+C 掉原来那个，要么换一个工作区目录，要么用 --data-dir 指向不同的数据目录。
注意：
omicos serve和omicos cli共享同一把工作区锁，所以同一个目录里二者不能同时跑。
6.5 它在终端里长什么样
omicos 会检测 stdout 是不是 TTY（交互终端）：
- 是 TTY（你在终端里直接敲的）→ 渲染一个 ratatui 仪表盘（dashboard），实时显示进程状态、连接、日志。
- 不是 TTY（被 systemd / nohup / Tauri 包起来跑的）→ 日志直接走 stderr，不画仪表盘。
这让 omicos 既适合人手交互，也适合后台托管。
6.6 健康检查
确认守护进程正常：
curl http://127.0.0.1:5055/health
# HTTP 200，返回 JSON（不是纯文本 "OK"）：
# {"service":"omicos-core","status":"ok","version":{"semver":"0.2.x","build_profile":"release","target_triple":"...", ...}}
curl -sS http://127.0.0.1:5055/api/process/info | python3 -m json.tool
# HTTP 200，形如：
# {"name":"OmicOS Core","runtime":"rust","kernel":"native-python-worker",
# "launched_by":"terminal","pid":12345,"version":"0.2.x","workspace":"...","id":"..."}
# 注意：响应里没有 "status" 字段。
# 未登录时 id、process_id、process_name 为空串、port/ws_port 为 0；
# 已登录后（即使是终端 / 命令行启动）会被填充，如 id = process_id = local-<workspace_id>
6.7 首次启动会引导 Python 环境
第一次 omicos serve 时，如果还没配好 Python 环境，它会同步引导一次（除非你设了 OMICOS_KERNEL_BASE_URL 用远程 kernel）。建议提前用 omicos env setup 配好（见第 4 章），避免首次启动卡在环境安装上。
下一步
想用纯终端而不是浏览器？看第 7 章：cli 模式。 想从远程服务器跑、本地浏览器看？看第 8 章：远程部署。