#恢复码与身份找回

#什么是恢复码

恢复码是一串由字母和数字组成的特殊代码，格式如：

ABCD-EFGH-IJKL-MNOP

注册访客后系统会生成专属恢复码，请务必立即保存。当你在其他设备上需要访问账户，或者当前 Token 丢失无法登录时，可以使用恢复码重新获取身份令牌。

⚠️ 恢复码仅展示一次。 注册成功后会弹出窗口显示恢复码，关闭后无法再次查看。如果忘记保存，可以在设置页生成新的恢复码（旧码会立即失效）。

#获取恢复码

#注册后自动获取

输入昵称完成注册后，页面会弹出一个窗口，展示你的专属恢复码。点击复制恢复码按钮保存到剪贴板，然后妥善保管。

#设置页重新生成

如果你在注册时没有保存恢复码，或者恢复码已使用，可以在设置页重新生成：

1. 点击左侧边栏底部的访客名称，进入设置页
2. 在「通用」标签页中找到「恢复码」区域
3. 点击生成恢复码按钮
4. 系统会生成新的恢复码并展示在页面上
5. 立即复制保存，关闭后不再可见

重新生成恢复码会使旧的恢复码立即失效。

#使用恢复码找回身份

当你无法使用原有 Token 登录时（如清除了浏览器 Cookie）：

1. 在浏览器中打开 mdocs 站点，如果没有有效 Cookie，会自动进入注册页
2. 在注册表单下方，点击 已有恢复码？点击找回 链接
3. 在弹出的输入框中输入你保存的恢复码
4. 点击 找回身份
5. 系统验证通过后会自动登录，并下发新的身份 Cookie

恢复码是一次性使用的，验证成功后该恢复码即失效。你可以在设置页生成新的恢复码。

#常见问题

#为什么恢复码只展示一次？

恢复码是明文显示的唯一凭证。系统只存储其 SHA-256 哈希值，不存储原文。所以系统本身无法再展示该码，只能验证你输入的是否正确。

#恢复码丢失了怎么办？

• 如果你还能正常登录，请立即进入设置页生成新的恢复码并保存
• 如果你已无法登录，请联系管理员执行访客合并脚本（visitor migrate）

#恢复码和 Token 有什么区别？