From 656ac79c0d02eaa1e2fc458e407208e7ec06304f Mon Sep 17 00:00:00 2001
From: hanyixuanten <hanyixuanten@outlook.com>
Date: Sun, 25 Oct 2026 12:18:30 +0000
Subject: [PATCH] docs: drop manual table creation, D1 schema auto-migrates on
 first request

---
 Home.md          |  2 +-
 Message-Board.md | 19 +++----------------
 2 files changed, 4 insertions(+), 17 deletions(-)

diff --git a/Home.md b/Home.md
index 769bf6b..c56dca4 100644
--- a/Home.md
+++ b/Home.md
@@ -18,7 +18,7 @@
 | [[Content-Format]] | 班史文章 / 歌曲的文件格式与字段说明 |
 | [[Deployment]] | 构建配置、环境变量总表 |
 | [[CMS-Bot]] | 投稿机器人的创建、安装与配置 |
-| [[Message-Board]] | D1 数据库建表与绑定 |
+| [[Message-Board]] | D1 数据库创建与绑定 |
 | [[Turnstile]] | 投稿表单人机验证（可选） |
 
 ## 相关链接
diff --git a/Message-Board.md b/Message-Board.md
index a8dfb31..ab6a308 100644
--- a/Message-Board.md
+++ b/Message-Board.md
@@ -6,22 +6,7 @@
 
 Dashboard → Storage & Databases → **D1** → Create database（名字随意，如 `class-history-messages`）。
 
-## 2. 建表
-
-在 D1 控制台的 Console 里执行：
-
-```sql
-CREATE TABLE IF NOT EXISTS messages (
-    id         INTEGER PRIMARY KEY AUTOINCREMENT,
-    name       TEXT NOT NULL,
-    text       TEXT NOT NULL,
-    time       TEXT NOT NULL,
-    ip         TEXT,
-    created_at INTEGER NOT NULL
-);
-```
-
-## 3. 绑定到 Pages
+## 2. 绑定到 Pages
 
 Pages 项目 → Settings → Functions → **D1 database bindings**：
 
@@ -34,6 +19,8 @@ Pages 项目 → Settings → Functions → **D1 database bindings**：
 ## 行为说明
 
 - 同一 IP 两条留言间隔至少 20 秒；
+- 表结构无需手动创建：首次访问时自动建表，旧表缺失的列也会自动补齐（`ensureSchema`）；
+- 每条留言会记录 IP、User-Agent、国家/地区作审计，仅存库，列表接口不返回；
 - 名字最长 12 字，内容最长 120 字，未填名字显示「匿名同学」；
 - 列表按时间倒序返回最多 200 条，库内只保留最近 500 条（自动清理）。