From 48513f3b973744a375002cae93ec6d00b314e5fc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=8D=BF=E4=BA=91=E7=A7=8B=E6=9C=88?= <15273589815@163.com>
Date: Fri, 11 Sep 2026 20:50:59 +0800
Subject: [PATCH] =?UTF-8?q?docs/29=20=E8=A1=A5=E7=AC=AC=200=20=E6=AD=A5?=
 =?UTF-8?q?=EF=BC=9A=E8=BD=AC=E4=BA=A4=E5=89=8D=E5=85=88=E7=A1=AE=E8=AE=A4?=
 =?UTF-8?q?=E5=AF=B9=E6=96=B9=E7=8E=AF=E5=A2=83=E6=9C=89=E8=A7=92=E8=89=B2?=
 =?UTF-8?q?=E4=B8=8E=E5=AF=86=E7=A0=81=EF=BC=88=E7=8E=AF=E5=A2=83=E6=95=B0?=
 =?UTF-8?q?=E6=8D=AE=E4=B8=8D=E9=9A=8F=E4=BB=A3=E7=A0=81=E5=90=88=E5=B9=B6?=
 =?UTF-8?q?=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/29-Agent组员登录接口使用说明.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/docs/29-Agent组员登录接口使用说明.md b/docs/29-Agent组员登录接口使用说明.md
index 11a6db1..c44b8e2 100644
--- a/docs/29-Agent组员登录接口使用说明.md
+++ b/docs/29-Agent组员登录接口使用说明.md
@@ -96,6 +96,32 @@ Content-Type: application/json
 
 ## 4. 怎么加一个测试人员
 
+### ⚠️ 第 0 步：先确认**你们自己那台**有角色和密码
+
+**环境数据不随代码合并**——`config_release`、`sys_role`、`sys_user` 都是各环境自己的。
+换句话说：**别人机器上能登录的账号，你们那台不一定有**。先跑这两条（都幂等，可重复执行）：
+
+```powershell
+python tools/seed_test_rbac.py      # 建三个角色（customer/risk_operator/admin）与它们的权限
+python tools/set_user_password.py   # 给 9001/9002/9003 设演示密码
+```
+
+然后确认角色确实绑上了（最后一列不该是"(无角色)"）：
+
+```powershell
+python tools/create_test_user.py --list
+```
+
+```
+id      username          user_type   status  roles          密码
+9001    cust_t            customer    正常    customer       已设
+9002    risk_t            employee    正常    risk_operator  已设
+9003    admin_t           employee    正常    admin          已设
+```
+
+`create_test_user.py` 也会替你检查：如果 `sys_role` 里没有对应角色，它会直接告诉你
+"先跑 tools/seed_test_rbac.py"，而不是建出一个登不进任何地方的账号。
+
 ### 一条命令
 
 ```powershell