refactor(service): paginate blacklist checks to reduce server load

- Replace bulk blacklist check with paginated requests of 100 documents each
- Implement private method checkBlacklistPaged to handle pagination logic
- Add debug logs to indicate blacklist checking progress
- Update usage in multiple places to call paginated blacklist check method
- Extend testing checklist with scenarios for server protection via pagination
- Verify request batching and progress logging in challenge scenarios

Author: terwer

TESTING_CHECKLIST.md

@@ -346,7 +346,75 @@
 
 ---
 
-## 8. 综合压力测试
+## 9. 服务端分页保护测试
+
+### 目标
+验证大量文档操作时，客户端会自动分页请求，避免给服务端造成压力
+
+### 9.1 黑名单检查分页
+
+#### 测试步骤
+1. **准备数据**
+   - [ ] 准备 300 个测试文档
+   - [ ] 设置部分文档在黑名单中
+
+2. **执行检测**
+   - [ ] 打开增量分享界面
+   - [ ] 观察浏览器 Network 面板
+
+3. **验证点**
+   - [ ] 黑名单检查请求分批发送（每批最多 100 个文档 ID）
+   - [ ] 控制台显示检查进度日志
+   - [ ] 所有文档最终都被正确检查
+
+4. **预期输出**
+   ```
+   [incremental-share-service] 黑名单检查进度: 100/300
+   [incremental-share-service] 黑名单检查进度: 200/300
+   [incremental-share-service] 黑名单检查进度: 300/300
+   ```
+
+### 9.2 分享历史获取分页
+
+#### 测试步骤
+1. **准备数据**
+   - [ ] 服务端已有 500+ 条分享历史记录
+
+2. **执行检测**
+   - [ ] 打开增量分享界面
+   - [ ] 观察 Network 面板的 listDoc 请求
+
+3. **验证点**
+   - [ ] listDoc 请求自动分页（每页 100 条）
+   - [ ] 自动获取所有分页直到 hasMore 为 false
+   - [ ] 控制台显示"获取分享历史完成，共 XXX 条记录"
+   - [ ] 有安全检查，最多查询 100 页（防止无限循环）
+
+4. **查看请求**
+   - Network 面板应该看到多个 listDoc 请求：
+   ```
+   POST /api/share/listDoc  {pageNum: 0, pageSize: 100}
+   POST /api/share/listDoc  {pageNum: 1, pageSize: 100}
+   POST /api/share/listDoc  {pageNum: 2, pageSize: 100}
+   ...
+   ```
+
+### 9.3 服务端压力测试
+
+#### 测试步骤
+1. **极限场景**
+   - [ ] 1000 个文档同时进行变更检测
+   - [ ] 观察服务端负载
+
+2. **验证点**
+   - [ ] 黑名单检查分 10 次请求（每次 100 个）
+   - [ ] 分享历史自动分页获取
+   - [ ] 服务端不会因为单次请求过大而报错或超时
+   - [ ] 整体检测时间在可接受范围内（< 10秒）
+
+---
+
+## 10. 综合压力测试
 
 ### 测试场景
 模拟真实使用场景，测试所有功能的协同工作

src/service/IncrementalShareService.ts

@@ -249,7 +249,9 @@ export class IncrementalShareService {
 
     try {
       const docIds = allDocuments.map((doc) => doc.docId)
-      const blacklistStatus = await this.blacklistService.areInBlacklist(docIds)
+      
+      // 分页检查黑名单，避免一次性查询过多文档给服务端造成压力
+      const blacklistStatus = await this.checkBlacklistPaged(docIds)
 
       const allHistory = await this.getAllShareHistory()
 
@@ -314,7 +316,9 @@ export class IncrementalShareService {
 
     try {
       const docIds = documents.map((doc) => doc.docId)
-      const blacklistStatus = await this.blacklistService.areInBlacklist(docIds)
+      
+      // 分页检查黑名单，避免一次性查询过多文档给服务端造成压力
+      const blacklistStatus = await this.checkBlacklistPaged(docIds)
       const validDocs: Array<{ docId: string; docTitle: string }> = []
 
       for (const doc of documents) {
@@ -379,6 +383,27 @@ export class IncrementalShareService {
     return result
   }
 
+  /**
+   * 分页检查黑名单（避免一次性查询过多文档）
+   * @param docIds 文档ID列表
+   * @returns 黑名单状态映射
+   */
+  private async checkBlacklistPaged(docIds: string[]): Promise<Record<string, boolean>> {
+    const PAGE_SIZE = 100 // 每页检查 100 个文档
+    const result: Record<string, boolean> = {}
+
+    // 分页处理
+    for (let i = 0; i < docIds.length; i += PAGE_SIZE) {
+      const pageDocIds = docIds.slice(i, i + PAGE_SIZE)
+      const pageResult = await this.blacklistService.areInBlacklist(pageDocIds)
+      Object.assign(result, pageResult)
+      
+      this.logger.debug(`黑名单检查进度: ${Math.min(i + PAGE_SIZE, docIds.length)}/${docIds.length}`)
+    }
+
+    return result
+  }
+
   /**
    * 更新最后分享时间
    */