diff --git a/docs/architecture.md b/docs/architecture.md
index c7e9ff3..c570126 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -16,7 +16,7 @@
 | 层 | 选型 |
 |---|---|
 | 后端 | **Rust**（`rust-version 1.86`）+ axum + tokio + rusqlite |
-| 数据库 | **SQLite**（单文件，`data/aitokenpool.db`，迁移 v10） |
+| 数据库 | **SQLite**（单文件，`data/aitokenpool.db`，幂等迁移至 v12，见 `src/db.rs` 的 `SCHEMA_VERSION`） |
 | 加密 | AES-256-GCM（上游 key，`src/crypto.rs`）、argon2（密码哈希） |
 | 上游调用 | reqwest（非流式）+ SSE 流式转发（`src/sse.rs` 跨协议转换） |
 | 前端 | **原生 JS** 静态页（`ui/`，无构建步骤；i18n 中英双语） |
diff --git a/docs/plan-api-matrix.md b/docs/plan-api-matrix.md
index 791e028..25e8ad6 100644
--- a/docs/plan-api-matrix.md
+++ b/docs/plan-api-matrix.md
@@ -32,4 +32,4 @@ Base URL 统一由 AITokenPool 提供（`[server].public_url` 配置），设置
 
 ## 4. 模型目录
 
-当前内置 13 个模型（DeepSeek / GLM / GPT / Claude / Gemini / 豆包 / MiniMax / 通义等），含 context window、vision 支持、缓存价与高峰价字段。模型列表可经管理端「模型管理」页 CRUD（需 admin 角色）。
+当前内置 14 个模型（DeepSeek / GLM / GPT / Claude / Gemini / 豆包 / MiniMax / 通义等），含 context window、vision 支持、缓存价与高峰价字段（数量与明细以 `config/config.example.toml` 的 `[[models]]` 为唯一真源，由 `src/catalog_gate.rs` 的 `MODEL_COUNT` 守卫）。模型列表可经管理端「模型管理」页 CRUD（需 admin 角色）。