Merge branch 'main' of https://github.com/byteGanYue/DocCollab

Author: wenhuilan

packages/doc-docs/public/wzm_picture1.PNG …es/doc-docs/关于训练营/image/wzm_picture1.pngpackages/doc-docs/public/wzm_picture1.PNG renamed to packages/doc-docs/关于训练营/image/wzm_picture1.png packages/doc-docs/public/wzm_picture1.PNG renamed to packages/doc-docs/关于训练营/image/wzm_picture1.png

@@ -300,27 +300,124 @@ const items = [
 *图：构建总结流程图*
 
 #### 1. 我们当前的设计是将文件夹树的构建和文档的分配分离，具体来说： 
-后端只负责构建文件夹的树形结构（通过递归查询文件夹表），前端在拿到文件夹树和文档列表（可能是单独请求的）后，通过`buildFolderDocumentTree`方法将文档分配到对应的文件夹节点（包括根节点） 而另一种常见的做法是：在后端构建树的时候同时查询文档，将文档作为叶子节点直接构建到树中。 
+后端只负责构建文件夹的树形结构（通过递归查询文件夹表），前端在拿到文件夹树和文档列表（单独请求的）后，通过`buildFolderDocumentTree`方法将文档分配到对应的文件夹节点（包括根节点） 而另一种常见的做法是：在后端构建树的时候同时查询文档，将文档作为叶子节点直接构建到树中。 
 #### 2. 当前设计的好处： 
-1. 职责分离，结构清晰：  
+1. *职责分离，结构清晰*：  
 -  文件夹树和文档属于不同的数据类型，分开处理使得逻辑更清晰。   
-- 文件夹树的结构相对稳定（嵌套关系），而文档可能频繁变动（如重命名、移动、删除）。将文档处理放在前端，可以避免每次文件夹结构变动都要重新构建整个树（包括文档）。
-2.  减少后端计算压力：
+-  将文档处理放在前端，可以避免每次文档结构变动都要重新构建整个树（包括文档）。
+2.  *减少后端计算压力*：
 -  如果一起构建，后端需要同时处理文件夹和文档的递归，尤其是在文档数量很大的情况下，构建整个树的开销会很大。 
 - 当前设计下，后端只处理文件夹（通常数量远少于文档），文档的处理放在前端，利用浏览器的计算能力。
-3.  灵活性： 
-- 前端可以独立获取文档列表（例如分页、按条件过滤），然后根据需求动态地分配到文件夹树中。如果文档列表需要更新（比如用户搜索），我们只需要重新运行`buildFolderDocumentTree`方法，而不需要重新请求整个文件夹树。 
+3.  *灵活性*： 
+- 前端可以独立获取文档列表（例如按条件过滤），然后根据需求动态地分配到文件夹树中。如果文档列表需要更新（比如用户搜索），我们只需要重新运行`buildFolderDocumentTree`方法，而不需要重新请求整个文件夹树。 
 -  如果文档和文件夹树一起构建，那么每次文档更新（比如新增一个文档）都需要重新构建整个树并返回，这在文档数量大时效率低下。
-4. 减少数据传输量：
--  假设一个场景：用户只是展开了一个文件夹，需要加载该文件夹下的文档。如果采用分离的方式，我们可以只请求该文件夹下的文档，然后动态添加到已有的树中。而如果一开始就把所有文档都构建在树中，那么初始加载的数据量会非常大。 
-5. 支持懒加载： 
-- 当前设计可以轻松实现文档的懒加载。例如，一开始只加载文件夹树，当用户展开某个文件夹时，再去请求该文件夹下的文档。这样可以显著提高初始加载速度。 
-6. 处理根级文档更灵活：
-- 根级文档（没有父文件夹）在当前的分离设计中，可以通过一个特殊的`ROOT`键来存放，这样在展示时，前端可以自由决定如何展示根级文档（比如在文件夹树的最上方或最下方单独展示）。 
-7. 避免重复数据：
--  在树形结构中，每个节点（文件夹或文档）都需要独立表示。如果文档数量庞大，那么构建的树会非常大。而分离处理允许我们只传输一次文档列表，然后在多个地方引用（例如，在文件夹树中引用文档，在最近文档列表中也可以引用同一份文档数据）。 
-8. 更新效率： 
-- 当文档发生变化（如移动）时，我们只需要更新文档的`parentFolderIds`，然后在前端重新运行`buildFolderDocumentTree`即可，不需要重新构建整个文件夹树。
+4. *支持文档懒加载*： 
+- 当前设计可以轻松实现文档的懒加载。例如，一开始只加载文件夹树，当用户展开某个文件夹时，再去请求该文件夹下的文档，然后动态添加到已有的树中。这样可以显著提高初始加载速度。而如果一开始就把所有文档都构建在树中，那么初始加载的数据量会非常大。  
+
+#### 1.3 生成唯一默认文件名/文件夹名
+
+
+##### 1.3.1 逻辑步骤
+**（1） 收集现有名称**：
+
+- 创建一个 Set 集合 existingNames 存储所有不可重复的名称。
+
+- 添加额外名称：遍历 additionalNames 参数，将非空名称添加到集合中。
+
+- 递归查找目标文件夹
+
+- 处理根目录：若 targetKey === 'root'，直接查找根节点（key='root'）的子项名称。
+
+**（2） 生成唯一名称**：
+
+- 初始化计数器 counter = 1，生成候选名称 candidateName = baseName + counter。
+
+- 循环检查：若 candidateName 在 existingNames 中存在，则 counter++ 并生成新名称。
+
+- 返回结果：直到找到不在集合中的名称，返回最终的 candidateName。
+
+##### 1.3.2 关键代码：
+```javascript
+  /**
+   * 生成唯一的默认文件名/文件夹名，避免同级目录下的重复
+   * @param {string} baseName - 基础名称，如"新建文档"或"新建文件夹"
+   * @param {string} targetKey - 目标文件夹的key
+   * @param {Array} additionalNames - 额外需要检查的名称列表（如后端最新数据）
+   * @returns {string} 唯一的名称
+   */
+  const generateUniqueDefaultName = (
+    baseName,
+    targetKey,
+    additionalNames = [],
+  ) => {
+    // 获取目标文件夹的现有子项
+    const getExistingNames = () => {
+      const existingNames = new Set();
+
+      // 添加额外的名称列表（来自后端的最新数据）
+      additionalNames.forEach(name => {
+        if (name) existingNames.add(name);
+      });
+
+      // 递归查找目标文件夹及其子项
+      const findTargetFolderItems = (nodes, key) => {
+        for (const node of nodes) {
+          if (node.key === key) {
+            // 找到目标文件夹，收集其子项名称
+            if (node.children) {
+              node.children.forEach(child => {
+                const name = child.label?.props?.text || child.label;
+                if (name) {
+                  existingNames.add(name);
+                }
+              });
+            }
+            return true;
+          }
+          if (node.children) {
+            if (findTargetFolderItems(node.children, key)) {
+              return true;
+            }
+          }
+        }
+        return false;
+      };
+
+      // 如果是根目录
+      if (targetKey === 'root') {
+        const rootFolder = folderList.find(item => item.key === 'root');
+        if (rootFolder && rootFolder.children) {
+          rootFolder.children.forEach(child => {
+            const name = child.label?.props?.text || child.label;
+            if (name) {
+              existingNames.add(name);
+            }
+          });
+        }
+      } else {
+        findTargetFolderItems(folderList, targetKey);
+      }
+
+      return existingNames;
+    };
+
+    const existingNames = getExistingNames();
+
+    console.log('现有名称集合:', [...existingNames]);
+
+    // 从1开始尝试生成唯一名称
+    let counter = 1;
+    let candidateName = `${baseName}${counter}`;
+
+    while (existingNames.has(candidateName)) {
+      counter++;
+      candidateName = `${baseName}${counter}`;
+    }
+
+    console.log('生成的唯一名称:', candidateName);
+    return candidateName;
+  };
+```
 
 ## 2. slate中编辑器代码块高亮
 ![image-20250708021052107](./image/image-20250708021052107.png)