04 · 管理端认证

管理端路由：/bookmarks/admin/（开发环境示例：http://localhost:4321/bookmarks/admin/）。

认证流程

• 校验通过后写入会话 token（sessionStorage），刷新页面无需重新输入凭据。
• 未认证状态仅展示登录门禁，不可进入编辑区。

凭据配置

开发环境通过环境变量配置（字段名以仓库 .env.example 为准）：

BOOKMARKS_ADMIN_PASSWORD=你的密码

修改 .env 后重启 vpr dev:all 或 dev 进程。勿将生产凭据提交至版本库。

环境与写权限

环境	写入 bookmarks.ts
本地 vpr dev	允许（Dev API）
生产构建 / GitHub Pages	默认禁止；仅内存草稿，刷新丢失

生产环境禁用写盘，避免未授权修改仓库。更新线上数据：本地编辑并持久化 → 提交 db/data/bookmarks.ts → 重新部署。

故障排查

凭据无效 — 核对 .env 中 BOOKMARKS_ADMIN_PASSWORD 并重启 dev。

生产环境保存失败 — 预期行为；在本地持久化后通过 Git 发布。

与 Starlight 认证无关 — 书签管理端为独立门禁，不共用文档站账号体系。