解决问题，不暴露秘密。

当前安装状态

开发与源代码体验可克隆仓库，运行 npm ci 和 npm run build:chrome，然后在浏览器扩展管理页以“加载已解压的扩展程序”方式载入 .output/chrome-mv3。只安装自己构建或来自可信来源的产物。

联系支持之前

• 确认 OTPManager 已更新；扩展更新后重新加载受影响的标签页。
• 确认保险库已解锁，且账户绑定到实际的网站主机名。
• 打开浏览器的扩展网站访问设置，确认已允许访问受影响的网站。
• 把设备时间与自动网络时间源进行比较；时钟明显不准会导致 TOTP 验证失败。
• 同步问题请测试配置端点，并检查 URL、凭据、存储桶或路径，以及浏览器权限提示。

没有出现自动填入

有些登录页会把字段放在受限框架或封闭 Shadow Root 中，扩展无法安全检查。请先允许网站访问、重新加载页面、聚焦验证码输入框，再从工具栏使用 OTPManager。也可以通过字段识别流程明确标记或忽略该字段。

同步或恢复失败

请记录完整错误，并说明使用 WebDAV 还是 S3。检查 HTTPS 证书、端点路径、对象存储区域、系统时间，以及其他设备是否更改了远端保险库。在导出确认可用的本地保险库或下载服务商备份之前，请勿删除远端数据。

忘记主密码

OTPManager 没有账户服务器，无法重置或找回主密码。如果仍有已解锁会话，请在锁定前导出或迁移数据；否则恢复需要可访问的备份和正确密码，或此前已配置的快捷解锁方式。

问题报告应包含什么

• OTPManager 版本与安装来源。
• 浏览器名称和版本、操作系统，以及是否在普通或隐私窗口运行。
• 受影响的网站主机名；如属敏感信息可省略。
• 编号后的复现步骤、预期结果、实际结果和不含秘密的完整错误文本。
• 已遮盖用户名、验证码、二维码值、令牌、端点路径和账户详情的截图。

如怀疑安全漏洞，请按安全页面的私密报告方式处理，不要公开发布。