# Chrovia 入门指南

> 从使用 PersonaHub 身份或集成 Chrovia SDK 开始，查找凭证管理、自动化、授权与浏览器能力的操作指南。

Source: https://console.getchrovia.com/zh/docs/getting-started

先选择你要做的事。**PersonaHub** 是用于创建和启动浏览器身份的桌面客户端；**Chrovia SDK** 面向需要把浏览器内核集成到自己应用中的开发者。使用 PersonaHub，不需要自行完成 SDK 的 License 和插件配置步骤。

## 第一个 PersonaHub 身份

1. 前往[下载页面](https://console.getchrovia.com/zh/download)下载并安装 PersonaHub，然后在桌面客户端中登录。
2. [创建身份](https://console.getchrovia.com/zh/docs/create-profile)：填写名称和外观，按需配置节点，然后保存身份。节点不是必填项；如果配置了节点，需要先检测通过再创建身份。
3. [启动身份浏览器](https://console.getchrovia.com/zh/docs/launch-profile)：打开网站并登录。下次继续启动同一个身份，即可沿用它的浏览器数据。

## 密码和登录验证

这些指南介绍 PersonaHub 及其身份浏览器中的操作，不是 SDK API 的调用方法。

- 保存或管理网站用户名和密码：[密码管理](https://console.getchrovia.com/zh/docs/password-management)
- 扫描身份验证器二维码，获取动态验证码：[TOTP](https://console.getchrovia.com/zh/docs/totp)
- 为身份注册、使用或删除软件通行密钥：[通行密钥](https://console.getchrovia.com/zh/docs/passkeys)

## 自动化与 AI 客户端

- 让浏览器自动化工具连接正在运行的 PersonaHub 身份：[启用 CDP](https://console.getchrovia.com/zh/docs/enable-cdp)
- 让 AI 客户端通过本地 MCP 服务操作 PersonaHub 身份：[连接 MCP](https://console.getchrovia.com/zh/docs/connect-mcp)
- 不使用 PersonaHub，而是直接集成 SDK 自动化能力：[SDK 自动化](https://console.getchrovia.com/zh/docs/sdk-automation)

## 合作奖励

- 通过 PersonaHub 专属链接注册 Bright Data，消费获得抵扣金并兑换 Pro：[合作奖励](https://console.getchrovia.com/zh/docs/partner-rewards)

## 第一个 SDK 实例

1. 还没有浏览器和试用 License：[安装试用 License](https://console.getchrovia.com/zh/docs/trial-license)。
2. 要启动独立浏览器实例，并从插件调用第一个 API：[SDK 开发者快速开始](https://console.getchrovia.com/zh/docs/sdk-getting-started)。
3. 要为自己的应用选择能力：[SDK 文档与能力索引](https://console.getchrovia.com/zh/docs/sdk-capabilities)。

## License 与在线授权

- 了解 License 授予什么能力、放在哪里、如何替换：[License 生命周期](https://console.getchrovia.com/zh/docs/sdk-license)
- 了解在线租约、续租与授权失败：[在线租约](https://console.getchrovia.com/zh/docs/sdk-leases)
- 购买商业 License，或了解购买价格、有效期与小时配额：[商业 License 计费](https://console.getchrovia.com/zh/docs/commercial-license-billing)

## 配置与内置插件

- 准备浏览器配置，或读写应用偏好数据：[Extended Preferences](https://console.getchrovia.com/zh/docs/sdk-extended-preferences)
- 使用要求偏好签名的 License：[Extended Preferences 签名验证](https://console.getchrovia.com/zh/docs/sdk-signed-extended-prefs)
- 把插件、默认文件和发布元数据随浏览器一起分发：[Provision 目录](https://console.getchrovia.com/zh/docs/sdk-provision)
- 安装、调试、更新或移除内置扩展：[内置插件](https://console.getchrovia.com/zh/docs/sdk-plugins)
- 查找 API，以及可以调用它的 JavaScript 上下文：[JavaScript API 概览](https://console.getchrovia.com/zh/docs/sdk-javascript-api)

## 浏览器能力

License 授予能力，配置和 API 调用决定应用如何使用这些能力。按需要阅读对应指南，不必把所有配置都放进同一个实例。

- 调整浏览器身份与网络设置：指纹覆盖、[系统代理覆盖](https://console.getchrovia.com/zh/docs/sdk-system-proxy-override)
- 过滤请求或改变导航目标：[声明式网络请求规则](https://console.getchrovia.com/zh/docs/sdk-declarative-net-request)、[网络拦截](https://console.getchrovia.com/zh/docs/sdk-network-intercept)、[导航重定向](https://console.getchrovia.com/zh/docs/sdk-navigation-redirect)
- 提供或管理登录凭证：[注入凭证](https://console.getchrovia.com/zh/docs/sdk-injected-credentials)、[密码存储](https://console.getchrovia.com/zh/docs/sdk-passwords)、[软件认证器](https://console.getchrovia.com/zh/docs/sdk-software-authenticator)
- 协调启动过程与浏览器退出：[消息通信](https://console.getchrovia.com/zh/docs/sdk-messaging)、[监督进程](https://console.getchrovia.com/zh/docs/sdk-supervisor-process)、[进程管理](https://console.getchrovia.com/zh/docs/sdk-process-management)
- 定制浏览器展示：[实例外观](https://console.getchrovia.com/zh/docs/sdk-instance-appearance)、[实例元数据](https://console.getchrovia.com/zh/docs/sdk-instance-metadata)、[原生对话框](https://console.getchrovia.com/zh/docs/sdk-native-dialog)
- 限制开发者工具或密码显示：[禁用开发者工具](https://console.getchrovia.com/zh/docs/sdk-disable-devtools)、[密码显示限制](https://console.getchrovia.com/zh/docs/sdk-password-reveal-block)
- 了解默认插件上下文之外的 API 访问范围：[不受扩展身份限制的 API](https://console.getchrovia.com/zh/docs/sdk-unrestricted-api)

[能力索引](https://console.getchrovia.com/zh/docs/sdk-capabilities)列出了全部能力键及其配置或 API 参考。