foliko 1.1.35 → 1.1.36

package/.claude/settings.local.json

@@ -203,7 +203,10 @@
       "Bash(node -e \"\nconst poster = require\\('/d/code/foliko-plugins/poster-plugin'\\);\nconsole.log\\('poster.tools:', typeof poster.tools\\);\nconsole.log\\('poster.tools keys:', Object.keys\\(poster.tools || {}\\).slice\\(0, 5\\)\\);\n\" 2>&1)",
       "Bash(node -e \"require\\('./src/core/agent-chat.js'\\); console.log\\('OK'\\)\" 2>&1)",
       "Bash(node -e \"const ai = require\\('ai'\\); console.log\\('tool type:', typeof ai.tool\\)\")",
-      "mcp__MiniMax__web_search"
+      "mcp__MiniMax__web_search",
+      "Bash(npm test:*)",
+      "Bash(node -e \"require\\('./src/index.js'\\); console.log\\('Module loaded successfully'\\)\")",
+      "Bash(node examples/basic.js 2>&1)"
     ]
   }
 }

package/cli/src/ui/chat-ui.js

@@ -95,7 +95,7 @@ class ChatUI {
   printWelcome() {
     console.log(`${colored('Foliko', CYAN)} - 持续对话聊天`);
     console.log(
-      `${colored('Ctrl+C', DIM)} 退出 | ${colored('连续两次回车', DIM)} 发送多行 | ${colored('!!', DIM)} 立即发送\n`
+      `${colored('Ctrl+C', DIM)} 退出 | ${colored('/clean', DIM)} 清除上下文 | ${colored('连续两次回车', DIM)} 发送多行 | ${colored('!!', DIM)} 立即发送\n`
     );
   }
 
@@ -152,6 +152,34 @@ class ChatUI {
         return;
       }
 
+      // 清除上下文命令
+      if (input.toLowerCase() === '/clean' || input.toLowerCase() === '/clear') {
+        const { sessionId } = this;
+        // 清除 AgentChatHandler 的消息存储（需要传 sessionId）
+        if (this.agent._chatHandler) {
+          this.agent._chatHandler.clearHistory(sessionId);
+        }
+        // 清除 SessionContext 的消息和压缩计数
+        if (this.agent.framework) {
+          const sessionCtx = this.agent.framework.getSessionContext(sessionId);
+          if (sessionCtx) {
+            sessionCtx.clearMessages();
+            sessionCtx.compressionState.count = 0;
+            sessionCtx.metadata.compressionCount = 0;
+          }
+          // 同步清除 framework 缓存的 sessionContexts
+          const cachedCtx = this.agent.framework._sessionContexts?.get(sessionId);
+          if (cachedCtx) {
+            cachedCtx.clearMessages();
+            cachedCtx.compressionState.count = 0;
+            cachedCtx.metadata.compressionCount = 0;
+          }
+        }
+        console.log(`${colored('[提示]', CYAN)} 对话上下文已清除\n`);
+        await this.promptUser();
+        return;
+      }
+
       // 发送消息
       await this.sendMessage(input);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.1.35",
+  "version": "1.1.36",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "type": "commonjs",

package/plugins/feishu-plugin.js

@@ -192,12 +192,13 @@ class FeishuPlugin extends Plugin {
       case 'start':
       case 'help':
         await this._sendMessage(openId,
-          '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n可用命令：\n/start - 显示帮助\n/clear - 清除对话历史\n/history - 查看历史消息数',
+          '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n可用命令：\n/start - 显示帮助\n/clean - 清除对话上下文\n/history - 查看历史消息数',
           originalMsg)
         break
       case 'clear':
-        this._clearSession(openId)
-        await this._sendMessage(openId, '✅ 对话历史已清除', originalMsg)
+      case 'clean':
+        await this._clearSessionContext(openId)
+        await this._sendMessage(openId, '✅ 对话上下文已清除', originalMsg)
         break
       case 'history':
         if (this._sessionPlugin) {
@@ -442,6 +443,38 @@ class FeishuPlugin extends Plugin {
     }
   }
 
+  /**
+   * 清除会话上下文（清除消息历史和压缩计数）
+   */
+  async _clearSessionContext(openId) {
+    const sessionId = `feishu_${openId}`
+
+    // 获取或创建 sessionAgent
+    const { agent } = this._getSessionAgent(openId)
+
+    // 清除 AgentChatHandler 的消息存储（需要传 sessionId）
+    if (agent._chatHandler) {
+      agent._chatHandler.clearHistory(sessionId)
+    }
+
+    // 清除 SessionContext 的消息和压缩计数
+    if (this._framework) {
+      const sessionCtx = this._framework.getSessionContext(sessionId)
+      if (sessionCtx) {
+        sessionCtx.clearMessages()
+        sessionCtx.compressionState.count = 0
+        sessionCtx.metadata.compressionCount = 0
+      }
+      // 同步清除 framework 缓存的 sessionContexts
+      const cachedCtx = this._framework._sessionContexts?.get(sessionId)
+      if (cachedCtx) {
+        cachedCtx.clearMessages()
+        cachedCtx.compressionState.count = 0
+        cachedCtx.metadata.compressionCount = 0
+      }
+    }
+  }
+
   getStatus() {
     let sessions = []
     if (this._sessionPlugin) {

package/plugins/telegram-plugin.js

@@ -302,20 +302,24 @@ class TelegramPlugin extends Plugin {
 
     switch (command.toLowerCase()) {
       case 'start':
+      case 'help':
         await this._sendMessage(chatId,
-          '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n可用命令：\n/start - 显示帮助\n/clear - 清除对话历史\n/history - 查看历史消息数',
+          '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n可用命令：\n/clean - 清除对话上下文\n/history - 查看历史消息数',
           msg.message_id)
         break
+      case 'clean':
       case 'clear':
-        this._clearSession(chatId)
-        await this._sendMessage(chatId, '✅ 对话历史已清除', msg.message_id)
+        await this._clearSessionContext(chatId)
+        await this._sendMessage(chatId, '✅ 对话上下文已清除', msg.message_id)
         break
       case 'history':
-        if (this._sessionPlugin) {
-          const session = this._sessionPlugin.getSession(`telegram_${chatId}`)
-          const sessions = this._sessionPlugin.listSessions().filter(s => s.id.startsWith('telegram_'))
+        const sessionInfo = this._getSessionAgent(chatId)
+        if (sessionInfo && this._framework) {
+          const sessionCtx = this._framework.getSessionContext(sessionInfo.sessionId)
+          const count = sessionCtx?.messageStore?.messages?.length || 0
+          const compressionCount = sessionCtx?.metadata?.compressionCount || 0
           await this._sendMessage(chatId,
-            `📊 当前状态\n\n会话数：${sessions.length}\n历史消息：${session?.messages?.length || 0}\n最后活跃：${session?.lastActive?.toLocaleString() || '无'}`,
+            `📊 当前状态\n\n历史消息：${count}\n压缩次数：${compressionCount}`,
             msg.message_id)
         } else {
           await this._sendMessage(chatId, '❌ 会话服务不可用', msg.message_id)
@@ -452,6 +456,38 @@ class TelegramPlugin extends Plugin {
     }
   }
 
+  /**
+   * 清除会话上下文（清除消息历史和压缩计数）
+   */
+  async _clearSessionContext(chatId) {
+    const sessionId = `telegram_${chatId}`
+
+    // 获取或创建 sessionAgent
+    const { agent } = this._getSessionAgent(chatId)
+
+    // 清除 AgentChatHandler 的消息存储（需要传 sessionId）
+    if (agent._chatHandler) {
+      agent._chatHandler.clearHistory(sessionId)
+    }
+
+    // 清除 SessionContext 的消息和压缩计数
+    if (this._framework) {
+      const sessionCtx = this._framework.getSessionContext(sessionId)
+      if (sessionCtx) {
+        sessionCtx.clearMessages()
+        sessionCtx.compressionState.count = 0
+        sessionCtx.metadata.compressionCount = 0
+      }
+      // 同步清除 framework 缓存的 sessionContexts
+      const cachedCtx = this._framework._sessionContexts?.get(sessionId)
+      if (cachedCtx) {
+        cachedCtx.clearMessages()
+        cachedCtx.compressionState.count = 0
+        cachedCtx.metadata.compressionCount = 0
+      }
+    }
+  }
+
   async _sendMessage(chatId, text, replyToMessageId = null) {
     if (!this._bot) return
     return this._bot.sendMessage(chatId, text, { reply_to_message_id: replyToMessageId })

package/plugins/weixin-plugin.js

@@ -535,6 +535,12 @@ class WeixinPlugin extends Plugin {
    * 处理对话
    */
   async _processChat(userId, text, originalMsg) {
+    // 处理命令
+    if (text.startsWith('/')) {
+      await this._handleCommand(userId, text, originalMsg)
+      return
+    }
+
     const sessionInfo = this._getSessionAgent(userId)
     if (!sessionInfo) {
       log.error(' No session agent available')
@@ -561,6 +567,75 @@ class WeixinPlugin extends Plugin {
     }
   }
 
+  /**
+   * 处理命令
+   */
+  async _handleCommand(userId, text, originalMsg) {
+    const parts = text.split(' ')
+    const command = parts[0].substring(1)
+    const args = parts.slice(1).join(' ')
+
+    switch (command.toLowerCase()) {
+      case 'start':
+      case 'help':
+        await this._sendMessageBatch(originalMsg, userId,
+          '👋 欢迎使用 AI 助手！\n\n直接发送消息即可与我对话。\n\n可用命令：\n/clean - 清除对话上下文\n/history - 查看历史消息数',
+          true)
+        break
+      case 'clean':
+      case 'clear':
+        await this._clearSessionContext(userId)
+        await this._sendMessageBatch(originalMsg, userId, '✅ 对话上下文已清除', true)
+        break
+      case 'history':
+        const sessionInfo = this._getSessionAgent(userId)
+        if (sessionInfo && this._framework) {
+          const sessionCtx = this._framework.getSessionContext(sessionInfo.sessionId)
+          const count = sessionCtx?.messageStore?.messages?.length || 0
+          const compressionCount = sessionCtx?.metadata?.compressionCount || 0
+          await this._sendMessageBatch(originalMsg, userId,
+            `📊 当前状态\n\n历史消息：${count}\n压缩次数：${compressionCount}`,
+            true)
+        }
+        break
+      default:
+        // 未识别命令，当作普通消息处理
+        await this._processChat(userId, text, originalMsg)
+    }
+  }
+
+  /**
+   * 清除会话上下文（清除消息历史和压缩计数）
+   */
+  async _clearSessionContext(userId) {
+    const sessionId = `weixin_${userId}`
+
+    // 获取或创建 sessionAgent
+    const { agent } = this._getSessionAgent(userId)
+
+    // 清除 AgentChatHandler 的消息存储（需要传 sessionId）
+    if (agent._chatHandler) {
+      agent._chatHandler.clearHistory(sessionId)
+    }
+
+    // 清除 SessionContext 的消息和压缩计数
+    if (this._framework) {
+      const sessionCtx = this._framework.getSessionContext(sessionId)
+      if (sessionCtx) {
+        sessionCtx.clearMessages()
+        sessionCtx.compressionState.count = 0
+        sessionCtx.metadata.compressionCount = 0
+      }
+      // 同步清除 framework 缓存的 sessionContexts
+      const cachedCtx = this._framework._sessionContexts?.get(sessionId)
+      if (cachedCtx) {
+        cachedCtx.clearMessages()
+        cachedCtx.compressionState.count = 0
+        cachedCtx.metadata.compressionCount = 0
+      }
+    }
+  }
+
   /**
    * 权限检查
    */

package/src/core/agent.js

@@ -90,10 +90,11 @@ class Agent extends EventEmitter {
     this.apiKey = config.apiKey;
     this.baseURL = config.baseURL;
     this.provider = config.provider || 'deepseek';
-    this.providerOptions = config.providerOptions || {};
-    // 使用常量替代硬编码数字
-    this.providerOptions.maxOutputTokens = AGENT_CONFIG.MAX_OUTPUT_TOKENS;
-    this.providerOptions.temperature = AGENT_CONFIG.TEMPERATURE;
+    this.providerOptions = {
+      ...config.providerOptions,
+      maxOutputTokens: config.providerOptions?.maxOutputTokens ?? AGENT_CONFIG.MAX_OUTPUT_TOKENS,
+      temperature: config.providerOptions?.temperature ?? AGENT_CONFIG.TEMPERATURE,
+    };
     // 原始 system prompt
     this._originalPrompt =
       config.systemPrompt ||

package/src/core/context-compressor.js

@@ -188,10 +188,15 @@ class ContextCompressor {
 
     // 更新压缩状态
     this._compressionCount++;
+    const tokenCount = this._countMessagesTokens(messages);
     if (messageStore.compressionState) {
       messageStore.compressionState.count++;
       messageStore.compressionState.lastCompressedAt = Date.now();
-      messageStore.compressionState.lastTokenCount = this._countMessagesTokens(messages);
+      messageStore.compressionState.lastTokenCount = tokenCount;
+    }
+    // 同步更新 SessionContext.metadata.compressionCount（如果可用）
+    if (typeof messageStore.recordCompression === 'function') {
+      messageStore.recordCompression(tokenCount);
     }
 
     logger.info(

package/src/core/context-manager.js

@@ -19,10 +19,6 @@ class ContextManager {
 
     // Context 存储
     this._requestContexts = new Map(); // requestId → RequestContext
-    this._sessionContexts = new Map(); // sessionId → SessionContext
-
-    // 引用计数（用于自动清理）
-    this._refCounts = new Map();
 
     // 事件转发
     this._setupEventForwarding();
@@ -88,86 +84,15 @@ class ContextManager {
     this._refCounts.set(key, (this._refCounts.get(key) || 0) + 1);
   }
 
-  // ==================== Session Context ====================
-
-  /**
-   * 获取或创建 Session Context
-   * @param {string} sessionId - 会话 ID
-   * @param {Object} options - 配置选项
-   * @returns {SessionContext}
-   */
-  getOrCreateSessionContext(sessionId, options = {}) {
-    let ctx = this._sessionContexts.get(sessionId);
-    if (!ctx) {
-      ctx = new SessionContext(sessionId, this.framework, options);
-      this._sessionContexts.set(sessionId, ctx);
-      this._refCounts.set(`session:${sessionId}`, 1);
-    } else {
-      // 增加引用计数
-      const key = `session:${sessionId}`;
-      this._refCounts.set(key, (this._refCounts.get(key) || 0) + 1);
-    }
-    return ctx;
-  }
-
-  /**
-   * 获取 Session Context
-   * @param {string} sessionId - 会话 ID
-   * @returns {SessionContext|null}
-   */
-  getSessionContext(sessionId) {
-    return this._sessionContexts.get(sessionId) || null;
-  }
-
-  /**
-   * 释放 Session Context（减少引用计数）
-   * @param {string} sessionId - 会话 ID
-   * @param {boolean} [force=false] - 强制销毁
-   */
-  releaseSessionContext(sessionId, force = false) {
-    const key = `session:${sessionId}`;
-    const count = this._refCounts.get(key) || 0;
-
-    if (force || count <= 1) {
-      const ctx = this._sessionContexts.get(sessionId);
-      if (ctx) {
-        ctx.destroy();
-        this.framework.emit('session:context-destroyed', ctx);
-      }
-      this._sessionContexts.delete(sessionId);
-      this._refCounts.delete(key);
-    } else {
-      this._refCounts.set(key, count - 1);
-    }
-  }
-
-  /**
-   * 增加 Session Context 引用计数
-   * @param {string} sessionId - 会话 ID
-   */
-  retainSessionContext(sessionId) {
-    const key = `session:${sessionId}`;
-    this._refCounts.set(key, (this._refCounts.get(key) || 0) + 1);
-  }
-
-  /**
-   * 检查 Session Context 是否存在
-   * @param {string} sessionId - 会话 ID
-   * @returns {boolean}
-   */
-  hasSessionContext(sessionId) {
-    return this._sessionContexts.has(sessionId);
-  }
-
   // ==================== 批量操作 ====================
 
   /**
    * 销毁所有 Session Context
+   * @deprecated Use framework.destroySessionContext() instead - Framework manages sessions
    */
   destroyAllSessionContexts() {
-    for (const [sessionId] of this._sessionContexts) {
-      this.releaseSessionContext(sessionId, true);
-    }
+    // No-op: Framework manages session contexts, not ContextManager
+    // This method exists for API compatibility but does nothing
   }
 
   /**
@@ -192,8 +117,7 @@ class ContextManager {
       this.releaseRequestContext(requestId);
     }
 
-    // 清理 Session Contexts
-    this.destroyAllSessionContexts();
+    // Session Contexts 由 Framework 管理，此处不需要清理
   }
 
   // ==================== 统计 ====================
@@ -205,8 +129,6 @@ class ContextManager {
   getStats() {
     return {
       activeRequests: this._requestContexts.size,
-      activeSessions: this._sessionContexts.size,
-      refCounts: Object.fromEntries(this._refCounts),
     };
   }
 
@@ -215,19 +137,8 @@ class ContextManager {
    * @returns {Object}
    */
   getMemoryUsage() {
-    let sessionMessagesSize = 0;
-    let sessionVariablesSize = 0;
-
-    for (const ctx of this._sessionContexts.values()) {
-      sessionMessagesSize += ctx.messageStore.messages.length;
-      sessionVariablesSize += ctx.variables.size;
-    }
-
     return {
       requestContexts: this._requestContexts.size,
-      sessionContexts: this._sessionContexts.size,
-      totalSessionMessages: sessionMessagesSize,
-      totalSessionVariables: sessionVariablesSize,
     };
   }
 }

package/src/core/framework.js

@@ -96,7 +96,12 @@ class Framework extends EventEmitter {
     this.toolRegistry.on('tool:call', toolCallHandler);
     this.toolRegistry.on('tool:result', toolResultHandler);
     this.toolRegistry.on('tool:error', toolErrorHandler);
-    this._toolRegistryListeners = [toolRegisteredHandler, toolCallHandler, toolResultHandler, toolErrorHandler];
+    this._toolRegistryListeners = [
+      { event: 'tool:registered', handler: toolRegisteredHandler },
+      { event: 'tool:call', handler: toolCallHandler },
+      { event: 'tool:result', handler: toolResultHandler },
+      { event: 'tool:error', handler: toolErrorHandler },
+    ];
 
     // 事件转发 - Agent 事件
     this._setupAgentEventForwarding();
@@ -683,15 +688,18 @@ class Framework extends EventEmitter {
       // 只同步 Subagent
       if (!agent._isSubagent) continue;
 
+      // Build a Set of already registered parts for O(1) lookup
+      const registeredNames = new Set(agent._promptParts?.map(p => p.name) || []);
+
       for (const [name, part] of mainParts) {
         // 子 Agent 跳过这些不适合的部分
         if (['original-prompt', 'shared-prompt', 'datetime', 'metadata', 'capabilities'].includes(name)) {
           continue;
         }
-        // 检查是否已注册
-        const alreadyRegistered = agent._promptParts?.some(p => p.name === name);
-        if (!alreadyRegistered) {
+        // O(1) lookup instead of O(m)
+        if (!registeredNames.has(name)) {
           agent.registerPromptPart(name, part.priority, part.provider);
+          registeredNames.add(name);
         }
       }
     }
@@ -912,11 +920,8 @@ class Framework extends EventEmitter {
 
     // 移除 toolRegistry 的事件监听器
     if (this._toolRegistryListeners) {
-      for (const listener of this._toolRegistryListeners) {
-        this.toolRegistry.off('tool:registered', listener);
-        this.toolRegistry.off('tool:call', listener);
-        this.toolRegistry.off('tool:result', listener);
-        this.toolRegistry.off('tool:error', listener);
+      for (const { event, handler } of this._toolRegistryListeners) {
+        this.toolRegistry.off(event, handler);
       }
       this._toolRegistryListeners = [];
     }

package/src/core/session-context.js

@@ -52,6 +52,8 @@ class SessionContext {
       messages: options.initialMessages || [], // 对话历史
       historyLoaded: false, // 是否已从持久化加载
       systemPrompt: null, // 当前系统提示词
+      // 委托给 SessionContext.recordCompression
+      recordCompression: (tokenCount) => this.recordCompression(tokenCount),
     };
 
     // 压缩状态
@@ -59,6 +61,7 @@ class SessionContext {
       lastCompressedAt: null,
       lastTokenCount: 0,
       pendingCompression: false,
+      count: 0,
     };
 
     // 自定义数据插槽
@@ -200,6 +203,7 @@ class SessionContext {
       initialMessages: data.messages || [],
       variables: data.variables || {},
       metadata: data.metadata || {},
+      storage,
     });
 
     ctx.messageStore.historyLoaded = true;
@@ -285,6 +289,7 @@ class SessionContext {
   recordCompression(tokenCount) {
     this.compressionState.lastCompressedAt = Date.now();
     this.compressionState.lastTokenCount = tokenCount;
+    this.compressionState.count++;
     this.metadata.compressionCount++;
   }
 

package/src/core/session-storage.js

@@ -8,6 +8,7 @@
  */
 
 const fs = require('fs');
+const fsPromises = require('fs').promises;
 const path = require('path');
 
 class SessionStorageAdapter {
@@ -36,10 +37,12 @@ class SessionStorageAdapter {
    * 确保目录存在
    * @private
    */
-  _ensureDirectory() {
+  async _ensureDirectory() {
     const dir = path.resolve(process.cwd(), this.baseDir);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
+    try {
+      await fsPromises.access(dir);
+    } catch {
+      await fsPromises.mkdir(dir, { recursive: true });
     }
   }
 
@@ -121,12 +124,14 @@ class SessionStorageAdapter {
     try {
       // 确保目录存在
       const dir = path.dirname(filePath);
-      if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
+      try {
+        await fsPromises.access(dir);
+      } catch {
+        await fsPromises.mkdir(dir, { recursive: true });
       }
 
       const content = JSON.stringify(data, null, 2);
-      fs.writeFileSync(filePath, content, 'utf-8');
+      await fsPromises.writeFile(filePath, content, 'utf-8');
     } catch (err) {
       console.error(`[SessionStorage] Failed to write ${sessionId}:`, err.message);
       throw err;
@@ -146,12 +151,14 @@ class SessionStorageAdapter {
     if (this.type === 'file') {
       const filePath = this._getFilePath(sessionId);
 
-      if (!fs.existsSync(filePath)) {
+      try {
+        await fsPromises.access(filePath);
+      } catch {
         return null;
       }
 
       try {
-        const content = fs.readFileSync(filePath, 'utf-8');
+        const content = await fsPromises.readFile(filePath, 'utf-8');
         return JSON.parse(content);
       } catch (err) {
         console.error(`[SessionStorage] Failed to read ${sessionId}:`, err.message);
@@ -175,16 +182,19 @@ class SessionStorageAdapter {
     if (this.type === 'file') {
       const filePath = this._getFilePath(sessionId);
 
-      if (fs.existsSync(filePath)) {
-        try {
-          fs.unlinkSync(filePath);
-          return true;
-        } catch (err) {
-          console.error(`[SessionStorage] Failed to delete ${sessionId}:`, err.message);
-          return false;
-        }
+      try {
+        await fsPromises.access(filePath);
+      } catch {
+        return false;
+      }
+
+      try {
+        await fsPromises.unlink(filePath);
+        return true;
+      } catch (err) {
+        console.error(`[SessionStorage] Failed to delete ${sessionId}:`, err.message);
+        return false;
       }
-      return false;
     }
 
     return false;
@@ -202,12 +212,14 @@ class SessionStorageAdapter {
     if (this.type === 'file') {
       const dir = path.resolve(process.cwd(), this.baseDir);
 
-      if (!fs.existsSync(dir)) {
+      try {
+        await fsPromises.access(dir);
+      } catch {
         return [];
       }
 
       try {
-        const files = fs.readdirSync(dir);
+        const files = await fsPromises.readdir(dir);
         return files.filter((f) => f.endsWith('.json')).map((f) => f.replace(/\.json$/, ''));
       } catch (err) {
         console.error(`[SessionStorage] Failed to list sessions:`, err.message);
@@ -255,6 +267,15 @@ let _defaultAdapter = null;
 function getDefaultAdapter(options = {}) {
   if (!_defaultAdapter) {
     _defaultAdapter = new SessionStorageAdapter(options);
+  } else if (Object.keys(options).length > 0) {
+    // 如果已存在但传入了新选项，用新选项更新默认适配器
+    // 注意：这会修改全局单例，需要确保调用方知道这一点
+    if (options.type && options.type !== _defaultAdapter.type) {
+      _defaultAdapter.type = options.type;
+    }
+    if (options.baseDir && options.baseDir !== _defaultAdapter.baseDir) {
+      _defaultAdapter.baseDir = options.baseDir;
+    }
   }
   return _defaultAdapter;
 }