浏览器档案
在多个会话之间持久化和复用浏览器状态。
在多次浏览器运行之间复用 cookies、localStorage、IndexedDB 或指纹配置。
按客户、账号或工作流拆分档案，让权限和排查保持清楚。
只复用时用只读；工作流需要保存新状态时再使用读写。
什么时候使用浏览器档案
没有状态要求的任务可以直接创建一次性会话。出现以下需求时再使用浏览器档案：
避免每次任务都重新登录，并降低目标网站风控噪音。
保存目标网站写入的 cookies、localStorage 或 IndexedDB。
让多个自动化任务使用同一份可控浏览器状态。
按客户、账号或业务线拆分状态，排查和权限控制更清楚。
不要把所有任务都塞进同一个浏览器档案。按账号、客户或业务流程拆分，后续排查和权限控制会更清楚。
浏览器档案工作机制
通过 POST /v1/profiles 创建浏览器档案，初始状态为空。
在 POST /v1/sessions 中传入 profileId，让会话加载这份状态。
Chromium 运行期间会产生新的 cookies、storage 和站点上下文。
会话停止后，运行节点把更新后的档案 blob 写回存储，供下个会话加载。
写锁
同一时间只有一个会话可以写入同一个浏览器档案。当你用某个 profileId 创建会话时，API 会在该浏览器档案上获取一个 写锁，防止并发会话互相覆盖状态。
已锁定档案会拒绝新的写入请求，而不是覆盖状态。写锁会在会话停止并且更新后的档案 blob 持久化完成后释放；如果运行节点在会话中途失败，只通过 POST /v1/profiles/{id}/unlock 做显式恢复。
默认策略：能用一次性会话就不要附加浏览器档案；只复用登录态时保持只读；只有工作流需要刷新登录态或保存新上下文时才允许写回。
指纹生成配置
浏览器档案可以携带 生成器配置（Generator Config），用于控制浏览器属性和指纹生成器输入。把它当作高级能力使用；普通抓取、截图或自动化任务通常只需要浏览器档案的状态持久化能力。字段格式、snake_case 约定和更新接口见浏览器档案 API 参考。
核心路径只需要创建浏览器档案、附加到会话并决定停止时是否回写。列出、删除、blob 上传、生成器配置和解锁等字段级细节见浏览器档案 API 参考；恢复类端点只用于受控恢复，不是普通会话路径。