常见问题

1. 数据存放在哪里？

所有数据默认存储于浏览器 localStorage，支持 JSON 文件的手动备份与还原，也可以一键同步到 GitHub 仓库中。

2. 为什么在不同的设备上看不到我的书签？

由于是纯前端应用，如果您没有配置 GitHub 同步功能，数据只会保存在当前设备的浏览器中。配置 GitHub 同步后，即可在多设备间同步书签。

3. 书签不是最新保存的？

检查网络连接是否正常，也可能是浏览器缓存原因，请尝试Ctrl+F5强制刷新，还是不行请按F12打开开发者工具，彻底清空缓存。

4. 忘记密码了怎么办？

如果忘记了密码，请在云服务商控制台重新设置 ADMIN_PASSWORD 环境变量，然后重新部署即可；如果是本地部署的可以直接修改本地 .env 文件，然后重启服务。如未配置环境变量，默认密码为 admin1234。

5. 环境变量与界面填写的配置冲突/优先级如何处理？

• 优先级规则：界面设置（浏览器 localStorage）> 部署环境变量默认值。
  • 若在界面中配置了仓库或 Token，系统会优先使用界面填写的值并保存在当前设备中。
  • 仅当本地没有自定义设置时，才会回退读取部署时注入的环境变量。
• 单项修改（例如仅在界面修改了仓库地址）：
  • 修改的项采用新值，未修改的项继续沿用已有配置（或环境变量）。
  • 同步时系统会使用当前生效的 Token 访问目标仓库，请确保该 Token 对新仓库拥有读写权限，否则会报错 404 Not Found 或 403 Bad credentials。