foliko 2.0.0 → 2.0.2

package/package.json

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

package/plugins/ambient/index.js

@@ -44,6 +44,7 @@ class AmbientAgentPlugin extends Plugin {
     this._explorerLoop = null
     this._memories = []
     this._thinkAgent = null
+    this._initialized = false
   }
 
   // ============================================================================
@@ -88,6 +89,9 @@ class AmbientAgentPlugin extends Plugin {
   }
 
   start(framework) {
+    if (this._initialized) return this;
+    this._initialized = true;
+
     if (!this.config.enabled) {
       // log.info('插件已禁用，跳过启动')
       return this

package/plugins/core/coordinator/index.js

@@ -20,7 +20,7 @@ class CoordinatorPlugin extends Plugin {
     this.version = '1.0.0';
     this.description = 'Coordinator模式插件，支持多Worker协作';
     this.priority = 50;
-    this.enabled = false
+    this.enabled = config.enabled === true
     this._framework = null;
     this._coordinatorAgent = null;
   }

package/plugins/core/default/bootstrap.js

@@ -65,6 +65,9 @@ async function bootstrapDefaults(framework, config = {}) {
     return;
   }
 
+  // 启用 bootstrap 模式：load() 只 install 不 start，由 startAll() 统一启动
+  framework.pluginManager.setBootstrapping(true);
+
   const shouldLoad = (plugin) => {
     const name = typeof plugin === 'string' ? plugin : (plugin.name || plugin.prototype?.name);
     if (framework.pluginManager.has(name)) { return false; }
@@ -187,11 +190,30 @@ async function bootstrapDefaults(framework, config = {}) {
     }));
   }
 
+  // 6.75 Messaging plugins (from plugins/messaging/ subdirectory)
+  const messagingPlugins = ['telegram', 'qq', 'weixin', 'feishu', 'email'];
+  for (const name of messagingPlugins) {
+    if (shouldLoad(name)) {
+      try {
+        const pluginDir = path.resolve(__dirname, '..', '..', '..', 'plugins', 'messaging', name);
+        if (!fs.existsSync(pluginDir)) continue;
+        const PluginClass = require(`../../messaging/${name}`);
+        const pluginConfig = agentConfig[name] || {};
+        await framework.loadPlugin(new PluginClass(pluginConfig));
+      } catch (err) {
+        log.warn(`Messaging plugin '${name}' failed to load:`, err.message);
+      }
+    }
+  }
+
   // 7. Custom plugins from directories
   await loadCustomPlugins(framework, agentConfig);
 
-  // Start all
+  // 统一启动所有插件
   await framework.pluginManager.startAll();
