Update ByUserTab commit to reflect real situation

sdcb · sdcb · commit 16fcdb852307 · 2025-11-10T19:21:12.000+08:00
diff --git a/src/FE/components/admin/user-models/ByUserTab.tsx b/src/FE/components/admin/user-models/ByUserTab.tsx
@@ -35,15 +35,18 @@ export default function ByUserTab({ focusUsername, queryParam }: IProps) {
   /**
    * 用户模型数量的状态管理策略：
    * 
-   * 1. 初始加载：从后端API获取准确的userModelCount
-   * 2. 实时更新：UserModelTree组件在添加/删除模型后通过回调更新数量
-   * 3. 优点：
-   *    - 列表加载时就能看到模型数量（无需展开）
-   *    - 分页/搜索性能好
-   *    - UI响应快
-   * 4. 注意：
-   *    - 数量由前端维护，需要确保UserModelTree正确调用回调
-   *    - 如果有其他地方修改用户模型，需要刷新列表或单独更新计数
+   * 1. 初始加载：从后端 API 获取每个用户的模型总数（userModelCount）
+   * 2. 实时更新：UserModelTree 组件在执行模型操作（添加/删除/批量操作）后，
+   *    后端会返回最新的准确总数，通过 onUserModelCountChange 回调同步更新
+   * 3. 数据来源：
+   *    - 所有模型数量都来自后端，前端只负责显示和更新状态
+   *    - 后端在每次操作后重新统计并返回准确的 userModelCount
+   * 4. 优点：
+   *    - 用户列表加载时就能看到模型数量（无需展开树）
+   *    - 数据始终准确，不会出现前端计算误差
+   *    - 支持分页/搜索，性能好
+   * 5. 注意：
+   *    - 如果通过其他途径修改了用户模型（如直接操作数据库），需要刷新列表才能看到最新数量
    */
 
   // 增量更新模型计数（用于单个添加/删除操作）
