# SDK 文档与能力索引

> 查找 SDK 接入指南，以及全部 20 项已授权 Chrovia 内核能力的独立参考文档。

Source: https://console.getchrovia.com/zh/docs/sdk-capabilities

先阅读接入指南，再选择应用需要的能力。

## 接入指南

| 指南 | 内容 |
| --- | --- |
| [开发入门](https://console.getchrovia.com/zh/docs/sdk-getting-started) | 启动独立实例，从第一个插件调用 API |
| [Linux 字体安装](https://console.getchrovia.com/zh/docs/sdk-linux-fonts) | 下载并安装 Windows 或 macOS 字体，用于 Linux Headless 爬虫 |
| [试用安装](https://console.getchrovia.com/zh/docs/trial-license) | 下载浏览器并安装已签发的试用 License |
| [License 生命周期](https://console.getchrovia.com/zh/docs/sdk-license) | 选择能力、安装、检查、替换并理解撤销 |
| [租约](https://console.getchrovia.com/zh/docs/sdk-leases) | 通过 Infra 保持在线授权并排查续租 |
| [Extended Preferences](https://console.getchrovia.com/zh/docs/sdk-extended-preferences) | 准备 EP 文件、读写应用数据、设置受支持的 Profile 偏好 |
| [Provision 目录](https://console.getchrovia.com/zh/docs/sdk-provision) | 打包安装级插件、默认文件、元数据和规则 |
| [内置插件](https://console.getchrovia.com/zh/docs/sdk-plugins) | 安装、开发、调试、更新及移除插件 |
| [JavaScript API 总览](https://console.getchrovia.com/zh/docs/sdk-javascript-api) | 选择执行上下文并找到正确 API 域 |
| [商业计费](https://console.getchrovia.com/zh/docs/commercial-license-billing) | 理解 License 定价与租约配额计算 |

## 全部授权能力

当前内核和 Console 目录包含以下 **20 项能力**。下表是精确的 License 能力键名。它们由 License 授予，添加相似名称的 EP 字段不会自动授权。

| 能力文档 | 能力键 | 配置或 API |
| --- | --- | --- |
| [自动化](https://console.getchrovia.com/zh/docs/sdk-automation) | `automation` | 仅限 Window 的 `chrovia.automation` |
| [声明式网络请求规则](https://console.getchrovia.com/zh/docs/sdk-declarative-net-request) | `declarativeNetRequest` | EP 固定规则及 Provision `dnr_rules.json` |
| [禁用开发者工具](https://console.getchrovia.com/zh/docs/sdk-disable-devtools) | `disableDevTools` | EP `internal.disable_devtools` |
| [Extended Preferences](https://console.getchrovia.com/zh/docs/sdk-extended-preferences) | `extendedPrefs` | `chrovia.prefs` 及白名单 `internal.profile_prefs` |
| 指纹覆盖 | `fingerprintOverride` | EP `internal.fingerprint_override` |
| [注入凭据](https://console.getchrovia.com/zh/docs/sdk-injected-credentials) | `injectedCredentials` | EP `internal.injected_credentials` |
| [实例外观](https://console.getchrovia.com/zh/docs/sdk-instance-appearance) | `instanceAppearance` | EP `internal.instance_appearance` |
| [实例元数据](https://console.getchrovia.com/zh/docs/sdk-instance-metadata) | `instanceMetadata` | `chrovia.instanceMetadata` 和 EP 公开字段 |
| [消息通信](https://console.getchrovia.com/zh/docs/sdk-messaging) | `messaging` | `chrovia.messaging` 和可选启动协调 |
| [原生对话框](https://console.getchrovia.com/zh/docs/sdk-native-dialog) | `nativeDialog` | `chrovia.ui` |
| [导航重定向](https://console.getchrovia.com/zh/docs/sdk-navigation-redirect) | `navigationRedirect` | EP `internal.navigation_redirect` |
| [网络拦截](https://console.getchrovia.com/zh/docs/sdk-network-intercept) | `networkIntercept` | `chrovia.network` |
| [密码显示限制](https://console.getchrovia.com/zh/docs/sdk-password-reveal-block) | `passwordRevealBlock` | EP `internal.password_reveal_block` |
| [密码存储](https://console.getchrovia.com/zh/docs/sdk-passwords) | `passwords` | 仅限 Provision Service Worker 的 `chrovia.passwords` |
| [进程管理](https://console.getchrovia.com/zh/docs/sdk-process-management) | `processManagement` | `chrovia.process.exit()` |
| [Extended Preferences 签名验证](https://console.getchrovia.com/zh/docs/sdk-signed-extended-prefs) | `signedExtendedPrefs` | 必需的 EP 签名验证 |
| [软件认证器](https://console.getchrovia.com/zh/docs/sdk-software-authenticator) | `softwareAuthenticator` | EP 软件 WebAuthn 凭据及保存、计数消息 |
| [监督进程](https://console.getchrovia.com/zh/docs/sdk-supervisor-process) | `supervisorProcess` | 监督 PID、presence 文件参数及 EP 行为 |
| [系统代理覆盖](https://console.getchrovia.com/zh/docs/sdk-system-proxy-override) | `systemProxyOverride` | EP `internal.system_proxy_override` |
| [不受扩展身份限制的 API](https://console.getchrovia.com/zh/docs/sdk-unrestricted-api) | `unrestrictedApi` | 扩大 JS 开放范围，不额外授予其他能力 |

## 使用示例的方式

- 将 EP 示例合并到一个 `internal` 对象。需要签名时，启动前获取完整的[已签名配置](https://console.getchrovia.com/zh/docs/sdk-signed-extended-prefs)，不能使用占位符。
- 除非另有标注，JavaScript 示例在 Provision Service Worker 中运行。
- Chrome 扩展权限与 License 能力需分别配置。
- 纯配置功能需要各文档列出的能力；使用 `chrovia.prefs` 还需要 `extendedPrefs`。