# VirtualBrowser

## Docs
- [接入前必读](https://doc.virtualbrowser.cc/9660127m0.md): 
- [附录 A：MCP 接口（AI 自动化）](https://doc.virtualbrowser.cc/9660128m0.md): 
- [附录 B：常见问题](https://doc.virtualbrowser.cc/9660129m0.md): 

## API Docs
- 环境基础 [获取浏览器环境列表](https://doc.virtualbrowser.cc/534361634e0.md): 查询环境列表。支持 page / pageSize 分页参数，两者需同时传才生效；不传则返回全部环境。
- 环境基础 [获取浏览器环境列表](https://doc.virtualbrowser.cc/534340955e0.md): 查询环境列表，可按 group（分组，数组或字符串）、name（环境名称）、remark（备注，仅 POST）过滤，返回 total 为过滤后的总数。
- 环境基础 [获取环境完整参数](https://doc.virtualbrowser.cc/534340956e0.md): 查询环境的完整指纹参数。不传 id 时返回所有环境的完整参数。
- 环境基础 [获取运行中的环境列表](https://doc.virtualbrowser.cc/534340957e0.md): 获取运行中的浏览器列表，包含调试端口与 chromedriver 路径。
- 环境基础 [创建环境](https://doc.virtualbrowser.cc/534340958e0.md): 创建环境，支持配置名称、备注、分组、代理和全部指纹参数。未传的字段自动随机生成。
- 环境基础 [更新环境](https://doc.virtualbrowser.cc/534340959e0.md): 修改环境参数。未传的字段保持原值；传 cookie.jsonStr 会覆盖环境 cookie。
- 环境基础 [删除环境](https://doc.virtualbrowser.cc/534340960e0.md): 删除指定环境。只删除配置，不删除数据目录。
- 环境基础 [启动环境](https://doc.virtualbrowser.cc/534340961e0.md): 启动环境，成功返回调试端口。id / name / remark 三者选一。
- 环境基础 [关闭环境](https://doc.virtualbrowser.cc/534340962e0.md): 关闭指定环境。会等待进程退出（最长约 3 秒）。
- 环境数据 [删除环境数据](https://doc.virtualbrowser.cc/321906580e0.md): 删除环境的数据目录（cookie、登录数据、缓存等），不可恢复。需先关闭环境。
- 环境数据 [获取环境cookie](https://doc.virtualbrowser.cc/321907574e0.md): 注意：需要关闭环境后调用此接口
- 环境数据 [更新环境cookie](https://doc.virtualbrowser.cc/321916098e0.md): 注意：需要关闭环境后调用此接口
- 环境数据 [清除环境缓存](https://doc.virtualbrowser.cc/534340974e0.md): 清除环境缓存，不影响 cookie 与已保存的账号。需先关闭环境。
- 环境数据 [更新环境指纹](https://doc.virtualbrowser.cc/321917964e0.md): 重新随机生成环境指纹。name、chrome_version、proxy、group 保持不变。
- 运行与工具 [查询当前环境ID是否在运行中](https://doc.virtualbrowser.cc/534340984e0.md): 查询指定环境是否正在运行。返回体中的 data 为布尔值。
- 运行与工具 [窗口排列](https://doc.virtualbrowser.cc/522020320e0.md): 窗口自动排列，仅对已启动的环境生效。
- 运行与工具 [获取内核版本信息](https://doc.virtualbrowser.cc/486468383e0.md): 获取本机可用内核版本信息。别名：/api/getAvailableCoreVersions。
- 分组管理 [获取分组列表](https://doc.virtualbrowser.cc/321918921e0.md): 获取分组列表。
- 分组管理 [添加分组](https://doc.virtualbrowser.cc/321919210e0.md): 创建分组。
- 分组管理 [更新分组名称](https://doc.virtualbrowser.cc/321920474e0.md): 更新分组名称。分组不存在返回 404。
- 分组管理 [删除分组](https://doc.virtualbrowser.cc/321937781e0.md): 删除分组。
- 插件管理 [获取插件列表](https://doc.virtualbrowser.cc/321938421e0.md): 获取插件列表。
- 插件管理 [添加插件](https://doc.virtualbrowser.cc/321939898e0.md): 从谷歌商店或微软商店安装插件到全局插件库。
- 插件管理 [删除插件](https://doc.virtualbrowser.cc/321966934e0.md): 删除插件。
- 平台账号 [获取环境中平台保存的账号密码](https://doc.virtualbrowser.cc/424335545e0.md): 读取指定环境已保存的全部平台账号，密码已解密为明文。
- 平台账号 [新增环境中平台账号密码](https://doc.virtualbrowser.cc/424339010e0.md): 新增账号，不影响已保存的其他账号。
- 平台账号 [更新环境中平台账号密码](https://doc.virtualbrowser.cc/424340706e0.md): 以全量列表覆盖方式更新环境内的平台账号。未出现在 accounts 中的原有账号会被删除。
- 平台账号 [删除环境中平台账号密码](https://doc.virtualbrowser.cc/424339743e0.md): 按账号删除，删除不存在的账号不报错（幂等）。
- 云同步 [查询环境云同步状态](https://doc.virtualbrowser.cc/534308444e0.md): 查询环境是否开启云同步，以及当前账号的登录、会员状态。只读本地状态，不产生云端请求。
- 云同步 [设置环境云同步开关](https://doc.virtualbrowser.cc/534310087e0.md): 开启或关闭指定环境的云同步。
- 云同步 [删除云端备份](https://doc.virtualbrowser.cc/534312467e0.md): 删除环境在云端的备份，包括环境包、账号密码信封和云 ID 登记。