书签模块

书签为独立应用模块：导航页 /bookmarks/nav/，管理端 /bookmarks/admin/。与 Starlight 文档分路由部署，共用全站主题子系统。

使用流程

1. 浏览 — 访问 /bookmarks/nav/，数据来自构建期 Astro DB seed。
2. 编辑 — 本地开发环境打开 /bookmarks/admin/，认证后可 CRUD、拖拽排序；持久化写入 db/data/bookmarks.ts。
3. 发布 — 提交 bookmarks.ts 并部署；生产环境管理端默认无写权限（见 04 管理端认证）。

文档索引

01 · 架构与技术选型 模块边界、injectRoute 与关键取舍

02 · 数据模型与 Astro DB Schema、seed 与查询

03 · 导航页与客户端渲染 entry.astro、JSON 注水与 React 树

04 · 管理端认证 凭据配置、会话与写权限

05 · 管理端编辑界面 布局、网格编辑与草稿模型

06 · 书签站点图标 站点 Logo 来源、bookmark-logos 缓存与管理端展示

07 · 持久化与部署 Dev API、构建与发布

源码结构见 src/bookmarks/README.md。