表结构

数据库为 Cloudflare D1（SQLite），全部表由 migrations/ 下的迁移文件创建。下表是当前（迁移编号至 0032）的核心结构与新增表摘要。

posts（文章）

CREATE TABLE IF NOT EXISTS posts (
  id          TEXT PRIMARY KEY,       -- URL 别名
  title       TEXT NOT NULL,          -- 标题
  date        TEXT DEFAULT '',        -- 发布日期
  excerpt     TEXT DEFAULT '',        -- 摘要
  content     TEXT DEFAULT '',        -- Markdown 正文
  cover       TEXT DEFAULT '',        -- 封面图 URL
  pinned      INTEGER DEFAULT 0,      -- 置顶
  protected   INTEGER DEFAULT 0,      -- 加密标记
  enc         TEXT,                   -- 加密数据 JSON，明文文章为 NULL
  tags        TEXT,                   -- 标签 JSON 数组字符串
  category    TEXT DEFAULT '',        -- 分类（v2.10.60 已恢复分类页、筛选与编辑器 UI）
  status      TEXT DEFAULT 'published', -- published / draft
  created_at  TEXT DEFAULT '',
  updated_at  TEXT DEFAULT ''
);

enc 字段格式：JSON({salt, iv, data})，明文文章为 NULL；protected = 1 时列表接口不下发 content。详见文章加密。

comments（评论）

CREATE TABLE IF NOT EXISTS comments (
  id        TEXT PRIMARY KEY,
  post_id   TEXT NOT NULL,           -- 所属文章（留言板为合成 ID gb-note / gb-idea）
  author    TEXT DEFAULT '',
  content   TEXT DEFAULT '',
  date      TEXT DEFAULT '',
  status    TEXT DEFAULT 'approved', -- approved / pending
  parent_id TEXT DEFAULT NULL        -- 回复的父评论
);

CREATE INDEX IF NOT EXISTS idx_comments_post        ON comments(post_id);
CREATE INDEX IF NOT EXISTS idx_comments_parent      ON comments(parent_id);
CREATE INDEX IF NOT EXISTS idx_comments_status      ON comments(status);
CREATE INDEX IF NOT EXISTS idx_comments_post_id     ON comments(post_id, id);
CREATE INDEX IF NOT EXISTS idx_comments_status_date ON comments(status, date);

后两个索引由 0015_hot_path_indexes.sql 补齐：(post_id, id) 服务文章详情页的评论列表与去重查询，(status, date) 服务后台「按审核状态过滤 + 按日期排序」。详见迁移脚本。

stats（统计）

CREATE TABLE IF NOT EXISTS stats (
  post_id TEXT PRIMARY KEY,
  likes   INTEGER DEFAULT 0,
  views   INTEGER DEFAULT 0
);

stats_daily（每日统计）

CREATE TABLE IF NOT EXISTS stats_daily (
  post_id TEXT NOT NULL,
  date    TEXT NOT NULL,       -- YYYY-MM-DD
  views   INTEGER DEFAULT 0,
  likes   INTEGER DEFAULT 0,
  PRIMARY KEY (post_id, date)
);
CREATE INDEX IF NOT EXISTS idx_stats_daily_date ON stats_daily(date);

每次阅读/点赞按 (post_id, date) 累加，后台「近 30 天趋势」与 /api/stats/trend 直接读这张表。

admin_auth（管理员认证）

CREATE TABLE IF NOT EXISTS admin_auth (
  k           TEXT PRIMARY KEY,    -- 固定为 'auth'
  salt        TEXT DEFAULT '',
  hash        TEXT DEFAULT '',
  iter        INTEGER DEFAULT 100000,
  must_change INTEGER DEFAULT 0    -- 首次自动初始化的默认密码标记，改密后清零
);

密码以 PBKDF2-SHA256 加盐哈希存储（iter 默认 100000，为 CF WebCrypto 上限），绝不存明文。must_change 后端会随登录响应返回，但前端只做提示、不强制跳转。

