支持设备与排障
当前诊断支持范围
| 环境 | 状态 |
|---|---|
| Android 14 / API 34 及以上 | 诊断及受保护的 Pin 与 Restore |
| Xiaomi HyperOS | 初始调查与 Demo 场景 |
| 其他 OEM 设备 | 保守诊断；陌生但可读取的值需要额外写入风险确认 |
| Android 13 及以下 | 只显示设备信息，不支持修复 |
| 工作资料与其他 user | 所有操作均绑定明确检测到的前台 user |
常见症状
- 密码管理器显示为首选，但 Google Password Manager 接管 passkey 创建。
- Autofill 正常，而 Credential Manager 没有绑定 provider。
- 禁用另一个 provider 后，WebAuthn 操作看起来没有响应。
credential_service_primary指向的 provider 不在credential_service中。
这些症状本身不能确定责任组件。service 注册、enabled 状态、primary 状态、autofill 状态、浏览器行为、provider 锁定状态和 OEM framework 行为都是不同事实。
低风险检查
更新密码管理器、浏览器与系统组件；通过密码管理器支持的入口进入 provider 设置；切换到其他选项再切回；重启设备；解锁一次 provider；然后分别重试 passkey 创建与登录。不要把删除已有 passkey 当作排障步骤。
ADB 缺失时，UI 会展示可复制的安装说明，但不会运行 Homebrew、Winget、Scoop 或 Chocolatey。unauthorized 设备需要解锁并接受 USB 调试授权；offline 设备应优先重新连接，而不是直接重启全局 ADB 服务。CLI 可通过 acp-fixer devices 查看相同状态。
命令行用法
解压适合当前操作系统的 CLI 归档，在终端中运行 acp-fixer（Windows 为 acp-fixer.exe）。将 SERIAL、COMPONENT 和 ID 替换为工具报告的目标值。
sh
acp-fixer --help
acp-fixer devices --no-interactive
acp-fixer diagnose --device SERIAL --no-interactive
acp-fixer pin --device SERIAL --provider COMPONENT --no-interactive
acp-fixer snapshots --json
acp-fixer restore --snapshot ID --device SERIAL --no-interactive
acp-fixer demo --json上述 pin 和 restore 命令仅预览变更，写入必须显式添加 --apply；执行前请阅读变更安全指南。demo 使用内置数据，不访问设备。从源码开发时使用 just dev-cli，详见贡献指南。