# 运行环境与数据路径（account-manager）

## 数据落盘位置

`get_data_root()` / `get_user_id()` 来自 **`scripts/jiangchang_skill_core/runtime_env.py`**（兼容 **`JIANGCHANG_*` / `CLAW_*` 别名**）；`scripts/util/runtime_paths.py` 在此基础上拼接技能子目录。

- **数据根目录**：默认读取宿主注入变量；开发模式下未注入时可能落到 Windows `D:\jiangchang-data` 等（详见 runtime_env 实现）。
- **用户 / 工作空间 id**：默认 `_anon`（以实际注入为准）。
- **技能数据目录**：`{数据根}/{用户id}/account-manager/`
  - **SQLite**：`account-manager.db`
  - **Master Key**：`master.key`（仅当执行过 `account init-master-key` 且未仅用环境变量场景）
  - **Profile**：`profiles/{domain}/{platform_key}/{safe_label}[_{login_id_suffix}]/`
  - **日志**：与其它技能共用 `{数据根}/{用户id}/logs/jiangchang.log`

## 调试：为什么「list 没数据」

- 若终端与网关注入的数据根 / 用户 id 不一致，会写到**不同目录**。
- 设置 **`JIANGCHANG_ACCOUNT_DEBUG_PATHS=1`**（或宿主等价开关）后，CLI 会在 **stderr** 打印实际路径。

## 本地 CLI 默认值

各技能 `main.py` 调用 `apply_cli_local_defaults()`：

- `CLI_LOCAL_DEV_ENABLED = True` 时，未设置环境变量则注入平台默认值。
- 发版前改为 `False` 或依赖宿主注入。

## Secret 存储

| 方式 | 说明 | 适用场景 |
|---|---|---|
| `none` | 不存 secret | 浏览器 profile 登录态 |
| `env` | SQLite 存变量名，运行时从 `os.environ` 读取 | 轻量测试 |
| `windows_credential` | secret 存 Windows Credential Manager | Windows 本地部署 |
| `local_encrypted` | Fernet 密文存 SQLite（`secret_ciphertext`），密钥来自 master key | RPA 密码落地；需先 `account init-master-key` |

- **禁止**把明文写入日志。
- `credential pick --reveal` / `credential resolve --reveal` 仍会输出明文 secret——仅限受控环境。

## Master Key

| 变量 | 作用 |
|---|---|
| `ACCOUNT_MANAGER_MASTER_KEY` | Fernet key（典型为 url-safe Base64 **44** 字符）；**优先级高于** `master.key` 文件 |

**加载优先级（解密路径）**：环境变量 → `master.key` 文件 → `ERR_MASTER_KEY_MISSING`。

**安全建议**

- 生产环境优先 **环境变量 / Secret Manager** 注入，不在磁盘留 `master.key`。
- 桌面环境可使用文件（默认尽力写入私有权限）。
- 备份 master key 至密码管理器；**丢失将导致所有 `local_encrypted` 凭据不可解密**。

详见 [`CLI.md`](CLI.md)（`init-master-key`）、[`ERRORS.md`](ERRORS.md)。

## 日志

| 变量 | 作用 |
|---|---|
| `JIANGCHANG_LOG_LEVEL` | 日志级别，默认 `INFO` |
| `JIANGCHANG_LOG_TO_STDERR` | 设为 `1`/`true` 等时，WARNING 及以上同步 stderr |
| `JIANGCHANG_LOG_FILE` | 覆盖主日志文件绝对路径 |
| `JIANGCHANG_LOG_BACKUP_COUNT` | 轮转保留份数，默认 `30` |
| `JIANGCHANG_TRACE_ID` | 可选；跨技能子进程由父进程注入 |

## 浏览器（`account open` / rpa_helpers）

- 本机需安装 Chrome 或 Edge。
- Python 侧依赖 **`playwright`**（匠厂共享 runtime 已内置）。
- 使用 **channel 模式**（`chrome` / `msedge`），**不下载 Chromium**。
- **不要执行** `playwright install chromium`。

### 关键浏览器参数（摘录）

- `headless=False`
- `no_viewport=True`
- `args` 包含 `--start-maximized`
- stealth 是否启用由 `OPENCLAW_PLAYWRIGHT_STEALTH` 控制（见 `launch_browser_with_profile`）

### rpa_helpers

登录编排封装见 [`RPA_HELPERS.md`](RPA_HELPERS.md)。