# 多实例与 Profile

这页说明如何在同一台机器上并行运行多个互不干扰的 OpenProgram 实例——常见场景是一个稳定实例日常用，一个开发实例改代码。

## profile：隔离状态目录

默认所有状态（config / sessions / logs / memory）都在 `~/.openprogram/`。指定 profile 后改存 `~/.openprogram-<name>/`，两个实例互不共享任何数据：

```bash
openprogram --profile dev            # CLI 全局参数
OPENPROGRAM_PROFILE=dev openprogram  # 或环境变量，二者等价（两者都设时以参数为准）
```

`--profile` 是全局参数，放在子命令前，对所有子命令生效：`openprogram --profile dev sessions list`、`openprogram --profile dev restart` 等。

## 端口：每个实例一个

每个实例只监听一个端口（API、WebSocket 和 web UI 同端口），默认 18100。改端口有三种方式：

```bash
# 1. 持久化到该 profile 的配置（推荐，之后启动不用再带参数）
openprogram --profile dev ports --port 18200

# 2. 环境变量，覆盖本次运行
OPENPROGRAM_WEB_PORT=18200 openprogram web

# 3. 命令行参数，只对这一次 `openprogram web` 生效
openprogram web --web-port 18200
```


`ports` 的设置写进当前 profile 的 config，所以每个 profile 记住自己的端口。

## 示例：稳定 + 开发双实例

稳定实例用默认 profile 和默认端口，开发实例用 `dev` profile 和 18200：

```bash
# 稳定实例（日常使用）
openprogram web                        # http://localhost:18100

# 开发实例：先把端口写进 dev profile（一次性）
openprogram --profile dev ports --port 18200

# 之后每次这样启动
openprogram --profile dev web          # http://localhost:18200
```

两个实例各有自己的会话、配置、日志和后台 worker；`openprogram status` 看的是默认实例，`openprogram --profile dev status` 看开发实例。

Linux 上的常驻 worker 也按 profile 隔离。分别在各自的命令上下文安装，
OpenProgram 会创建两个独立的 systemd 用户服务：

```bash
openprogram worker install
openprogram --profile dev worker install
```

此后 `worker start`、`stop`、`restart`、`status` 和 `uninstall` 都只操作
当前 profile 的服务；停止或升级 `dev` worker 不会替换或停止默认 worker。