# env

指纹浏览器环境。CLI 只保留 Agent 主链：`list` 看名单、`start --name|--id --wait` 打开、`stop` 关闭、`status` 看会话。建/改/删环境、配代理与分组在网页环境页完成（CLI 报「已收归网页」并指路）。

上架不要先调用 `env start`。Desktop 员工会话 `drowup_listing_run` 的 `env` 会自己开窗。无 Desktop / Codex 调试时过渡 CLI `--env` 同样会 start --wait。

```powershell
"{baseDir}/bin/drowup.exe" env list --json
"{baseDir}/bin/drowup.exe" env start --name 环境显示名 --wait --json
"{baseDir}/bin/drowup.exe" env start --id PROFILE_ID --wait --json
"{baseDir}/bin/drowup.exe" env stop --name 环境显示名 --json
"{baseDir}/bin/drowup.exe" env stop --id PROFILE_ID --json
"{baseDir}/bin/drowup.exe" env status --json
```

`env start --wait` 打 Desktop 上官方指纹插件的回环接口启动环境，返回 `cdpUrl` 后才退出。已经打开的环境再 start 会复用同一条连接。`--id` 和 `--name` 都可以，名称必须在 `env list` 里唯一。不要把连接地址念给用户，不要扫描端口。

`env status` 输出每个会话的 `profileId / status / automation / cdpUrl / ok`。`ok=false` 的会话不要拿来跑脚本。

列表会去掉代理密码和指纹配置。不要调用 `getBrowserEnvironmentDefinition`。

## Agent 用法

1. `env list` 让用户点名。用户已经说出显示名则跳过。
2. 未开客户端时提示「请先打开 DrowUp 桌面客户端」。
3. 进店跑技能：Desktop 员工每个环境一条 `drowup_listing_run`（env / products / skill）。不要先 start，不要按产品循环调用。无 Desktop 才过渡 CLI invoke。
4. 用户只要开窗、不跑技能：`env start --name 环境名 --wait`。用完 `env stop --name 环境名`。

画布、产品库不依赖指纹环境。
