docs/29 补第 0 步：转交前先确认对方环境有角色与密码（环境数据不随代码合并）

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