From f68cd78f8bdbfdcfcbe86252304e1b25f7b79981 Mon Sep 17 00:00:00 2001
From: Zhou Weidong <502333560@qq.com>
Date: Sat, 17 Oct 2026 23:35:31 +0800
Subject: [PATCH] =?UTF-8?q?docs(api):=20=E4=BF=AE=E6=AD=A3=E6=B3=A8?=
 =?UTF-8?q?=E5=86=8C=E9=99=90=E6=B5=81=E9=85=8D=E7=BD=AE=E9=94=AE=E5=90=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/api-phase1.md     |  6 +++---
 docs/plans/PROGRESS.md | 30 ++++++++++++++++++++++++++++++
 2 files changed, 33 insertions(+), 3 deletions(-)

diff --git a/docs/api-phase1.md b/docs/api-phase1.md
index 2e9361b..d66f2ca 100644
--- a/docs/api-phase1.md
+++ b/docs/api-phase1.md
@@ -118,11 +118,11 @@ POST /app/auth/register
 
 频控口径落库在 `app_user.register_ip` / `app_user.register_device_id` 上（按 24h 计数，不新建计数表）。
 
-注册频控阈值存储在 `sys_config`，可在后台「系统设置」修改：
+注册频控阈值存储在 `sys_config`，可在后台「系统配置」修改：
 
 ```text
-fruitshorts.auth.register-max-per-ip-per-day
-fruitshorts.auth.register-max-per-device-per-day
+app.register.max-per-ip-per-day
+app.register.max-per-device-per-day
 ```
 
 键缺失或值不是整数时回退默认 5 / 3；值小于等于 0 表示对应维度不限制。
diff --git a/docs/plans/PROGRESS.md b/docs/plans/PROGRESS.md
index 10c4d8d..13b2881 100644
--- a/docs/plans/PROGRESS.md
+++ b/docs/plans/PROGRESS.md
@@ -3126,6 +3126,36 @@ ReelShortWeb:
 
 设备侧接口结果与后台截图由用户最终验收。
 
+### 32.7 API 文档键名补正
+
+复核 `docs/api-phase1.md` §1.1 时发现文档仍沿用旧的
+`fruitshorts.auth.register-max-*` 键名，与 `AppAuthService` 实际读取的
+`sys_config` 键不一致。已补正为：
+
+```text
+app.register.max-per-ip-per-day
+app.register.max-per-device-per-day
+```
+
+同时将入口表述统一为后台「系统配置」。本次只补正文档，不改运行逻辑。
+
+补正后复核：
+
+```text
+$ mvn test
+AppAuthServiceTest: Tests run: 18, Failures: 0, Errors: 0, Skipped: 0
+BUILD SUCCESS
+```
+
+开发库两键均为 `0`。同一新设备号连续注册 4 次均为 `code=0`：
+
+```text
+uid=UFCIW1LWU
+uid=UP2BH-DN_
+uid=ULOFAAU2Z
+uid=UDAYJR-_E
+```
+
 ---
 
 ## 2026-10-17 iOS 构建阻塞：固定 shared_preferences_foundation 2.5.6