admin_sessions（登录会话）

CREATE TABLE IF NOT EXISTS admin_sessions (
  token TEXT PRIMARY KEY,          -- 随机会话 token（hex）
  exp   INTEGER DEFAULT 0          -- 过期时间戳（毫秒），有效期 7 天
);
CREATE INDEX IF NOT EXISTS idx_admin_sessions_exp ON admin_sessions(exp);

admin_fails（登录限流计数）

CREATE TABLE IF NOT EXISTS admin_fails (
  ip    TEXT PRIMARY KEY,          -- 计数行的键：单 IP / subnet:… / __global__
  n     INTEGER DEFAULT 0,         -- 失败次数
  until INTEGER DEFAULT 0          -- 锁定截止时间；未达阈值时为计数窗口过期时间
);

ip 列复用为三种计数维度：

键形态	维度	阈值 → 冷却
`<真实 IP>`	单 IP	5 次失败 → 15 分钟
`subnet:1.2.3.0/24`（IPv4）或 `subnet:2001:db8:0:0:/64`（IPv6 取前 4 段）	子网	15 次失败 → 60 秒
`__global__`	全局	30 次失败 → 仅 10 秒 + 告警日志

until 兼作两种语义：达到阈值时表示锁定/冷却截止时间；未达阈值时表示计数窗口过期时间（1 小时）。冷却结束后若计数仍达阈值，会在 1 小时老化期内继续保留计数，避免「等冷却归零再重试」。登录与限流细节见安全概览与管理接口。

media（媒体）

CREATE TABLE IF NOT EXISTS media (
  id         TEXT PRIMARY KEY,
  name       TEXT NOT NULL,
  url        TEXT NOT NULL,     -- R2 公开地址或 http(s) 外链
  type       TEXT DEFAULT '',   -- MIME，如 image/png
  size       INTEGER DEFAULT 0, -- 字节
  created_at TEXT DEFAULT ''
);
CREATE INDEX IF NOT EXISTS idx_media_created    ON media(created_at);
CREATE INDEX IF NOT EXISTS idx_media_created_id ON media(created_at, id);

图片本体存放在 R2 媒体桶，D1 仅存元数据；接口层只接受 http/https 链接（不接受 base64 内嵌）。详见媒体。

music（音乐）

CREATE TABLE IF NOT EXISTS music (
  id         TEXT PRIMARY KEY,
  title      TEXT NOT NULL,
  artist     TEXT DEFAULT '',
  url        TEXT NOT NULL,     -- R2 公开地址
  cover      TEXT DEFAULT '',
  size       INTEGER DEFAULT 0, -- 字节
  duration   INTEGER DEFAULT 0, -- 秒
  sort       INTEGER DEFAULT 0, -- 排序
  created_at TEXT DEFAULT ''
);
CREATE INDEX IF NOT EXISTS idx_music_sort ON music(sort, created_at);

音频文件本体存放在 Cloudflare R2，D1 仅存元数据。详见音乐。

site_settings（站点设置）

CREATE TABLE IF NOT EXISTS site_settings (
  k TEXT PRIMARY KEY,
  v TEXT NOT NULL              -- 字符串或 JSON 字符串
);

当前使用的键包括：site_info、profile、nav_menu、footer_nav、friend_links、moderate_comments、features、comment_blocklist。其中 features 是后台「功能开关」与广告配置的 JSON，详见配置参考与站点设置。

site_files（站点产物）

CREATE TABLE IF NOT EXISTS site_files (
  name       TEXT PRIMARY KEY,  -- feed.xml / sitemap.xml
  content    TEXT DEFAULT '',   -- 生成的最新 XML 文本
  updated_at TEXT DEFAULT ''
);

新增表（0016 ~ 0032）

以下表格由后续迁移加入，完整 DDL 见仓库 migrations/：