+
+  // 退出 bootstrap 模式
+  framework.pluginManager.setBootstrapping(false);
 }
 
 module.exports = {

package/plugins/core/default/config.js

@@ -89,6 +89,8 @@ function loadAgentConfig(framework, agentDir = '.foliko') {
       const pc = JSON.parse(fs.readFileSync(pluginsFile, 'utf-8'));
       if (pc.telegram) config.telegram = pc.telegram;
       if (pc.weixin) config.weixin = pc.weixin;
+      if (pc.qq) config.qq = pc.qq;
+      if (pc.feishu) config.feishu = pc.feishu;
       if (pc.email) config.email = pc.email;
       if (pc.pluginLinks) config.pluginLinks = pc.pluginLinks;
     } catch (err) { log.error('Failed to load plugins.json:', err.message); }
@@ -181,7 +183,7 @@ function loadAgentConfig(framework, agentDir = '.foliko') {
 
     const homePlugins = path.join(homeDir, 'plugins.json');
     if (!fs.existsSync(path.join(resolvedDir, 'plugins.json')) && fs.existsSync(homePlugins)) {
-      try { const pc = JSON.parse(fs.readFileSync(homePlugins, 'utf-8')); if (pc.telegram && !config.telegram) config.telegram = pc.telegram; if (pc.weixin && !config.weixin) config.weixin = pc.weixin; if (pc.email && !config.email) config.email = pc.email; config.pluginLinks = { ...(pc.pluginLinks || {}), ...config.pluginLinks }; } catch {}
+      try { const pc = JSON.parse(fs.readFileSync(homePlugins, 'utf-8')); if (pc.telegram && !config.telegram) config.telegram = pc.telegram; if (pc.weixin && !config.weixin) config.weixin = pc.weixin; if (pc.qq && !config.qq) config.qq = pc.qq; if (pc.feishu && !config.feishu) config.feishu = pc.feishu; if (pc.email && !config.email) config.email = pc.email; config.pluginLinks = { ...(pc.pluginLinks || {}), ...config.pluginLinks }; } catch {}
     }
 
     const homeMcp = path.join(homeDir, 'mcp_config.json');

package/plugins/messaging/email/index.js

@@ -75,7 +75,7 @@ class EmailPlugin extends Plugin {
 - attachments.content: Base64内容
 - attachments.cid: 嵌入式图片CID（HTML中用 <img src="cid:xxx"> 引用）`
     this.priority = 50
-    this.enabled = false
+    this.enabled = config.enabled === true
 
     this.tools={}
 

package/plugins/messaging/feishu/index.js

@@ -20,7 +20,7 @@ class FeishuPlugin extends Plugin {
     this.version = '1.1.0'
     this.description = '飞书对话插件，使用 WebSocket 长连接接收消息'
     this.priority = 80
-    this.enabled = false
+    this.enabled = config.enabled === true
     this.systemPrompt = `你是一个飞书助手。回复内容不要使用markdown格式文本。
 
 **重要:** 子Agent 匹配规则必须遵守：

package/plugins/messaging/qq/index.js

@@ -25,7 +25,7 @@ class QQPlugin extends Plugin {
     this.version = '1.0.0'
     this.description = 'QQ 对话插件，使用 QQ 开放平台进行对话'
     this.priority = 80
-    this.enabled = false
+    this.enabled = config.enabled === true
     this.path = `.foliko/data`
 
     this.config = {

package/plugins/messaging/telegram/index.js

@@ -27,7 +27,7 @@ class TelegramPlugin extends Plugin {
     this.version = '2.1.0'
     this.description = 'Telegram 对话插件，绑定主Agent进行持续对话'
     this.priority = 80
-    this.enabled = false
+    this.enabled = config.enabled === true
     this.systemPrompt = `你是一个有帮助的AI助手。回复内容不要使用markdown格式文本。
 
 **重要:** 子Agent 匹配规则必须遵守：
@@ -56,6 +56,7 @@ class TelegramPlugin extends Plugin {
     this._sessionScopes = new Map()
     this._pendingResponses = new Map()
     this._thinkingMessages = new Map()
+    this._initialized = false
   }
 
   install(framework) {
@@ -64,6 +65,9 @@ class TelegramPlugin extends Plugin {
   }
 
   start(framework) {
+    if (this._initialized) return this;
+    this._initialized = true;
+
     if (!this.config.botToken) {
       log.warn(' No bot token. Set TELEGRAM_BOT_TOKEN env var.')
       return this

package/plugins/messaging/weixin/index.js

@@ -6,8 +6,8 @@
  * - forceLogin: 是否强制重新扫码登录
  * - qrcodeTerminal: 是否在终端渲染二维码 (默认 true)
  */
-const { CLEAR_LINE, CYAN, DIM, GREEN, RED, YELLOW, colored } = require('../../../cli/src/utils/ansi');
-const { renderLine } = require('../../../cli/src/utils/markdown');
+const { CLEAR_LINE, CYAN, DIM, GREEN, RED, YELLOW, colored } = require('../../../src/cli/utils/ansi');
+const { renderLine } = require('../../../src/cli/utils/markdown');
 const { debounce, throttle } = require('../../../src/utils');
 const interval = (fn) => {
   const handle = setInterval(fn, 3000);
@@ -32,7 +32,7 @@ class WeixinPlugin extends Plugin {
     this.description = '微信对话插件，使用微信网页账号进行对话'
     this.priority = 80
     // 默认不启用，需要在 plugins.json 中设置 enabled: true
-    this.enabled = false
+    this.enabled = config.enabled === true
     this.path=`.foliko/data`
     this.systemPrompt=`你是一个微信助手。
 

package/src/plugin/manager.js

@@ -2,7 +2,7 @@
 
 /**
  * PluginManager 插件管理器
- * 负责插件的加载、卸载、重载
+ * 负责插件的加载、卸载、重载、启用/禁用
  */
 
 const { Plugin } = require('./base');
@@ -18,6 +18,7 @@ class PluginManager {
     this.framework = framework;
     this._plugins = new Map();
     this._loading = false;
+    this._bootstrapping = false;
     this._stateFile = path.join(
       framework?.getCwd?.() ?? process.cwd(),
       '.foliko',
@@ -37,13 +38,41 @@ class PluginManager {
     // placeholder - plugins can register event descriptions
   }
 
-  register(plugin) {
+  /**
+   * 注册插件（不加载，只记录状态）
+   */
+  register(plugin, options = {}) {
     if (!(plugin instanceof Plugin)) {
       throw new PluginError('Plugin must be an instance of Plugin');
     }
-    this._plugins.set(plugin.name, { instance: plugin, enabled: true });
+
+    const savedState = this._loadState();
+    const savedEnabled = savedState[plugin.name]?.enabled;
+    const savedConfig = savedState[plugin.name]?.config;
+
+    // 恢复保存的配置
+    if (savedConfig && plugin.config && plugin.name !== 'ai') {
+      plugin.config = { ...plugin.config, ...savedConfig };
+    }
+
+    // 确定启用状态：系统插件强制启用 → state 文件记录 → 插件默认
+    let enabled;
+    if (plugin.system) {
+      enabled = true;
+    } else if (savedEnabled !== undefined) {
+      enabled = savedEnabled;
+    } else {
+      enabled = plugin.enabled !== false;
+    }
+
+    this._plugins.set(plugin.name, {
+      instance: plugin,
+      status: 'registered',
+      enabled,
+      sourcePath: plugin.sourcePath || null,
+    });
     this._knownPlugins.add(plugin.name);
-    this._log.debug(`Plugin registered: ${plugin.name}`);
+    this._log.debug(`Plugin registered: ${plugin.name} (enabled: ${enabled})`);
     return this;
   }
 
@@ -71,7 +100,6 @@ class PluginManager {
 
   /**
    * 获取所有已知插件信息（包括已加载和未加载的）
-   * @returns {Array<{name: string, status: string, enabled: boolean, version?: string, system?: boolean}>}
    */
   getAllKnown() {
     const result = [];
@@ -81,7 +109,7 @@ class PluginManager {
         const inst = entry.instance;
         result.push({
           name,
-          status: 'loaded',
+          status: entry.status || 'registered',
           enabled: entry.enabled !== false,
           version: inst.version,
           system: inst.system,
@@ -90,6 +118,18 @@ class PluginManager {
         result.push({ name, status: 'known', enabled: false });
       }
     }
+    // 加入已加载但不在 knownPlugins 中的
+    for (const [name, entry] of this._plugins) {
+      if (!result.find(p => p.name === name)) {
+        result.push({
+          name,
+          status: entry.status || 'registered',
+          enabled: entry.enabled !== false,
+          version: entry.instance?.version,
+          system: entry.instance?.system || false,
+        });
+      }
+    }
     return result;
   }
 
@@ -97,31 +137,71 @@ class PluginManager {
     return this._plugins.size;
   }
 
-  async load(plugin) {
-    const name = plugin.name;
+  /**
+   * 加载插件
+   * @param {Plugin|Object} plugin - 插件实例或类
+   * @param {Object} [options] - 加载选项
+   * @param {boolean} [options.forceEnabled] - 强制启用，忽略 state 文件的 disabled
+   */
+  async load(plugin, options = {}) {
+    let pluginInstance = plugin;
+
+    // 如果是类（Plugin 子类），实例化
+    if (typeof plugin === 'function' && plugin.prototype instanceof Plugin) {
+      pluginInstance = new plugin();
+    }
+
+    const name = pluginInstance.name;
 
-    if (this._plugins.has(name)) {
+    // 已存在且已加载 → 跳过
+    const existing = this._plugins.get(name);
+    if (existing && existing.status === 'loaded' && pluginInstance._started) {
       this._log.debug(`Plugin '${name}' already loaded, skipping`);
       return;
     }
 
+    // 已注册但未加载 → 检查 enabled 状态
+    if (existing) {
+      if (!existing.enabled && !options.forceEnabled) {
+        this._log.info(`Plugin '${name}' is disabled, skipping load`);
+        return;
+      }
+      pluginInstance = existing.instance;
+    } else {
+      // 未注册 → 先注册
+      this.register(pluginInstance, options);
+    }
+
+    const entry = this._plugins.get(name);
+    if (!entry.enabled && !options.forceEnabled) {
+      this._log.info(`Plugin '${name}' is disabled, skipping load`);
+      return;
+    }
+
+    // 如果 forceEnabled，覆盖 enabled 状态
+    if (options.forceEnabled) {
+      entry.enabled = true;
+      pluginInstance.enabled = true;
+    }
+
     this._log.info(`Loading plugin: ${name}`);
 
-    if (typeof plugin.install === 'function') {
-      plugin.install(this.framework);
+    if (typeof pluginInstance.install === 'function') {
+      pluginInstance.install(this.framework);
     }
 
-    this._plugins.set(name, {
-      instance: plugin,
-      sourcePath: plugin.sourcePath || null,
-      enabled: plugin.enabled !== false,
-    });
-    this._knownPlugins.add(name);
+    entry.status = 'loaded';
 
-    if (typeof plugin.start === 'function') {
-      await plugin.start(this.framework);
+    // bootstrapping 模式下不 start，由 startAll() 统一启动
+    if (!this._bootstrapping) {
+      if (typeof pluginInstance.start === 'function') {
+        await pluginInstance.start(this.framework);
+        pluginInstance._started = true;
+      }
     }
 
+    this.framework?.emit('plugin:loaded', pluginInstance);
+    this._saveState();
     this._log.info(`Plugin loaded: ${name}`);
   }
 
@@ -139,7 +219,7 @@ class PluginManager {
     }
 
     this._plugins.delete(name);
-    this._log.info(`Plugin unloaded: ${name}`);
+    return true;
   }
 
   async unloadExcept(keepSet) {
@@ -169,7 +249,6 @@ class PluginManager {
     if (typeof plugin.reload === 'function') {
       await plugin.reload(this.framework);
     } else {
-      // Default reload: uninstall + install + start
       if (typeof plugin.uninstall === 'function') {
         plugin.uninstall(this.framework);
       }
@@ -181,50 +260,154 @@ class PluginManager {
       }
     }
 
+    this.framework?.emit('plugin:reloaded', plugin);
     this._log.info(`Plugin reloaded: ${name}`);
   }
 
+  /**
+   * 启动所有已加载、已启用、未启动的插件（按优先级排序）
+   */
   async startAll() {
-    for (const [name, entry] of this._plugins) {
+    const entries = Array.from(this._plugins.values())
+      .filter(e => e.status === 'loaded' && e.enabled)
+      .sort((a, b) => (a.instance.priority || 100) - (b.instance.priority || 100));
+
+    for (const entry of entries) {
       const plugin = entry.instance;
+      if (plugin._started) continue;
       if (typeof plugin.start === 'function') {
         try {
           await plugin.start(this.framework);
+          plugin._started = true;
         } catch (err) {
-          this._log.warn(`startAll: ${name} failed: ${err.message}`);
+          this._log.warn(`startAll: ${plugin.name} failed: ${err.message}`);
         }
       }
     }
   }
 
-  async reloadAll() {
-    const names = this.getNames();
-    for (const name of names) {
+  /**
+   * 启用插件
+   */
+  async enable(name) {
+    const entry = this._plugins.get(name);
+    if (!entry) {
+      throw new PluginNotFoundError(name);
+    }
+    if (entry.instance?.system) {
+      throw new PluginError(`Plugin '${name}' is a system plugin, cannot be disabled/enabled`);
+    }
+    if (entry.enabled) {
+      this._log.info(`Plugin '${name}' already enabled`);
+      return;
+    }
+
+    entry.enabled = true;
+    if (entry.instance) {
+      entry.instance.enabled = true;
+    }
+
+    // 如果已加载，重新启动
+    if (entry.status === 'loaded') {
       try {
-        await this.reload(name);
+        // 停止旧实例
+        if (entry.instance._started) {
+          if (typeof entry.instance.stopBot === 'function') {
+            await entry.instance.stopBot();
+          } else if (typeof entry.instance.stop === 'function') {
+            await entry.instance.stop();
+          }
+        }
+
+        // 如果记录过 sourcePath，重新 require 最新代码
+        if (entry.sourcePath) {
+          delete require.cache[require.resolve(entry.sourcePath)];
+          const mod = require(entry.sourcePath);
+          let NewClass = mod.default || mod;
+          if (typeof NewClass === 'function' && NewClass.prototype instanceof Plugin) {
+            const newInstance = new NewClass();
+            newInstance._sourcePath = entry.sourcePath;
+            if (entry.instance.config) newInstance.config = { ...entry.instance.config };
+            entry.instance = newInstance;
+            await newInstance.install(this.framework);
+            await newInstance.start(this.framework);
+            newInstance._started = true;
+            this.framework?.emit('plugin:reloaded', newInstance);
+          }
+        } else {
+          // 没有 sourcePath，用现有实例重启
+          if (typeof entry.instance.reload === 'function') {
+            // 有自定义 reload，由它处理完整重启（内部应调 start）
+            await entry.instance.reload(this.framework);
+          } else {
+            // 没有 reload，走完整 uninstall + install + start
+            if (typeof entry.instance.uninstall === 'function') {
+              entry.instance.uninstall(this.framework);
+            }
+            if (typeof entry.instance.install === 'function') {
+              entry.instance.install(this.framework);
+            }
+            if (typeof entry.instance.start === 'function') {
+              await entry.instance.start(this.framework);
+            }
+          }
+          entry.instance._started = true;
+        }
       } catch (err) {
-        this._log.warn(`Failed to reload '${name}': ${err.message}`);
+        this._log.error(`Enable/start failed for '${name}':`, err.message);
+      }
+    } else if (entry.status === 'registered') {
+      // 只注册过但未加载，现在加载
+      try {
+        await this.load(entry.instance);
+      } catch (err) {
+        this._log.error(`Enable/load failed for '${name}':`, err.message);
       }
     }
-  }
 
-  async enable(name) {
-    const entry = this._plugins.get(name);
-    if (entry) {
-      entry.enabled = true;
-      this._log.info(`Plugin enabled: ${name}`);
-    }
+    this.framework?.emit('plugin:enabled', entry.instance);
+    this._saveState();
+    this._log.info(`Plugin '${name}' enabled`);
   }
 
+  /**
+   * 禁用插件
+   */
   async disable(name) {
     const entry = this._plugins.get(name);
-    if (entry) {
-      if (entry.instance.system) {
-        throw new PluginError(`Cannot disable system plugin '${name}'`);
+    if (!entry) {
+      throw new PluginNotFoundError(name);
+    }
+    if (entry.instance?.system) {
+      throw new PluginError(`Plugin '${name}' is a system plugin, cannot be disabled`);
+    }
+    if (!entry.enabled) {
+      this._log.info(`Plugin '${name}' already disabled`);
+      return;
+    }
+
+    entry.enabled = false;
+    if (entry.instance) {
+      entry.instance.enabled = false;
+    }
+
+    // 如果正在运行，停止
+    if (entry.instance._started) {
+      try {
+        if (typeof entry.instance.stopBot === 'function') {
+          await entry.instance.stopBot();
+        } else if (typeof entry.instance.stop === 'function') {
+          await entry.instance.stop();
+        }
+        entry.instance._started = false;
+      } catch (err) {
+        this._log.error(`Stop failed for '${name}':`, err.message);
       }
-      entry.enabled = false;
-      this._log.info(`Plugin disabled: ${name}`);
     }
+
+    this.framework?.emit('plugin:disabled', entry.instance);
+    this._saveState();
+    this._log.info(`Plugin '${name}' disabled`);
   }
 
   updatePluginConfig(name, config) {
@@ -235,26 +418,75 @@ class PluginManager {
     if (entry.instance.config) {
       Object.assign(entry.instance.config, config);
     }
+    this._saveState();
   }
 
-  registerEventDescription(eventType, description, schema = null) {
-    this._eventDescriptions.set(eventType, { description, schema });
+  setBootstrapping(val) {
+    this._bootstrapping = val !== false;
   }
 
-  getEventDescriptions() {
-    return new Map(this._eventDescriptions);
+  // ========== 状态持久化 ==========
+
+  _getStateFile() {
+    const dir = path.dirname(this._stateFile);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+    return this._stateFile;
   }
 
-  getEventDescription(eventType) {
-    return this._eventDescriptions.get(eventType) || null;
+  _saveState() {
+    try {
+      const stateFile = this._getStateFile();
+      let state = safeJsonParse(
+        fs.existsSync(stateFile) ? fs.readFileSync(stateFile, 'utf-8') : '{}',
+        {}
+      );
+      for (const [name, entry] of this._plugins) {
+        state[name] = {
+          enabled: entry.enabled,
+          config: entry.instance?.config || {},
+        };
+      }
+      fs.writeFileSync(stateFile, JSON.stringify(state, null, 2));
+      this._stateCache = state;
+    } catch (err) {
+      this._log.error('Failed to save state:', err.message);
+    }
   }
 
-  setBootstrapping(val) {
-    this._bootstrapping = val !== false;
+  _loadState() {
+    if (this._stateCache !== null) return this._stateCache;
+    try {
+      const stateFile = this._getStateFile();
+      if (fs.existsSync(stateFile)) {
+        this._stateCache = safeJsonParse(fs.readFileSync(stateFile, 'utf-8'), {});
+        return this._stateCache;
+      }
+    } catch (err) {
+      this._log.error('Failed to load state:', err.message);
+    }
+    this._stateCache = {};
+    return this._stateCache;
   }
 
   _setStateFile(cwd) {
     this._stateFile = path.join(cwd, '.foliko', 'data', 'plugins-state.json');
+    this._stateCache = null;
+  }
+
+  // ========== 事件描述 ==========
+
+  registerEventDescription(eventType, description, schema = null) {
+    this._eventDescriptions.set(eventType, { description, schema });
+  }
+
+  getEventDescriptions() {
+    return new Map(this._eventDescriptions);
+  }
+
+  getEventDescription(eventType) {
+    return this._eventDescriptions.get(eventType) || null;
   }
 }