From 91d83f714cd8dc83c2bfc42f1ce16819c8cc86df Mon Sep 17 00:00:00 2001
From: xfy <i@rua.plus>
Date: Thu, 18 Jun 2026 16:06:06 +0800
Subject: [PATCH] docs(migrate.sh): note server auto-migrates on startup; this
 is a fallback

---
 migrate.sh | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/migrate.sh b/migrate.sh
index 14e49ee..f2e8f08 100755
--- a/migrate.sh
+++ b/migrate.sh
@@ -1,4 +1,16 @@
 #!/usr/bin/env bash
+#
+# 数据库迁移脚本（手动 / CI 备用）。
+#
+# 注意：服务器二进制现在会在启动时自动执行迁移（见 src/db/migrate.rs），
+# 正常情况下无需手动运行本脚本。保留它是为了：
+#   - 运维 escape hatch：二进制因迁移失败起不来时，手动救库
+#   - CI/CD 中“先迁移再滚动发布”的工作流
+#
+# 本脚本与服务器内置运行器读取相同的 migrations/*.sql 文件，且这些 SQL
+# 都是幂等的（IF NOT EXISTS / IF EXISTS / ON CONFLICT DO NOTHING），
+# 因此两者混用安全。
+#
 set -euo pipefail
 
 # 从 .env 加载环境变量