表	主要字段	说明
`post_revisions`	id, post_id, title, content, tags, status, reason, created_at	文章版本历史，每篇最多保留 50 个快照
`backups`	id, object_key, size, reason, created_at, counts	R2 私有备份元数据
`subscribers`	id, email, status, token, locale, groups, confirmed_at	邮箱订阅与分组
`mail_outbox`	id, post_id, to_email, status, kind, payload, sent_at	新文章 / 评论通知 / 群发发件箱
`audit_log`	id, action, target, detail, ip, created_at	后台关键操作审计
`stats_sources`	post_id, date, kind, name, views	来源 / 国家 / 设备 / 系统 / 品牌按天聚合
`error_logs`	fingerprint, kind, message, source, stack, url, ua, hits, last_at	前端错误按指纹聚合
`webmentions`	id, source, target, post_id, author_name, title, excerpt, status, created_at	Webmention 外站引用
`posts_fts`	id, title, excerpt, content, tags	D1 FTS5 trigram 全文索引，自动同步 `posts`

posts 还新增了 og_image、series、series_order、publish_at、seo、author 等字段；comments 新增 likes、featured、pinned；media 新增 thumb_url。

schema_migrations（迁移记账表）

CREATE TABLE IF NOT EXISTS schema_migrations (
  name       TEXT PRIMARY KEY,                          -- 迁移文件名，如 0032_post_author.sql
  applied_at TEXT DEFAULT (datetime('now'))
);

这张表由 CI 创建（deploy.yml 的「Apply D1 schema」步骤里的 CREATE TABLE IF NOT EXISTS），不是 migrations/ 下的迁移文件。手工执行迁移时若想获得同样的跳过能力，请先自行执行上面的建表语句。

索引总览

索引	表 / 列	由哪个迁移创建
`idx_comments_post`	`comments(post_id)`	`0001_init.sql`
`idx_comments_parent`	`comments(parent_id)`	`0011_comment_reply.sql`
`idx_comments_status`	`comments(status)`	`0009_comment_status_index.sql`
`idx_stats_daily_date`	`stats_daily(date)`	`0008_stats_daily.sql`
`idx_media_created`	`media(created_at)`	`0006_media.sql`
`idx_comments_post_id`	`comments(post_id, id)`	`0015_hot_path_indexes.sql`
`idx_comments_status_date`	`comments(status, date)`	`0015_hot_path_indexes.sql`
`idx_music_sort`	`music(sort, created_at)`	`0015_hot_path_indexes.sql`
`idx_media_created_id`	`media(created_at, id)`	`0015_hot_path_indexes.sql`
`idx_admin_sessions_exp`	`admin_sessions(exp)`	`0015_hot_path_indexes.sql`

指南

部署

API 参考

数据库

安全

功能参考

贡献

更新日志

posts（文章）

comments（评论）

stats（统计）

stats_daily（每日统计）

admin_auth（管理员认证）

admin_sessions（登录会话）

admin_fails（登录限流计数）

media（媒体）

music（音乐）

site_settings（站点设置）

site_files（站点产物）

新增表（0016 ~ 0032）

schema_migrations（迁移记账表）

索引总览

ER 关系

​posts（文章）

​comments（评论）

​stats（统计）

​stats_daily（每日统计）

​admin_auth（管理员认证）

​admin_sessions（登录会话）

​admin_fails（登录限流计数）

​media（媒体）

​music（音乐）

​site_settings（站点设置）

​site_files（站点产物）

​新增表（0016 ~ 0032）

​schema_migrations（迁移记账表）

​索引总览

​ER 关系

posts（文章）

comments（评论）

stats（统计）

stats_daily（每日统计）

admin_auth（管理员认证）

admin_sessions（登录会话）

admin_fails（登录限流计数）

media（媒体）

music（音乐）

site_settings（站点设置）

site_files（站点产物）

新增表（0016 ~ 0032）

schema_migrations（迁移记账表）

索引总览

ER 关系