foliko 1.1.89 → 1.1.91

package/package.json

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

package/plugins/default-plugins.js

@@ -14,7 +14,13 @@ const bootstrapLog = logger.child('Bootstrap')
  * 加载 .foliko 目录下的配置
  * 返回配置对象，可用于手动加载插件
  */
-function loadAgentConfig(agentDir = '.foliko') {
+function loadAgentConfig(framework, agentDir = '.foliko') {
+  // 向后兼容：旧调用 loadAgentConfig('.foliko') 时把 framework 当成 agentDir
+  if (typeof framework === 'string') {
+    agentDir = framework;
+    framework = null;
+  }
+
   const config = {
     agentDir,
     ai: {},
@@ -24,13 +30,9 @@ function loadAgentConfig(agentDir = '.foliko') {
     agentsDir: null,    // 子Agent配置目录
     pluginLinks: {}     // 外部插件链接 { "插件名": "外部路径" }
   }
-  const cmdDir=path.resolve(process.cwd())
-  const resolvedDir = path.resolve(process.cwd(), agentDir)
-
-  if (!fs.existsSync(resolvedDir)) {
-    //log.info(` .foliko directory not found: ${resolvedDir}`)
-    return config
-  }
+  const cwd = framework?.getCwd?.() ?? process.cwd()
+  const cmdDir = path.resolve(cwd)
+  const resolvedDir = path.resolve(cwd, agentDir)
 
   //log.info(` Loading config from: ${resolvedDir}`)
 
@@ -146,10 +148,10 @@ function loadAgentConfig(agentDir = '.foliko') {
 
   // 添加 .foliko/skills 目录（不存在则创建）
   const cmdskillsDir = path.join(cmdDir, 'skills')
-  if (fs.existsSync(resolvedDir) && !fs.existsSync(cmdskillsDir)) {
-    fs.mkdirSync(cmdskillsDir, { recursive: true })
-    //log.info(` Created skills directory: ${cmdskillsDir}`)
-  }
+  // if (fs.existsSync(resolvedDir) && !fs.existsSync(cmdskillsDir)) {
+  //   fs.mkdirSync(cmdskillsDir, { recursive: true })
+  //   //log.info(` Created skills directory: ${cmdskillsDir}`)
+  // }
   if (fs.existsSync(cmdskillsDir)) {
     config.skillsDirs.push(cmdskillsDir)
   }
@@ -167,6 +169,114 @@ function loadAgentConfig(agentDir = '.foliko') {
   //   config.skillsDirs.push(defaultSkillsDir)
   // }
 
+  // ============ HOME DIR (~/.foliko/) SCAN ============
+  // Home 是独立配置源：
+  //   - 单文件配置：项目不存在时 home 作为回退
+  //   - 多文件资源（skills/agents/plugins）：两个目录都扫描
+  const homeDir = framework?.getHomeAgentDir?.()
+  const isHomeSameAsProject = homeDir && path.resolve(homeDir) === resolvedDir
+  if (homeDir && fs.existsSync(homeDir) && !isHomeSameAsProject) {
+    // 单文件配置回退
+    const homeConfig = path.join(homeDir, 'config')
+    if (!fs.existsSync(path.join(resolvedDir, 'config')) && fs.existsSync(homeConfig)) {
+      try {
+        const lines = fs.readFileSync(homeConfig, 'utf-8').split('\n')
+        for (const line of lines) {
+          const trimmed = line.trim()
+          if (!trimmed || trimmed.startsWith('#')) continue
+          const colonIndex = trimmed.indexOf(':')
+          if (colonIndex === -1) continue
+          const key = trimmed.substring(0, colonIndex).trim()
+          const value = trimmed.substring(colonIndex + 1).trim()
+          if (key === 'ai_key' || key === 'api_key') {
+            if (!config.ai.apiKey) config.ai.apiKey = value
+          } else if (key === 'ai_model' || key === 'model') {
+            if (!config.ai.model) config.ai.model = value
+          } else if (key === 'ai_provider' || key === 'provider') {
+            if (!config.ai.provider) config.ai.provider = value
+          } else if (key === 'ai_base_url' || key === 'baseURL') {
+            if (!config.ai.baseURL) config.ai.baseURL = value
+          }
+        }
+      } catch (err) {
+        log.error(' Failed to load home config:', err.message)
+      }
+    }
+
+    const homeAi = path.join(homeDir, 'ai.json')
+    if (!fs.existsSync(path.join(resolvedDir, 'ai.json')) && fs.existsSync(homeAi)) {
+      try {
+        const homeObj = JSON.parse(fs.readFileSync(homeAi, 'utf-8'))
+        config.ai = { ...homeObj, ...config.ai }
+      } catch (err) {
+        log.error(' Failed to load home ai.json:', err.message)
+      }
+    }
+
+    const homePluginsFile = path.join(homeDir, 'plugins.json')
+    if (!fs.existsSync(path.join(resolvedDir, 'plugins.json')) && fs.existsSync(homePluginsFile)) {
+      try {
+        const pc = JSON.parse(fs.readFileSync(homePluginsFile, '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 (err) {
+        log.error(' Failed to load home plugins.json:', err.message)
+      }
+    }
+
+    const homeWeixin = path.join(homeDir, 'weixin.json')
+    if (!fs.existsSync(path.join(resolvedDir, 'weixin.json')) && fs.existsSync(homeWeixin)) {
+      try {
+        const w = JSON.parse(fs.readFileSync(homeWeixin, 'utf-8'))
+        config.weixin = { ...w, ...config.weixin }
+      } catch (err) {
+        log.error(' Failed to load home weixin.json:', err.message)
+      }
+    }
+
+    const homeMcp = path.join(homeDir, 'mcp_config.json')
+    if (!fs.existsSync(path.join(resolvedDir, 'mcp_config.json')) && fs.existsSync(homeMcp)) {
+      try {
+        const m = JSON.parse(fs.readFileSync(homeMcp, 'utf-8'))
+        config.mcpServers = { ...(m.mcpServers || {}), ...config.mcpServers }
+      } catch (err) {
+        log.error(' Failed to load home mcp_config.json:', err.message)
+      }
+    }
+
+    // agents 目录：home 仅在项目无 agentsDir 时生效
+    const homeAgentsDir = path.join(homeDir, 'agents')
+    if (!config.agentsDir && fs.existsSync(homeAgentsDir)) {
+      config.agentsDir = homeAgentsDir
+    }
+
+    // skills 目录：项目 .foliko/skills 之后插入 home
+    const homeSkillsDir = path.join(homeDir, 'skills')
+    if (!fs.existsSync(homeSkillsDir)) {
+      try { fs.mkdirSync(homeSkillsDir, { recursive: true }) } catch (err) { /* ignore */ }
+    }
+    if (fs.existsSync(homeSkillsDir)) {
+      const projectFolikoSkillsIdx = config.skillsDirs.findIndex(
+        d => d === path.join(resolvedDir, 'skills')
+      )
+      const insertAt = projectFolikoSkillsIdx >= 0
+        ? projectFolikoSkillsIdx + 1
+        : config.skillsDirs.length
+      config.skillsDirs.splice(insertAt, 0, homeSkillsDir)
+    }
+
+    // home plugins：扫描并加入 pluginLinks
+    const homePluginsDir = path.join(homeDir, 'plugins')
+    if (fs.existsSync(homePluginsDir)) {
+      for (const name of scanPluginNames(homePluginsDir)) {
+        const resolvedPlugin = resolvePluginPath(homePluginsDir, name)
+        if (resolvedPlugin) config.pluginLinks[name] = resolvedPlugin.path
+      }
+    }
+  }
+
   return config
 }
 
@@ -194,7 +304,7 @@ class DefaultPlugins extends Plugin {
 
   start(framework) {
     // 加载配置
-    this._config = loadAgentConfig(this._agentDir)
+    this._config = loadAgentConfig(this._framework, this._agentDir)
     return this
   }
 
@@ -202,12 +312,12 @@ class DefaultPlugins extends Plugin {
    * 获取加载的配置
    */
   getConfig() {
-    return this._config || loadAgentConfig(this._agentDir)
+    return this._config || loadAgentConfig(this._framework, this._agentDir)
   }
 
   reload(framework) {
     this._framework = framework
-    this._config = loadAgentConfig(this._agentDir)
+    this._config = loadAgentConfig(this._framework, this._agentDir)
   }
 
   uninstall(framework) {
@@ -510,15 +620,17 @@ function scanPluginNames(pluginsDir) {
 async function loadCustomPlugins(framework, agentConfig) {
   const { Plugin } = require('../src/core/plugin-base')
 
+  const cwd = framework?.getCwd?.() ?? process.cwd()
+
   // 加载两个目录下的自定义插件：
   // 1. .foliko/plugins/ - 用户自定义插件（强制启用）
   // 2. plugins/ - 项目内置插件（自动加载）
   const dirs = [
-    { dir: path.resolve(process.cwd(), '.foliko', 'plugins'), forceEnabled: true },
-    { dir: path.resolve(process.cwd(), 'plugins'), forceEnabled: false },
-    { dir: path.resolve(__dirname, '..', 'plugins'), forceEnabled: false }   
+    { dir: path.resolve(cwd, '.foliko', 'plugins'), forceEnabled: true },
+    { dir: path.resolve(cwd, 'plugins'), forceEnabled: false },
+    { dir: path.resolve(__dirname, '..', 'plugins'), forceEnabled: false }
     // 项目下的 plugins 目录（兼容旧版本）
-    
+
   ]
 
   for (const { dir, forceEnabled } of dirs) {

package/plugins/feishu-plugin.js

@@ -262,7 +262,7 @@ class FeishuPlugin extends Plugin {
     const agent = this._framework.createSessionAgent(`feishu_${openId}`, {
       systemPrompt: this.systemPrompt,
       sharedPrompt: `工作目录: {{WORK_DIR}}`,
-      metadata: { WORK_DIR: process.cwd() }
+      metadata: { WORK_DIR: this._framework?.getCwd?.() ?? process.cwd() }
     })
     this._sessionAgents.set(openId, agent)
 

package/plugins/file-system-plugin.js

@@ -26,7 +26,7 @@ class FileSystemPlugin extends Plugin {
     // 路径安全验证：防止路径穿越攻击
     const validatePath = (filePath, allowOutsideCwd = false) => {
       const resolved = path.resolve(filePath)
-      const cwd = process.cwd()
+      const cwd = framework?.getCwd?.() ?? process.cwd()
 
       // 允许绝对路径且在允许列表中的路径（如果有的话）
       if (allowOutsideCwd) {
@@ -51,6 +51,7 @@ class FileSystemPlugin extends Plugin {
         recursive: z.boolean().optional().describe('是否递归')
       }),
       execute: async (args, framework) => {
+        const cwd = framework?.getCwd?.() ?? process.cwd()
         const dirPath = args.path || args.dirPath || '.'
         const recursive = args.recursive || false
         try {
@@ -60,7 +61,7 @@ class FileSystemPlugin extends Plugin {
             const entries = fs.readdirSync(currentPath, { withFileTypes: true })
             for (const entry of entries) {
               const fullPath = path.join(currentPath, entry.name)
-              const relativePath = path.relative(process.cwd(), fullPath)
+              const relativePath = path.relative(cwd, fullPath)
               if (relativePath.includes('node_modules') || relativePath.includes('.git')) {
                 continue
               }
@@ -476,7 +477,7 @@ edits 数组可以包含多个不重叠的替换操作，每个操作通过 oldT
       execute: async (args, framework) => {
         const { path: filePath, edits } = args;
         const editDiff = require('../src/utils/edit-diff');
-        const result = await editDiff.applyEditsToFile(filePath, edits, process.cwd());
+        const result = await editDiff.applyEditsToFile(filePath, edits, framework?.getCwd?.() ?? process.cwd());
         return result;
       }
     };
@@ -509,7 +510,7 @@ edits 数组可以包含多个不重叠的替换操作，每个操作通过 oldT
       }),
       execute: async (args, framework) => {
         const pattern = args.pattern
-        const dirPath = args.path || process.cwd()
+        const dirPath = args.path || (framework?.getCwd?.() ?? process.cwd())
         const targetFile = args.file
         const fileType = args.fileType
         const maxResults = args.maxResults || 100
@@ -625,7 +626,7 @@ edits 数组可以包含多个不重叠的替换操作，每个操作通过 oldT
                 if (results.length >= maxResults) break
 
                 const fullPath = path.join(currentPath, entry.name)
-                const relativePath = path.relative(process.cwd(), fullPath)
+                const relativePath = path.relative(cwd, fullPath)
 
                 // 检查是否在排除目录中
                 const shouldExclude = excludeDirs.some(exclude =>
@@ -696,7 +697,7 @@ edits 数组可以包含多个不重叠的替换操作，每个操作通过 oldT
       }),
       execute: async (args, framework) => {
         const command = args.cmd || args.command || args.run
-        const cwd = args.cwd || process.cwd()
+        const cwd = args.cwd || (framework?.getCwd?.() ?? process.cwd())
         const timeout = Math.min(args.timeout || 30000, 120000) // 最多 2 分钟
 
         // 验证命令：检查危险的 shell 模式
@@ -762,7 +763,7 @@ edits 数组可以包含多个不重叠的替换操作，每个操作通过 oldT
       }),
       execute: async (args, framework) => {
         const command = args.cmd || args.command
-        const cwd = args.cwd || process.cwd()
+        const cwd = args.cwd || (framework?.getCwd?.() ?? process.cwd())
         const timeout = Math.min(args.timeout || 30000, 120000)
 
         if (!command) {

package/plugins/install-plugin.js

@@ -30,6 +30,8 @@ class InstallPlugin extends Plugin {
 
   start(framework) {
     // 确保 node_modules 目录存在
+    const cwd = this._framework?.getCwd?.() ?? process.cwd()
+    this._agentDir = path.resolve(cwd, this._agentDir)
     this._nodeModulesDir = path.join(this._agentDir, 'node_modules')
     if (!fs.existsSync(this._nodeModulesDir)) {
       fs.mkdirSync(this._nodeModulesDir, { recursive: true })
@@ -46,10 +48,11 @@ class InstallPlugin extends Plugin {
       }),
       execute: async (args) => {
         const { package: packageName, path: targetPath, file: packageJsonPath } = args
+        const cwd = this._framework?.getCwd?.() ?? process.cwd()
 
         // 优先处理 file 参数（从 package.json 安装）
         if (packageJsonPath) {
-          const resolvedPath = path.resolve(process.cwd(), packageJsonPath)
+          const resolvedPath = path.resolve(cwd, packageJsonPath)
           return this._installFromPackageJson(resolvedPath, targetPath)
         }
 
@@ -60,7 +63,7 @@ class InstallPlugin extends Plugin {
 
         // 只有 path，安装该目录的 package.json
         if (targetPath) {
-          const resolvedPath = path.resolve(process.cwd(), targetPath)
+          const resolvedPath = path.resolve(cwd, targetPath)
           const pkgJson = path.join(resolvedPath, 'package.json')
           if (fs.existsSync(pkgJson)) {
             return this._installFromPackageJson(pkgJson, targetPath)
@@ -68,7 +71,7 @@ class InstallPlugin extends Plugin {
           return { success: false, error: `package.json not found at ${pkgJson}` }
         }
 
-        // 什么都不提供，报错
+        // 都不提供，报错
         return { success: false, error: 'Must provide package name or package.json path' }
       }
     })
@@ -83,8 +86,9 @@ class InstallPlugin extends Plugin {
    */
   _installPackage(packageName, targetPath = null) {
     try {
+      const cwd = this._framework?.getCwd?.() ?? process.cwd()
       const installPath = targetPath
-        ? path.resolve(process.cwd(), targetPath)
+        ? path.resolve(cwd, targetPath)
         : this._agentDir
 
       //log.info(` Installing ${packageName} to ${installPath}...`)
@@ -121,10 +125,11 @@ class InstallPlugin extends Plugin {
    */
   _installFromPackageJson(packageJsonPath, targetPath = null) {
     try {
-      const resolvedPkgPath = path.resolve(process.cwd(), packageJsonPath)
+      const cwd = this._framework?.getCwd?.() ?? process.cwd()
+      const resolvedPkgPath = path.resolve(cwd, packageJsonPath)
       const pkgDir = path.dirname(resolvedPkgPath)
       const installPath = targetPath
-        ? path.resolve(process.cwd(), targetPath)
+        ? path.resolve(cwd, targetPath)
         : pkgDir
 
       //log.info(` Installing dependencies from ${resolvedPkgPath} to ${installPath}...`)

package/plugins/memory-plugin.js

@@ -210,9 +210,9 @@ function _extractJSON(text) {
  * MemoryStore - 双层存储（内存 + 文件）
  */
 class MemoryStore extends EventEmitter {
-  constructor(baseDir) {
+  constructor(baseDir, cwd) {
     super()
-    this._baseDir = path.resolve(process.cwd(), baseDir)
+    this._baseDir = path.resolve(cwd ?? process.cwd(), baseDir)
     this._memory = new Map() // memoryId -> memory object
     this._indexByType = new Map() // type -> Set of memoryIds
     this._indexByProject = new Map() // project -> Set of memoryIds
@@ -573,7 +573,7 @@ class MemoryPlugin extends Plugin {
 
   start(framework) {
     // 初始化存储
-    this._store = new MemoryStore(this.config.memoryDir)
+    this._store = new MemoryStore(this.config.memoryDir, this._framework?.getCwd?.())
 
     // 创建复用的记忆提取子 Agent
     this._memoryAgent = framework.createSubAgent({
@@ -1276,7 +1276,7 @@ ${prompt}`
   reload(framework) {
     this._framework = framework
     // 重新初始化存储
-    this._store = new MemoryStore(this.config.memoryDir)
+    this._store = new MemoryStore(this.config.memoryDir, this._framework?.getCwd?.())
   }
 
   uninstall(framework) {

package/plugins/plugin-manager-plugin.js

@@ -212,8 +212,9 @@ class PluginManagerPlugin extends Plugin {
    * 发布插件到远程仓库
    */
   async _publishPlugin(pluginName, repo) {
-    const pluginsDir = path.resolve(process.cwd(), '.foliko', 'plugins');
-    const localPluginsDir = path.resolve(process.cwd(), 'plugins');
+    const cwd = this._framework?.getCwd?.() ?? process.cwd();
+    const pluginsDir = path.resolve(cwd, '.foliko', 'plugins');
+    const localPluginsDir = path.resolve(cwd, 'plugins');
 
     // 确定插件目录
     let actualPluginsDir = pluginsDir;
@@ -251,7 +252,7 @@ class PluginManagerPlugin extends Plugin {
 
       let isNewRepo = false;
       try {
-        gitCommand(`clone ${repo} "${tmpDir}" --depth 1`, process.cwd());
+        gitCommand(`clone ${repo} "${tmpDir}" --depth 1`, this._framework?.getCwd?.() ?? process.cwd());
       } catch (err) {
         //log.info('Initializing new repository...');
         fs.mkdirSync(tmpDir, { recursive: true });
@@ -331,7 +332,8 @@ class PluginManagerPlugin extends Plugin {
    * 从远程仓库安装插件
    */
   async _installPlugin(pluginName, repo) {
-    const localPluginsDir = path.resolve(process.cwd(), '.foliko', 'plugins');
+    const cwd = this._framework?.getCwd?.() ?? process.cwd();
+    const localPluginsDir = path.resolve(cwd, '.foliko', 'plugins');
     const tmpDir = path.join(require('os').tmpdir(), `foliko-plugin-install-${Date.now()}`);
 
     try {
@@ -339,7 +341,7 @@ class PluginManagerPlugin extends Plugin {
 
       // 克隆仓库
       fs.mkdirSync(tmpDir, { recursive: true });
-      gitCommand(`clone ${repo} "${tmpDir}" --depth 1`, process.cwd());
+      gitCommand(`clone ${repo} "${tmpDir}" --depth 1`, cwd);
 
       // 查找插件
       const pluginDir = path.join(tmpDir, pluginName);

package/plugins/qq-plugin.js

@@ -49,11 +49,7 @@ class QQPlugin extends Plugin {
     this.agent = null
     this.sessionId = null
 
-    const saveDir = path.join(process.cwd(), '.foliko', 'data', this.name)
-    this.downloader = new FileDownloader({
-      retries: 3,
-      baseDir: saveDir
-    })
+    this.downloader = null
 
     this.systemPrompt = `你是一个 QQ 助手。
 
@@ -70,6 +66,13 @@ class QQPlugin extends Plugin {
 
   install(framework) {
     this._framework = framework
+    if (!this.downloader) {
+      const saveDir = path.join(this._framework?.getCwd?.() ?? process.cwd(), '.foliko', 'data', this.name)
+      this.downloader = new FileDownloader({
+        retries: 3,
+        baseDir: saveDir
+      })
+    }
     this._registerTools()
     return this
   }
@@ -527,7 +530,7 @@ class QQPlugin extends Plugin {
       name: `qq_${identifier}`,
       systemPrompt: this.systemPrompt,
       sharedPrompt: `工作目录: {{WORK_DIR}}`,
-      metadata: { WORK_DIR: process.cwd(), platform: 'qq', identifier }
+      metadata: { WORK_DIR: this._framework?.getCwd?.() ?? process.cwd(), platform: 'qq', identifier }
     })
 
     this._sessionAgents.set(identifier, agent)

package/plugins/rules-plugin.js

@@ -168,7 +168,7 @@ class RulesPlugin extends Plugin {
    * 从目录加载规则文件
    */
   loadFromDirectory(rulesDir) {
-    const resolvedDir = path.resolve(process.cwd(), rulesDir)
+    const resolvedDir = path.resolve(this._framework?.getCwd?.() ?? process.cwd(), rulesDir)
 
     if (!fs.existsSync(resolvedDir)) {
       //log.info(` Rules directory not found: ${resolvedDir}`)

package/plugins/session-plugin.js

@@ -16,7 +16,7 @@ const { buildSessionContext, EntryTypes } = require('../src/core/session-entry')
  * Get default session directory for a cwd
  */
 function getDefaultSessionDir(cwd) {
-  const agentDir = path.join(process.cwd(), '.foliko');
+  const agentDir = path.join(cwd, '.foliko');
   const sessionDir = path.join(agentDir, 'sessions');
   return sessionDir;
 }
@@ -54,10 +54,18 @@ class SessionPlugin extends Plugin {
     return this;
   }
 
+  /**
+   * 获取当前工作目录(framework.getCwd() 优先, fallback 到 process.cwd())
+   */
+  _defaultCwd() {
+    return this._framework?.getCwd?.() ?? process.cwd();
+  }
+
   /**
    * Get or create a SessionManager for a session
    */
-  _getSessionManager(sessionId, cwd = process.cwd()) {
+  _getSessionManager(sessionId, cwd) {
+    cwd = cwd ?? this._defaultCwd();
     if (this._sessionManagers.has(sessionId)) {
       return this._sessionManagers.get(sessionId);
     }
@@ -72,7 +80,7 @@ class SessionPlugin extends Plugin {
   /**
    * List all sessions for current cwd
    */
-  async listSessions(cwd = process.cwd()) {
+  async listSessions(cwd = this._defaultCwd()) {
     const sessionDir = getDefaultSessionDir(cwd);
     const sessions = [];
 
@@ -115,7 +123,7 @@ class SessionPlugin extends Plugin {
         cwd: z.string().optional().describe('工作目录')
       }),
       execute: async (args, fw) => {
-        const cwd = args.cwd || process.cwd();
+        const cwd = args.cwd || this._defaultCwd();
         const sessionDir = getDefaultSessionDir(cwd);
         const manager = new SessionManager(cwd, sessionDir, undefined, true);
         const sessionId = manager.getSessionId();
@@ -140,7 +148,7 @@ class SessionPlugin extends Plugin {
         cwd: z.string().optional().describe('工作目录')
       }),
       execute: async (args) => {
-        const cwd = args.cwd || process.cwd();
+        const cwd = args.cwd || this._defaultCwd();
         const manager = this._getSessionManager(args.sessionId, cwd);
         const entries = manager.getEntries();
 
@@ -163,7 +171,7 @@ class SessionPlugin extends Plugin {
         cwd: z.string().optional().describe('工作目录')
       }),
       execute: async (args) => {
-        const cwd = args.cwd || process.cwd();
+        const cwd = args.cwd || this._defaultCwd();
         const sessions = await this.listSessions(cwd);
         return {
           success: true,
@@ -181,7 +189,7 @@ class SessionPlugin extends Plugin {
         cwd: z.string().optional().describe('工作目录')
       }),
       execute: async (args) => {
-        const cwd = args.cwd || process.cwd();
+        const cwd = args.cwd || this._defaultCwd();
         const manager = this._getSessionManager(args.sessionId, cwd);
 
         if (manager.getSessionFile() && require('fs').existsSync(manager.getSessionFile())) {
@@ -203,7 +211,7 @@ class SessionPlugin extends Plugin {
         limit: z.number().optional().describe('返回消息数量限制')
       }),
       execute: async (args) => {
-        const cwd = args.cwd || process.cwd();
+        const cwd = args.cwd || this._defaultCwd();
         const manager = this._getSessionManager(args.sessionId, cwd);
         const context = manager.buildSessionContext();
         let messages = context.messages;
@@ -233,7 +241,7 @@ class SessionPlugin extends Plugin {
         cwd: z.string().optional().describe('工作目录')
       }),
       execute: async (args) => {
-        const cwd = args.cwd || process.cwd();
+        const cwd = args.cwd || this._defaultCwd();
         const manager = this._getSessionManager(args.sessionId, cwd);
 
         try {
@@ -262,7 +270,7 @@ class SessionPlugin extends Plugin {
         cwd: z.string().optional().describe('工作目录')
       }),
       execute: async (args) => {
-        const cwd = args.cwd || process.cwd();
+        const cwd = args.cwd || this._defaultCwd();
         const manager = this._getSessionManager(args.sessionId, cwd);
 
         try {
@@ -307,7 +315,7 @@ class SessionPlugin extends Plugin {
   /**
    * Add message to session
    */
-  addMessage(sessionId, message, cwd = process.cwd()) {
+  addMessage(sessionId, message, cwd = this._defaultCwd()) {
     const manager = this._getSessionManager(sessionId, cwd);
     const entryId = manager.appendMessage(message);
 
@@ -322,7 +330,7 @@ class SessionPlugin extends Plugin {
   /**
    * Get session context for LLM
    */
-  getSessionContext(sessionId, cwd = process.cwd()) {
+  getSessionContext(sessionId, cwd = this._defaultCwd()) {
     const manager = this._getSessionManager(sessionId, cwd);
     return manager.buildSessionContext();
   }
@@ -330,14 +338,14 @@ class SessionPlugin extends Plugin {
   /**
    * Get or create session (alias for getSessionContext)
    */
-  getOrCreateSession(sessionId, options = {}, cwd = process.cwd()) {
+  getOrCreateSession(sessionId, options = {}, cwd = this._defaultCwd()) {
     return this.getSessionContext(sessionId, cwd);
   }
 
   /**
    * Get specific entry
    */
-  getEntry(sessionId, entryId, cwd = process.cwd()) {
+  getEntry(sessionId, entryId, cwd = this._defaultCwd()) {
     const manager = this._getSessionManager(sessionId, cwd);
     return manager.getEntry(entryId);
   }
@@ -345,7 +353,7 @@ class SessionPlugin extends Plugin {
   /**
    * Get branch (path from root to leaf)
    */
-  getBranch(sessionId, fromId, cwd = process.cwd()) {
+  getBranch(sessionId, fromId, cwd = this._defaultCwd()) {
     const manager = this._getSessionManager(sessionId, cwd);
     return manager.getBranch(fromId);
   }
@@ -353,7 +361,7 @@ class SessionPlugin extends Plugin {
   /**
    * Append compaction entry
    */
-  appendCompaction(sessionId, summary, firstKeptEntryId, tokensBefore, details, cwd = process.cwd()) {
+  appendCompaction(sessionId, summary, firstKeptEntryId, tokensBefore, details, cwd = this._defaultCwd()) {
     const manager = this._getSessionManager(sessionId, cwd);
     return manager.appendCompaction(summary, firstKeptEntryId, tokensBefore, details, false);
   }
@@ -361,7 +369,7 @@ class SessionPlugin extends Plugin {
   /**
    * Append thinking level change
    */
-  appendThinkingLevelChange(sessionId, thinkingLevel, cwd = process.cwd()) {
+  appendThinkingLevelChange(sessionId, thinkingLevel, cwd = this._defaultCwd()) {
     const manager = this._getSessionManager(sessionId, cwd);
     return manager.appendThinkingLevelChange(thinkingLevel);
   }
@@ -369,7 +377,7 @@ class SessionPlugin extends Plugin {
   /**
    * Append model change
    */
-  appendModelChange(sessionId, provider, modelId, cwd = process.cwd()) {
+  appendModelChange(sessionId, provider, modelId, cwd = this._defaultCwd()) {
     const manager = this._getSessionManager(sessionId, cwd);
     return manager.appendModelChange(provider, modelId);
   }
@@ -377,7 +385,7 @@ class SessionPlugin extends Plugin {
   /**
    * Set session label
    */
-  setLabel(sessionId, entryId, label, cwd = process.cwd()) {
+  setLabel(sessionId, entryId, label, cwd = this._defaultCwd()) {
     const manager = this._getSessionManager(sessionId, cwd);
     return manager.appendLabelChange(entryId, label);
   }
@@ -385,7 +393,7 @@ class SessionPlugin extends Plugin {
   /**
    * Get session info (compatible with external callers)
    */
-  getSession(sessionId, cwd = process.cwd()) {
+  getSession(sessionId, cwd = this._defaultCwd()) {
     const manager = this._getSessionManager(sessionId, cwd);
     const entries = manager.getEntries();
     return {
@@ -414,8 +422,9 @@ class SessionPlugin extends Plugin {
   async _doCleanup() {
     try {
       const fs = require('fs');
-      const sessionDir = getDefaultSessionDir(process.cwd());
-      
+      const cwd = this._defaultCwd();
+      const sessionDir = getDefaultSessionDir(cwd);
+
       if (!fs.existsSync(sessionDir)) {
         return;
       }
@@ -426,7 +435,7 @@ class SessionPlugin extends Plugin {
       for (const file of files) {
         const filePath = path.join(sessionDir, file);
         try {
-          const manager = SessionManager.open(filePath, sessionDir, process.cwd());
+          const manager = SessionManager.open(filePath, sessionDir, cwd);
           const entries = manager.getEntries();
           
           // Clean up if exceeds maxHistoryLength

package/plugins/shell-executor-plugin.js

@@ -19,7 +19,7 @@ class ShellExecutorPlugin extends Plugin {
 
     this.config = {
       timeout: config.timeout || 60000,
-      workingDir: config.workingDir || process.cwd()
+      workingDir: config.workingDir
     }
 
     this._framework = null
@@ -27,6 +27,9 @@ class ShellExecutorPlugin extends Plugin {
 
   install(framework) {
     this._framework = framework
+    if (!this.config.workingDir) {
+      this.config.workingDir = framework?.getCwd?.() ?? process.cwd()
+    }
     return this
   }
 

package/plugins/storage-plugin.js

@@ -44,7 +44,7 @@ class StoragePlugin extends Plugin {
   _initStorage() {
     if (this._storageManager) return;
 
-    const baseDir = path.resolve(process.cwd(), this.config.path);
+    const baseDir = path.resolve(this._framework?.getCwd?.() ?? process.cwd(), this.config.path);
     const filePath = path.join(baseDir, `${this.config.namespace}.jsonl`);
 
     // 传递 compaction 配置

package/plugins/subagent-plugin.js

@@ -587,7 +587,7 @@ class SubAgentManagerPlugin extends Plugin {
    */
   _loadAgentsFromDir() {
     // 默认使用 .foliko/agents 目录
-    const agentsDir = this.config.agentsDir || path.join(process.cwd(), '.foliko', 'agents')
+    const agentsDir = this.config.agentsDir || path.join(this._framework?.getCwd?.() ?? process.cwd(), '.foliko', 'agents')
     //log.info(' _loadAgentsFromDir called, agentsDir:', agentsDir)
     if (!fs.existsSync(agentsDir)) {
       //log.info(' agentsDir not found or does not exist')

package/plugins/telegram-plugin.js

@@ -254,7 +254,7 @@ class TelegramPlugin extends Plugin {
     const agent = this._framework.createSessionAgent(`telegram_${chatId}`, {
       systemPrompt: this.systemPrompt,
       sharedPrompt: `工作目录: {{WORK_DIR}}`,
-      metadata: { WORK_DIR: process.cwd() }
+      metadata: { WORK_DIR: this._framework?.getCwd?.() ?? process.cwd() }
     })
     this._sessionAgents.set(chatId, agent)
 
@@ -477,7 +477,7 @@ class TelegramPlugin extends Plugin {
   async _downloadFile(fileId, ext, subDir) {
     const path = require('path')
     const fs = require('fs')
-    const saveDir = path.join(process.cwd(), '.foliko', 'data', subDir)
+    const saveDir = path.join(this._framework?.getCwd?.() ?? process.cwd(), '.foliko', 'data', subDir)
     if (!fs.existsSync(saveDir)) fs.mkdirSync(saveDir, { recursive: true })
 
     const fileName = `${Date.now()}_${Math.random().toString(36).substring(7)}.${ext}`

package/plugins/weixin-plugin.js

@@ -63,17 +63,20 @@ class WeixinPlugin extends Plugin {
     this._initialized = false
     // 预创建的 sessionScope 监听器（避免每次消息都创建/销毁）
     this._sessionScopes = new Map()
-    const saveDir = path.join(process.cwd(), '.foliko', 'data', this.name)
-    this.downloader=new FileDownloader({
-      retries: 3,
-      baseDir:saveDir
-    })
+    this.downloader = null
     this.agent=null
     this.sessionId=null
   }
 
   install(framework) {
     this._framework = framework
+    if (!this.downloader) {
+      const saveDir = path.join(this._framework?.getCwd?.() ?? process.cwd(), '.foliko', 'data', this.name)
+      this.downloader = new FileDownloader({
+        retries: 3,
+        baseDir: saveDir
+      })
+    }
     // 注册微信发送工具
     this._registerTools()
     return this
@@ -473,7 +476,7 @@ class WeixinPlugin extends Plugin {
       name: `weixin_${userId}`,
       systemPrompt: this.systemPrompt,
       sharedPrompt: `工作目录: {{WORK_DIR}}`,
-      metadata: { WORK_DIR: process.cwd() }
+      metadata: { WORK_DIR: this._framework?.getCwd?.() ?? process.cwd() }
     })
     
     this._sessionAgents.set(userId, agent)

package/src/capabilities/skill-manager.js

@@ -247,7 +247,7 @@ class Skill {
               sessionId: framework?._currentSessionId || 'unknown',
               agent: null,
               framework: framework,
-              cwd: process.cwd(), // 工作目录，用于路径解析
+              cwd: framework?.getCwd?.() ?? process.cwd(), // 工作目录，用于路径解析
             };
             // 支持 argumentParser 先解析参数
             let parsedArgs = toolArgs.command || '';
@@ -520,8 +520,9 @@ class SkillManagerPlugin extends Plugin {
     let totalLoaded = 0;
 
     // 1. 扫描 skillsDirs
+    const baseCwd = this._framework?.getCwd?.() ?? process.cwd();
     for (const skillsDir of this._skillsDirs) {
-      const resolvedDir = path.resolve(process.cwd(), skillsDir);
+      const resolvedDir = path.resolve(baseCwd, skillsDir);
 
       if (!fs.existsSync(resolvedDir)) {
         continue;

package/src/capabilities/workflow-engine.js

@@ -881,7 +881,8 @@ class WorkflowPlugin extends Plugin {
    * 加载目录中的工作流定义
    */
   _loadWorkflows() {
-    const dir = path.resolve(process.cwd(), this._workflowsDir);
+    const cwd = this._framework?.getCwd?.() ?? process.cwd();
+    const dir = path.resolve(cwd, this._workflowsDir);
     if (!fs.existsSync(dir)) {
       fs.mkdirSync(dir, { recursive: true });
       // log.info(` Created workflows directory: ${dir}`);

package/src/core/agent-chat.js

@@ -475,7 +475,7 @@ class AgentChatHandler extends EventEmitter {
       if (!this._aiClient) {
         throw new Error('AI client not configured.');
       }
-
+      this._validateToolCalls(messages);
       const systemPrompt = framework.getSystemPrompt();
       //await fs.promises.writeFile(`.${sessionId}_systemPrompt.md`, systemPrompt); // 调试用：保存系统提示词
       const tools = this._getAITools(aiTool);
@@ -650,6 +650,7 @@ class AgentChatHandler extends EventEmitter {
       if (!this._aiClient) {
         throw new Error('AI client not configured.');
       }
+      this._validateToolCalls(messages);
       const systemPrompt = framework.getSystemPrompt();
       const tools = this._getAITools(aiTool);
 

package/src/core/agent.js

@@ -172,7 +172,7 @@ class Agent extends EventEmitter {
     switch (key) {
       case 'WORK_DIR':
       case 'CWD':
-        return process.cwd();
+        return this.framework?.getCwd?.() ?? process.cwd();
       case 'HOME_DIR':
         return os.homedir();
       case 'HOST_NAME':

package/src/core/constants.js

@@ -122,6 +122,9 @@ const SYSTEM_PLUGINS = new Set([
 /** Agent 配置目录名 */
 const AGENT_DIR = '.foliko';
 
+/** 用户主目录下 Agent 配置目录名 */
+const HOME_AGENT_DIR_NAME = '.foliko';
+
 // ============================================================================
 // Session 存储
 // ============================================================================
@@ -186,6 +189,7 @@ module.exports = {
   DEFAULT_PLUGIN_PRIORITY,
   SYSTEM_PLUGINS,
   AGENT_DIR,
+  HOME_AGENT_DIR_NAME,
 
   // Storage
   DEFAULT_SESSION_STORAGE_TYPE,

package/src/core/framework.js

@@ -4,6 +4,7 @@
  */
 
 const path = require('path');
+const os = require('os');
 const { AsyncLocalStorage } = require('async_hooks');
 const { EventEmitter } = require('../utils/event-emitter');
 const { PluginManager } = require('./plugin-manager');
@@ -15,6 +16,7 @@ const { ContextManager } = require('./context-manager');
 const { SessionManager } = require('./session-manager');
 const { CoordinatorManager } = require('./coordinator-manager');
 const { Logger, LOG_LEVELS } = require('../utils/logger');
+const { AGENT_DIR, HOME_AGENT_DIR_NAME, SYSTEM_PLUGINS } = require('./constants');
 // 创建一个连接到 Framework 的 logger
 function createFrameworkLogger(framework) {
   const logger = new Logger({ namespace: 'foliko' });
@@ -92,6 +94,10 @@ class Framework extends EventEmitter {
   /**
    * @param {Object} config - 配置
    * @param {boolean} [config.debug=false] - 调试模式
+   * @param {boolean} [config.silent=false] - 是否静默（不输出日志）
+   * @param {string} [config.cwd] - 初始工作目录（默认 process.cwd()，可后续用 setCwd 切换）
+   * @param {string} [config.agentDir='.foliko'] - 项目级 Agent 目录名
+   * @param {string} [config.homeAgentDir] - 用户级 Agent 目录（默认 ~/.foliko，可被 FOLIKO_HOME 环境变量覆盖）
    */
   constructor(config = {}) {
     super();
@@ -130,6 +136,15 @@ class Framework extends EventEmitter {
       baseDir: '.foliko/sessions',
     };
 
+    // 工作目录与 Agent 目录
+    this._cwd = config.cwd || process.cwd();
+    this._agentDir = config.agentDir || AGENT_DIR;
+    this._homeAgentDir =
+      config.homeAgentDir ||
+      process.env.FOLIKO_HOME ||
+      path.join(os.homedir(), HOME_AGENT_DIR_NAME);
+    this._changingCwd = false;
+
     // 注册 logger 到 framework
     this.logger = createFrameworkLogger(this);
 
@@ -525,7 +540,7 @@ class Framework extends EventEmitter {
     }
 
     // 获取工作目录
-    const cwd = options.cwd || process.cwd();
+    const cwd = options.cwd || this._cwd;
     const sessionDir = path.join(cwd, '.foliko', 'sessions');
 
     // 获取或创建 session file path
@@ -567,7 +582,7 @@ class Framework extends EventEmitter {
       return manager;
     }
 
-    const cwd = options.cwd || process.cwd();
+    const cwd = options.cwd || this._cwd;
     const sessionDir = path.join(cwd, '.foliko', 'sessions');
     const sessionFile = path.join(sessionDir, `${sessionId}.jsonl`);
 
@@ -673,6 +688,230 @@ class Framework extends EventEmitter {
     return this;
   }
 
+  // ============================================================================
+  // 工作目录与 Agent 目录
+  // ============================================================================
+
+  /**
+   * 获取当前工作目录
+   * @returns {string}
+   */
+  getCwd() {
+    return this._cwd;
+  }
+
+  /**
+   * 获取项目级 Agent 目录（绝对路径）
+   * @returns {string}
+   */
+  getAgentDir() {
+    return path.resolve(this._cwd, this._agentDir);
+  }
+
+  /**
+   * 获取用户级 Agent 目录（绝对路径）
+   * @returns {string}
+   */
+  getHomeAgentDir() {
+    return this._homeAgentDir;
+  }
+
+  /**
+   * 解析项目级 Agent 目录下的相对路径
+   * @param  {...string} parts
+   * @returns {string}
+   */
+  resolveAgentPath(...parts) {
+    return path.join(this.getAgentDir(), ...parts);
+  }
+
+  /**
+   * 解析用户级 Agent 目录下的相对路径
+   * @param  {...string} parts
+   * @returns {string}
+   */
+  resolveHomeAgentPath(...parts) {
+    return path.join(this.getHomeAgentDir(), ...parts);
+  }
+
+  /**
+   * 动态切换工作目录
+   *
+   * 切换后会自动:
+   *   1. 更新 PluginManager 状态文件位置
+   *   2. 销毁已存在的 Session 上下文（旧路径失效）
+   *   3. 通知所有已加载插件（onCwdChanged 钩子）并触发 reload
+   *   4. 发送 cwd:changed 事件
+   *
+   * @param {string} newCwd - 新工作目录（相对或绝对路径）
+   * @param {Object} [options]
+   * @param {boolean} [options.reload=true] - 是否自动重载已加载插件
+   * @param {string} [options.agentDir] - 顺带覆盖项目 agent 目录名
+   * @param {string} [options.homeAgentDir] - 顺带覆盖用户 agent 目录路径
+   * @returns {Promise<this>}
+   */
+  async setCwd(newCwd, options = {}) {
+    if (this._changingCwd) {
+      throw new Error('setCwd re-entered during cwd change');
+    }
+
+    const oldCwd = this._cwd;
+    const resolved = path.resolve(newCwd);
+    if (resolved === oldCwd) {
+      return this;
+    }
+
+    this._changingCwd = true;
+    try {
+      this._cwd = resolved;
+      if (options.agentDir) this._agentDir = options.agentDir;
+      if (options.homeAgentDir) this._homeAgentDir = options.homeAgentDir;
+
+      // 1. 更新 PluginManager 状态文件位置
+      this.pluginManager._setStateFile(resolved);
+
+      // 2. 销毁已存在的 Session 上下文（旧路径失效）
+      const count = this._sessionContexts.size;
+      for (const sid of Array.from(this._sessionContexts.keys())) {
+        this.destroySessionContext(sid);
+      }
+      this.emit('session:contexts-invalidated', { oldCwd, newCwd: resolved, count });
+
+      // 3. 通知已加载插件 + 触发 reload
+      if (options.reload !== false) {
+        for (const entry of this.pluginManager.getAll()) {
+          const inst = entry.instance;
+          try {
+            if (typeof inst?.onCwdChanged === 'function') {
+              await inst.onCwdChanged(oldCwd, resolved, this);
+            }
+            await this.pluginManager.reload(entry.name);
+          } catch (err) {
+            this.logger.warn(`Plugin ${entry.name} failed during cwd change: ${err.message}`);
+          }
+        }
+      }
+
+      // 4. 发送 cwd:changed 事件
+      this.emit('cwd:changed', { oldCwd, newCwd: resolved, framework: this });
+    } finally {
+      this._changingCwd = false;
+    }
+    return this;
+  }
+
+  // ============================================================================
+  // 项目重扫 — 重新扫描当前 cwd 下的插件与技能
+  // ============================================================================
+
+  /**
+   * 重新扫描当前 cwd 下的插件与技能目录
+   *
+   * 工作流程:
+   *   1. 卸载 keepLoaded 列表外的所有已加载插件
+   *   2. 重新读取 DefaultPlugins 配置（新的 skillsDirs / agentsDir / pluginLinks）
+   *   3. 重新跑 bootstrapDefaults 加载所有默认插件（核心 + 自定义）
+   *   4. 同步 SkillManager._skillsDirs 并触发技能重扫
+   *   5. 发出 rescan:complete 事件
+   *
+   * 典型用法: 配合 setCwd 切换到新项目
+   *   await framework.setCwd('D:/new-project');
+   *   await framework.rescanProject();
+   *
+   * @param {Object} [options]
+   * @param {string[]} [options.keepLoaded] - 保留的插件名列表（默认保留系统插件）
+   * @param {boolean} [options.reloadKept=false] - 是否对 keepLoaded 中的插件也执行 reload
+   * @param {boolean} [options.reloadSkillManager=true] - 是否重扫技能
+   * @returns {Promise<{unloaded: string[], loaded: string[], keepLoaded: string[]}>}
+   */
+  async rescanProject(options = {}) {
+    const { bootstrapDefaults, DefaultPlugins, loadAgentConfig } = require('../../plugins/default-plugins');
+    const keepList = options.keepLoaded || Array.from(SYSTEM_PLUGINS);
+    const keepSet = new Set(keepList);
+    const unloadList = [];
+    const loadList = [];
+
+    // 1. 卸载 keepSet 之外的插件
+    for (const entry of Array.from(this.pluginManager.getAll())) {
+      if (keepSet.has(entry.name)) continue;
+      const name = entry.name;
+      try {
+        await this.pluginManager.unload(name);
+        // 同步从注册表移除,避免 bootstrapDefaults 的 has() 跳过
+        this.pluginManager._plugins.delete(name);
+        unloadList.push(name);
+      } catch (err) {
+        this.logger.warn(`rescanProject: failed to unload ${name}: ${err.message}`);
+      }
+    }
+
+    // 2. 确保 defaults 插件已加载,重新读取配置
+    let defaultsPlugin = this.pluginManager.get('defaults');
+    if (!defaultsPlugin) {
+      const dp = new DefaultPlugins({ agentDir: this._agentDir });
+      try {
+        await this.loadPlugin(dp);
+        defaultsPlugin = dp;
+      } catch (err) {
+        this.logger.warn(`rescanProject: failed to load defaults: ${err.message}`);
+      }
+    } else {
+      try {
+        await defaultsPlugin.reload(this);
+      } catch (err) {
+        this.logger.warn(`rescanProject: failed to reload defaults: ${err.message}`);
+      }
+    }
+    const agentConfig = defaultsPlugin
+      ? defaultsPlugin.getConfig() || loadAgentConfig(this, this._agentDir)
+      : loadAgentConfig(this, this._agentDir);
+
+    // 3. 跑 bootstrapDefaults 加载默认插件（核心 + 自定义）
+    const beforeNames = new Set(this.pluginManager.getAll().map((p) => p.name));
+    try {
+      await bootstrapDefaults(this, { _config: agentConfig, _skipConfigLoad: true });
+    } catch (err) {
+      this.logger.warn(`rescanProject: bootstrapDefaults failed: ${err.message}`);
+    }
+    for (const name of this.pluginManager.getAll().map((p) => p.name)) {
+      if (!beforeNames.has(name)) loadList.push(name);
+    }
+
+    // 4. 同步并重扫技能
+    if (options.reloadSkillManager !== false) {
+      const skillManager = this.pluginManager.get('skill-manager');
+      if (skillManager) {
+        if (Array.isArray(agentConfig.skillsDirs)) {
+          skillManager._skillsDirs = agentConfig.skillsDirs;
+        }
+        try {
+          await skillManager.reload(this);
+        } catch (err) {
+          this.logger.warn(`rescanProject: skill-manager reload failed: ${err.message}`);
+        }
+      }
+    }
+
+    // 5. (可选) 对保留的插件也执行 reload
+    if (options.reloadKept) {
+      for (const name of keepList) {
+        if (!this.pluginManager.has(name)) continue;
+        try {
+          await this.pluginManager.reload(name);
+        } catch (err) {
+          this.logger.warn(`rescanProject: reload kept ${name} failed: ${err.message}`);
+        }
+      }
+    }
+
+    const result = { unloaded: unloadList, loaded: loadList, keepLoaded: keepList };
+    this.emit('rescan:complete', result);
+    this.logger.info(
+      `rescanProject: unloaded=${unloadList.length} loaded=${loadList.length} kept=${keepList.length}`
+    );
+    return result;
+  }
+
   /**
    * 启动 Session 自动清理
    * @param {number} [intervalMs=60000] - 检查间隔

package/src/core/plugin-base.js

@@ -244,6 +244,17 @@ class Plugin {
     this._autoRegisterSubAgents();
   }
 
+  /**
+   * 工作目录变更钩子 — 框架级 cwd 切换时由 Framework.setCwd 调用
+   * 子类可重写以重新加载 cwd 相关的资源（路径、文件句柄等）
+   * @param {string} oldCwd
+   * @param {string} newCwd
+   * @param {Framework} framework
+   */
+  onCwdChanged(oldCwd, newCwd, framework) {
+    // 默认 no-op
+  }
+
   /**
    * 卸载插件 - 清理资源
    * @param {Framework} framework - 框架实例

package/src/core/plugin-manager.js

@@ -22,7 +22,12 @@ class PluginManager {
     this.framework = framework;
     this._plugins = new Map();
     this._loading = false;
-    this._stateFile = path.join(process.cwd(), '.foliko', 'data', 'plugins-state.json');
+    this._stateFile = path.join(
+      framework?.getCwd?.() ?? process.cwd(),
+      '.foliko',
+      'data',
+      'plugins-state.json'
+    );
     this._knownPlugins = new Set(); // 已知插件列表（包括未加载的）
 
     // 创建子日志器
@@ -111,6 +116,16 @@ class PluginManager {
     return this._stateFile;
   }
 
+  /**
+   * 更新状态文件路径（Framework.setCwd 时调用）
+   * @param {string} cwd - 新的工作目录
+   * @private
+   */
+  _setStateFile(cwd) {
+    this._stateFile = path.join(cwd, '.foliko', 'data', 'plugins-state.json');
+    this._stateCache = null;
+  }
+
   /**
    * 保存插件状态到文件
    * 注意：AI 插件配置不保存（从环境变量和命令行获取）
@@ -442,7 +457,8 @@ class PluginManager {
    * @private
    */
   async _discoverCustomPlugins() {
-    const pluginsDir = path.resolve(process.cwd(), '.foliko', 'plugins');
+    const cwd = this.framework?.getCwd?.() ?? process.cwd();
+    const pluginsDir = path.resolve(cwd, '.foliko', 'plugins');
     if (!fs.existsSync(pluginsDir)) {
       return;
     }