@f2a/openclaw-f2a 0.3.0 → 0.3.3

package/dist/contact-manager.js

@@ -5,6 +5,13 @@
  * 管理通讯录、分组、标签和握手请求
  * 支持持久化存储和导入/导出功能
  *
+ * ⚠️ 并发安全说明
+ *
+ * ContactManager 不是线程安全的。在 Node.js 单线程事件循环环境下，
+ * 只要避免在同一个事件循环 tick 内发起多个修改操作，就是安全的。
+ *
+ * 如果需要在多进程/集群环境下使用，请使用外部锁服务（如 Redis）。
+ *
  * @module contact-manager
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -19,6 +26,14 @@ const contact_types_js_1 = require("./contact-types.js");
 const CONTACTS_DATA_VERSION = 1;
 /** 默认数据文件名 */
 const DEFAULT_CONTACTS_FILE = 'contacts.json';
+/** P1-4 修复：最大联系人数量限制 */
+const MAX_CONTACTS = 10000;
+/** P1-4 修复：导入数据最大大小（字节） */
+const MAX_IMPORT_SIZE = 10 * 1024 * 1024; // 10MB
+/** P2-1 修复：PeerID 格式正则（libp2p 格式：12D3KooW...） */
+const PEER_ID_REGEX = /^12D3KooW[A-Za-z0-9]{44}$/;
+/** P2-1 修复：名称最大长度 */
+const MAX_NAME_LENGTH = 100;
 /** 默认分组 */
 const DEFAULT_GROUPS = [
     {
@@ -33,15 +48,39 @@ const DEFAULT_GROUPS = [
 // 工具函数
 // ============================================================================
 /**
- * 生成唯一 ID
+ * 生成唯一 ID（UUID v4 格式）
+ * P2-1 修复：使用加密安全的随机数生成器
  */
 function generateId() {
-    return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 11)}`;
+    // 使用 crypto.randomUUID() 如果可用，否则回退到自定义实现
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // 回退实现：基于时间戳 + 随机数 + 计数器
+    const timestamp = Date.now().toString(36);
+    const randomPart = Math.random().toString(36).slice(2, 11);
+    const counter = (generateId.counter = (generateId.counter || 0) + 1);
+    return `${timestamp}-${randomPart}-${counter.toString(36)}`;
 }
+// 静态计数器
+(function (generateId) {
+    generateId.counter = 0;
+})(generateId || (generateId = {}));
 /**
  * 深拷贝对象
+ * P1-1 修复：使用 structuredClone 支持更多类型
  */
 function deepClone(obj) {
+    // 优先使用 structuredClone（支持 Date、Map、Set 等）
+    if (typeof structuredClone === 'function') {
+        try {
+            return structuredClone(obj);
+        }
+        catch {
+            // 回退到 JSON 方法
+        }
+    }
+    // 回退：JSON 序列化（不支持 Date、undefined、循环引用）
     return JSON.parse(JSON.stringify(obj));
 }
 // ============================================================================
@@ -82,6 +121,61 @@ class ContactManager {
     logger;
     eventHandlers = new Set();
     autoSave = true;
+    /**
+     * P2-1 修复：验证 PeerID 格式
+     * libp2p 格式：12D3KooW + 44 个 base58 字符
+     */
+    validatePeerId(peerId) {
+        return PEER_ID_REGEX.test(peerId);
+    }
+    /**
+     * P2-1 修复：验证名称
+     * 限制长度，防止过长的名称
+     */
+    validateName(name) {
+        return typeof name === 'string' && name.length > 0 && name.length <= MAX_NAME_LENGTH;
+    }
+    /**
+     * P1-3 修复：验证联系人字段完整性
+     * 用于导入数据验证
+     */
+    validateContactFields(contact) {
+        if (!contact || typeof contact !== 'object')
+            return false;
+        const c = contact;
+        // 必须字段
+        if (typeof c.id !== 'string' || c.id.length === 0)
+            return false;
+        if (typeof c.name !== 'string' || !this.validateName(c.name))
+            return false;
+        if (typeof c.peerId !== 'string' || c.peerId.length === 0)
+            return false;
+        // 可选字段类型检查
+        if (c.agentId !== undefined && typeof c.agentId !== 'string')
+            return false;
+        if (c.status !== undefined && typeof c.status !== 'string')
+            return false;
+        if (c.reputation !== undefined && typeof c.reputation !== 'number')
+            return false;
+        if (c.notes !== undefined && typeof c.notes !== 'string')
+            return false;
+        if (c.createdAt !== undefined && typeof c.createdAt !== 'number')
+            return false;
+        if (c.updatedAt !== undefined && typeof c.updatedAt !== 'number')
+            return false;
+        if (c.lastCommunicationTime !== undefined && typeof c.lastCommunicationTime !== 'number')
+            return false;
+        // 数组字段检查
+        if (c.capabilities !== undefined && !Array.isArray(c.capabilities))
+            return false;
+        if (c.groups !== undefined && !Array.isArray(c.groups))
+            return false;
+        if (c.tags !== undefined && !Array.isArray(c.tags))
+            return false;
+        if (c.multiaddrs !== undefined && !Array.isArray(c.multiaddrs))
+            return false;
+        return true;
+    }
     /**
      * 创建联系人管理器
      *
@@ -90,13 +184,31 @@ class ContactManager {
      * @param options - 配置选项
      */
     constructor(dataDir, logger, options) {
-        this.dataDir = dataDir;
+        // P1-3 修复：验证 dataDir，防止路径遍历攻击
+        if (!dataDir || typeof dataDir !== 'string') {
+            throw new Error('[ContactManager] dataDir 必须是非空字符串');
+        }
+        // P1-3 修复：使用 path.resolve 和 path.normalize 规范化路径
+        // 解析为绝对路径，消除 .. 和 . 符号
+        const normalizedDataDir = (0, path_1.resolve)((0, path_1.normalize)(dataDir));
+        // 检查规范化后的路径是否仍在预期范围内
+        // 如果路径包含 ..，规范化后应该被消除
+        // 如果结果路径与原始路径差异过大，可能存在问题
+        const originalNormalized = (0, path_1.normalize)(dataDir);
+        if (originalNormalized !== normalizedDataDir && !dataDir.startsWith('/')) {
+            logger?.warn(`[ContactManager] 路径被规范化: ${dataDir} -> ${normalizedDataDir}`);
+        }
+        // 检查路径遍历（规范化后的路径不应包含 ..）
+        if (normalizedDataDir.includes('..')) {
+            throw new Error('[ContactManager] dataDir 路径无效（路径遍历风险）');
+        }
+        this.dataDir = normalizedDataDir;
         this.logger = logger;
         this.autoSave = options?.autoSave ?? true;
-        this.dataPath = (0, path_1.join)(dataDir, DEFAULT_CONTACTS_FILE);
+        this.dataPath = (0, path_1.join)(normalizedDataDir, DEFAULT_CONTACTS_FILE);
         // 确保目录存在
-        if (!(0, fs_1.existsSync)(dataDir)) {
-            (0, fs_1.mkdirSync)(dataDir, { recursive: true });
+        if (!(0, fs_1.existsSync)(normalizedDataDir)) {
+            (0, fs_1.mkdirSync)(normalizedDataDir, { recursive: true });
         }
         // 加载或初始化数据
         this.data = this.loadData();
@@ -157,17 +269,21 @@ class ContactManager {
     }
     /**
      * 保存数据
+     * P1-2 修复：返回保存结果，不再静默忽略错误
+     * @returns 是否保存成功
      */
     saveData() {
         if (!this.autoSave)
-            return;
+            return true;
         try {
             this.data.lastUpdated = Date.now();
             const content = JSON.stringify(this.data, null, 2);
             (0, fs_1.writeFileSync)(this.dataPath, content, 'utf-8');
+            return true;
         }
         catch (err) {
             this.logger?.error(`[ContactManager] 保存数据失败: ${err}`);
+            return false;
         }
     }
     /**
@@ -181,11 +297,28 @@ class ContactManager {
     // ============================================================================
     /**
      * 添加联系人
+     * P2-1 修复：添加输入验证
+     * P1 修复：支持传入 status 参数
      *
      * @param params - 创建参数
-     * @returns 新创建的联系人
+     * @returns 新创建的联系人，如果保存失败返回 null
      */
     addContact(params) {
+        // P2-1 修复：验证输入
+        if (!this.validateName(params.name)) {
+            this.logger?.error('[ContactManager] 添加联系人失败：名称无效或过长');
+            return null;
+        }
+        // P1-4 修复：PeerID 验证失败时拒绝添加联系人
+        if (!this.validatePeerId(params.peerId)) {
+            this.logger?.error(`[ContactManager] 添加联系人失败：PeerID 格式无效: ${params.peerId.slice(0, 16)}...`);
+            return null;
+        }
+        // P1-1 修复：检查联系人数量限制
+        if (this.data.contacts.length >= MAX_CONTACTS) {
+            this.logger?.error(`[ContactManager] 联系人数量已达上限 (${MAX_CONTACTS})`);
+            return null;
+        }
         const now = Date.now();
         // 检查是否已存在
         const existing = this.getContactByPeerId(params.peerId);
@@ -198,7 +331,7 @@ class ContactManager {
             name: params.name,
             peerId: params.peerId,
             agentId: params.agentId,
-            status: contact_types_js_1.FriendStatus.STRANGER,
+            status: params.status ?? contact_types_js_1.FriendStatus.STRANGER, // P1 修复：支持传入 status，默认为 STRANGER
             capabilities: params.capabilities || [],
             reputation: params.reputation ?? 0,
             groups: params.groups || ['default'],
@@ -211,17 +344,24 @@ class ContactManager {
             metadata: params.metadata,
         };
         this.data.contacts.push(contact);
-        this.saveData();
+        // P1-2 修复：检查保存结果
+        if (!this.saveData()) {
+            // 保存失败，回滚
+            this.data.contacts.pop();
+            this.logger?.error('[ContactManager] 添加联系人失败：数据保存失败');
+            return null;
+        }
         this.emitEvent('contact:added', contact);
         this.logger?.info(`[ContactManager] 添加联系人: ${contact.name} (${contact.peerId.slice(0, 16)})`);
         return contact;
     }
     /**
      * 更新联系人
+     * P2-1 修复：添加输入验证
      *
      * @param contactId - 联系人 ID
      * @param params - 更新参数
-     * @returns 更新后的联系人，如果不存在返回 null
+     * @returns 更新后的联系人，如果不存在或保存失败返回 null
      */
     updateContact(contactId, params) {
         const index = this.data.contacts.findIndex(c => c.id === contactId);
@@ -229,6 +369,12 @@ class ContactManager {
             return null;
         }
         const contact = this.data.contacts[index];
+        const originalContact = deepClone(contact); // P1 修复：使用深拷贝备份用于回滚
+        // P2-1 修复：验证名称
+        if (params.name !== undefined && !this.validateName(params.name)) {
+            this.logger?.error('[ContactManager] 更新联系人失败：名称无效或过长');
+            return null;
+        }
         // 应用更新
         if (params.name !== undefined)
             contact.name = params.name;
@@ -253,12 +399,19 @@ class ContactManager {
         }
         contact.updatedAt = Date.now();
         this.data.contacts[index] = contact;
-        this.saveData();
+        // P1-2 修复：检查保存结果
+        if (!this.saveData()) {
+            // 保存失败，回滚
+            this.data.contacts[index] = originalContact;
+            this.logger?.error('[ContactManager] 更新联系人失败：数据保存失败');
+            return null;
+        }
         this.emitEvent('contact:updated', contact);
         return contact;
     }
     /**
      * 删除联系人
+     * P1-2 修复：添加保存检查和回滚
      *
      * @param contactId - 联系人 ID
      * @returns 是否删除成功
@@ -269,7 +422,13 @@ class ContactManager {
             return false;
         }
         const [removed] = this.data.contacts.splice(index, 1);
-        this.saveData();
+        // P1-2 修复：检查保存结果，失败时恢复联系人
+        if (!this.saveData()) {
+            // 保存失败，恢复联系人
+            this.data.contacts.splice(index, 0, removed);
+            this.logger?.error('[ContactManager] 删除联系人失败：数据保存失败');
+            return false;
+        }
         this.emitEvent('contact:removed', removed);
         this.logger?.info(`[ContactManager] 删除联系人: ${removed.name} (${removed.peerId.slice(0, 16)})`);
         return true;
@@ -392,6 +551,7 @@ class ContactManager {
     // ============================================================================
     /**
      * 创建分组
+     * P1-2 修复：添加保存检查和回滚
      */
     createGroup(params) {
         const now = Date.now();
@@ -404,18 +564,27 @@ class ContactManager {
             updatedAt: now,
         };
         this.data.groups.push(group);
-        this.saveData();
+        // P1-2 修复：检查保存结果，失败时恢复
+        if (!this.saveData()) {
+            // 保存失败，回滚
+            this.data.groups.pop();
+            this.logger?.error('[ContactManager] 创建分组失败：数据保存失败');
+            return null;
+        }
         this.emitEvent('group:created', group);
         return group;
     }
     /**
      * 更新分组
+     * P1-2 修复：添加保存检查和回滚
      */
     updateGroup(groupId, params) {
         const group = this.data.groups.find(g => g.id === groupId);
         if (!group) {
             return null;
         }
+        // 备份原始数据用于回滚
+        const originalGroup = { ...group };
         if (params.name !== undefined)
             group.name = params.name;
         if (params.description !== undefined)
@@ -423,12 +592,19 @@ class ContactManager {
         if (params.color !== undefined)
             group.color = params.color;
         group.updatedAt = Date.now();
-        this.saveData();
+        // P1-2 修复：检查保存结果，失败时恢复
+        if (!this.saveData()) {
+            // 保存失败，回滚
+            Object.assign(group, originalGroup);
+            this.logger?.error('[ContactManager] 更新分组失败：数据保存失败');
+            return null;
+        }
         this.emitEvent('group:updated', group);
         return group;
     }
     /**
      * 删除分组
+     * P1-2 修复：添加保存检查和回滚
      */
     deleteGroup(groupId) {
         // 不允许删除默认分组
@@ -440,6 +616,10 @@ class ContactManager {
         if (index === -1) {
             return false;
         }
+        // 备份受影响的联系人分组信息用于回滚
+        const affectedContacts = this.data.contacts
+            .filter(c => c.groups.includes(groupId))
+            .map(c => ({ contact: c, originalGroups: [...c.groups] }));
         // 将该分组下的联系人移到默认分组
         for (const contact of this.data.contacts) {
             const groupIndex = contact.groups.indexOf(groupId);
@@ -451,7 +631,16 @@ class ContactManager {
             }
         }
         const [removed] = this.data.groups.splice(index, 1);
-        this.saveData();
+        // P1-2 修复：检查保存结果，失败时恢复
+        if (!this.saveData()) {
+            // 保存失败，回滚
+            this.data.groups.splice(index, 0, removed);
+            for (const { contact, originalGroups } of affectedContacts) {
+                contact.groups = originalGroups;
+            }
+            this.logger?.error('[ContactManager] 删除分组失败：数据保存失败');
+            return false;
+        }
         this.emitEvent('group:deleted', removed);
         return true;
     }
@@ -565,11 +754,14 @@ class ContactManager {
     }
     /**
      * 接受握手请求
+     * P1-2 修复：在移除 pendingHandshakes 前检查 saveData
      *
      * 这会：
      * 1. 将请求方添加为好友
-     * 2. 从待处理列表中移除
+     * 2. 从待处理列表中移除（仅在保存成功后）
      * 3. 触发事件
+     *
+     * @returns 包含响应和对方 Peer ID 的对象，或 null
      */
     acceptHandshake(requestId, myName, myCapabilities) {
         const index = this.data.pendingHandshakes.findIndex(p => p.requestId === requestId);
@@ -581,26 +773,49 @@ class ContactManager {
         let contact = this.getContactByPeerId(pending.from);
         if (contact) {
             // 更新现有联系人
-            this.updateContact(contact.id, {
+            const updated = this.updateContact(contact.id, {
                 status: contact_types_js_1.FriendStatus.FRIEND,
                 capabilities: pending.capabilities,
                 name: pending.fromName,
                 updateLastCommunication: true,
             });
+            // P1-2 修复：检查更新是否成功
+            if (!updated) {
+                this.logger?.error('[ContactManager] 接受握手失败：更新联系人失败');
+                return null;
+            }
+            contact = updated;
         }
         else {
-            // 创建新联系人
+            // P1 修复：创建新联系人时直接设置 status 为 FRIEND，避免状态不一致
             contact = this.addContact({
                 name: pending.fromName,
                 peerId: pending.from,
                 capabilities: pending.capabilities,
                 groups: ['default'],
+                status: contact_types_js_1.FriendStatus.FRIEND, // 直接设置为好友
             });
-            this.updateContact(contact.id, { status: contact_types_js_1.FriendStatus.FRIEND });
+            // 检查添加是否成功
+            if (!contact) {
+                this.logger?.error('[ContactManager] 接受握手失败：添加联系人失败');
+                return null;
+            }
+            // 不再需要额外调用 updateContact 设置状态
+        }
+        // P1-2 修复：先保存数据，成功后再移除待处理请求
+        // 这样如果保存失败，待处理请求仍然存在，可以重试
+        if (!this.saveData()) {
+            this.logger?.error('[ContactManager] 接受握手失败：保存数据失败');
+            // 不移除 pendingHandshakes，允许重试
+            return null;
         }
-        // 移除待处理请求
+        // 保存成功，移除待处理请求
         this.data.pendingHandshakes.splice(index, 1);
-        this.saveData();
+        // 再次保存以记录 pendingHandshakes 的移除
+        if (!this.saveData()) {
+            this.logger?.warn('[ContactManager] 移除待处理请求后保存失败，但好友已添加');
+            // 继续执行，因为好友已经添加成功
+        }
         const response = {
             requestId,
             from: '', // 调用方填充
@@ -610,18 +825,32 @@ class ContactManager {
             timestamp: Date.now(),
         };
         this.emitEvent('handshake:accepted', { pending, response });
-        return response;
+        return { response, fromPeerId: pending.from };
     }
     /**
      * 拒绝握手请求
+     * P1-2 修复：在移除 pendingHandshakes 前检查 saveData
+     *
+     * @returns 包含响应和对方 Peer ID 的对象，或 null
      */
     rejectHandshake(requestId, reason) {
         const index = this.data.pendingHandshakes.findIndex(p => p.requestId === requestId);
         if (index === -1) {
             return null;
         }
-        const [pending] = this.data.pendingHandshakes.splice(index, 1);
-        this.saveData();
+        const pending = this.data.pendingHandshakes[index];
+        // P1-2 修复：先保存数据，确保状态持久化
+        if (!this.saveData()) {
+            this.logger?.error('[ContactManager] 拒绝握手失败：保存数据失败');
+            return null;
+        }
+        // 保存成功后，移除待处理请求
+        this.data.pendingHandshakes.splice(index, 1);
+        // 再次保存以记录 pendingHandshakes 的移除
+        if (!this.saveData()) {
+            this.logger?.warn('[ContactManager] 移除待处理请求后保存失败');
+            // 继续执行，因为主要操作已完成
+        }
         const response = {
             requestId,
             from: '', // 调用方填充
@@ -630,10 +859,11 @@ class ContactManager {
             reason,
         };
         this.emitEvent('handshake:rejected', { pending, response });
-        return response;
+        return { response, fromPeerId: pending.from };
     }
     /**
      * 处理收到的握手响应
+     * P1 修复：添加 PeerID 验证，优化状态设置
      *
      * 当对方接受我们的好友请求时调用
      */
@@ -642,24 +872,39 @@ class ContactManager {
             this.logger?.info(`[ContactManager] 好友请求被拒绝: ${response.reason || '无原因'}`);
             return false;
         }
+        // P1 修复：验证 PeerID 格式
+        if (!this.validatePeerId(response.from)) {
+            this.logger?.warn(`[ContactManager] 无效的 PeerID 格式: ${response.from.slice(0, 16)}...`);
+            return false;
+        }
         // 添加为好友
         let contact = this.getContactByPeerId(response.from);
         if (contact) {
-            this.updateContact(contact.id, {
+            const updated = this.updateContact(contact.id, {
                 status: contact_types_js_1.FriendStatus.FRIEND,
                 name: response.fromName || contact.name,
                 capabilities: response.capabilities,
                 updateLastCommunication: true,
             });
+            if (!updated) {
+                this.logger?.error('[ContactManager] 处理握手响应失败：更新联系人失败');
+                return false;
+            }
+            contact = updated;
         }
         else {
+            // P1 修复：创建新联系人时直接设置 status 为 FRIEND
             contact = this.addContact({
                 name: response.fromName || 'Unknown',
                 peerId: response.from,
                 capabilities: response.capabilities || [],
                 groups: ['default'],
+                status: contact_types_js_1.FriendStatus.FRIEND, // 直接设置为好友
             });
-            this.updateContact(contact.id, { status: contact_types_js_1.FriendStatus.FRIEND });
+            if (!contact) {
+                this.logger?.error('[ContactManager] 处理握手响应失败：添加联系人失败');
+                return false;
+            }
         }
         this.logger?.info(`[ContactManager] 好友请求已接受: ${contact.name}`);
         return true;
@@ -669,33 +914,63 @@ class ContactManager {
     // ============================================================================
     /**
      * 拉黑联系人
+     * P1-2 修复：添加保存检查和回滚
      */
     blockContact(contactId) {
         const contact = this.getContact(contactId);
         if (!contact)
             return false;
+        // 备份原始状态用于回滚
+        const originalStatus = contact.status;
+        const wasBlocked = this.data.blockedPeers.includes(contact.peerId);
         contact.status = contact_types_js_1.FriendStatus.BLOCKED;
         contact.updatedAt = Date.now();
         if (!this.data.blockedPeers.includes(contact.peerId)) {
             this.data.blockedPeers.push(contact.peerId);
         }
-        this.saveData();
+        // P1-2 修复：检查保存结果，失败时恢复
+        if (!this.saveData()) {
+            // 保存失败，回滚
+            contact.status = originalStatus;
+            contact.updatedAt = Date.now();
+            if (!wasBlocked) {
+                const index = this.data.blockedPeers.indexOf(contact.peerId);
+                if (index !== -1) {
+                    this.data.blockedPeers.splice(index, 1);
+                }
+            }
+            this.logger?.error('[ContactManager] 拉黑联系人失败：数据保存失败');
+            return false;
+        }
         return true;
     }
     /**
      * 解除拉黑
+     * P1-2 修复：添加保存检查和回滚
      */
     unblockContact(contactId) {
         const contact = this.getContact(contactId);
         if (!contact)
             return false;
+        // 备份原始状态用于回滚
+        const originalStatus = contact.status;
+        const blockedIndex = this.data.blockedPeers.indexOf(contact.peerId);
         contact.status = contact_types_js_1.FriendStatus.STRANGER;
         contact.updatedAt = Date.now();
-        const index = this.data.blockedPeers.indexOf(contact.peerId);
-        if (index !== -1) {
-            this.data.blockedPeers.splice(index, 1);
+        if (blockedIndex !== -1) {
+            this.data.blockedPeers.splice(blockedIndex, 1);
+        }
+        // P1-2 修复：检查保存结果，失败时恢复
+        if (!this.saveData()) {
+            // 保存失败，回滚
+            contact.status = originalStatus;
+            contact.updatedAt = Date.now();
+            if (blockedIndex !== -1) {
+                this.data.blockedPeers.splice(blockedIndex, 0, contact.peerId);
+            }
+            this.logger?.error('[ContactManager] 解除拉黑失败：数据保存失败');
+            return false;
         }
-        this.saveData();
         return true;
     }
     /**
@@ -741,6 +1016,8 @@ class ContactManager {
     }
     /**
      * 导入通讯录
+     * P1-4 修复：添加数据大小和联系人数量限制
+     * P1-3 修复：验证每个联系人的字段
      *
      * @param data - 导入的数据
      * @param merge - 是否合并（true）或覆盖（false）
@@ -754,23 +1031,60 @@ class ContactManager {
             errors: [],
         };
         try {
+            // P1-4 修复：检查数据大小
+            const dataSize = JSON.stringify(data).length;
+            if (dataSize > MAX_IMPORT_SIZE) {
+                result.success = false;
+                result.errors.push(`数据大小超出限制: ${dataSize} > ${MAX_IMPORT_SIZE} 字节`);
+                return result;
+            }
+            // P1-4 修复：检查联系人数量
+            if (data.contacts && data.contacts.length > MAX_CONTACTS) {
+                result.success = false;
+                result.errors.push(`联系人数量超出限制: ${data.contacts.length} > ${MAX_CONTACTS}`);
+                return result;
+            }
             if (!merge) {
+                // P1-3 修复：覆盖模式也要验证数据结构
+                const validContacts = [];
+                for (let i = 0; i < data.contacts.length; i++) {
+                    if (this.validateContactFields(data.contacts[i])) {
+                        validContacts.push(data.contacts[i]);
+                    }
+                    else {
+                        result.errors.push(`联系人 #${i + 1} 字段验证失败，已跳过`);
+                        result.skippedContacts++;
+                    }
+                }
                 // 覆盖模式
                 this.data = {
                     version: CONTACTS_DATA_VERSION,
-                    contacts: data.contacts,
+                    contacts: validContacts,
                     groups: data.groups.length ? data.groups : deepClone(DEFAULT_GROUPS),
                     pendingHandshakes: data.pendingHandshakes || [],
                     blockedPeers: data.blockedPeers || [],
                     lastUpdated: Date.now(),
                 };
-                result.importedContacts = data.contacts.length;
+                result.importedContacts = validContacts.length;
                 result.importedGroups = data.groups.length;
             }
             else {
                 // 合并模式
                 const existingPeerIds = new Set(this.data.contacts.map(c => c.peerId));
-                for (const contact of data.contacts) {
+                // P1-4 修复：检查合并后的总数（使用验证后的有效联系人）
+                const validContacts = data.contacts.filter(c => this.validateContactFields(c));
+                const invalidCount = data.contacts.length - validContacts.length;
+                if (invalidCount > 0) {
+                    result.errors.push(`${invalidCount} 个联系人字段验证失败，已跳过`);
+                    result.skippedContacts += invalidCount;
+                }
+                const totalAfterMerge = this.data.contacts.length + validContacts.filter(c => !existingPeerIds.has(c.peerId)).length;
+                if (totalAfterMerge > MAX_CONTACTS) {
+                    result.success = false;
+                    result.errors.push(`合并后联系人数量超出限制: ${totalAfterMerge} > ${MAX_CONTACTS}`);
+                    return result;
+                }
+                for (const contact of validContacts) {
                     if (existingPeerIds.has(contact.peerId)) {
                         result.skippedContacts++;
                     }