@eoasmxd/freya 0.4.4 → 0.5.1

package/doc/tutorials/part5_plugins/10.1_microkernel_decoupling.md

@@ -83,10 +83,11 @@ export interface Logger {
 }
 
 export interface FreyaPaths {
-  appRoot: string;      // 程序物理安装根目录
-  projectRoot: string;  // 运行态主目录 (默认 ~/.freya)
-  dataDir: string;      // 运行时数据持久化目录
-  workspaceDir: string; // 隔离的读写文件沙箱
+  appRoot: string;       // 程序物理安装根目录
+  homeDir: string;       // 运行态持久化主目录 (默认 ~/.freya)
+  workspaceRoot: string; // 宿主工程根目录 (默认 process.cwd())
+  dataDir: string;       // 运行时数据持久化目录
+  workspaceDir: string;  // 隔离的读写文件沙箱
 }
 
 export interface FreyaContext {

package/freya.js

@@ -106,13 +106,24 @@ await checkSingleInstance();
 const cliEnabled = await getCliEnabled(process.argv);
 const isForeground = isForegroundMode(process.argv);
 
+let appRoot = __dirname;
+try {
+  const stat = await fs.stat(path.join(__dirname, 'plugins'));
+  if (!stat.isDirectory()) {
+    appRoot = path.resolve(__dirname, '..');
+  }
+} catch {
+  appRoot = path.resolve(__dirname, '..');
+}
+
 if (!cliEnabled && !isForeground) {
   const child = fork(coreIndex, process.argv.slice(2), {
     detached: true,
     stdio: 'ignore',
     env: {
       ...process.env,
-      FREYA_APP_ROOT: __dirname
+      FREYA_APP: process.env.FREYA_APP || appRoot,
+      FREYA_WORKSPACE: process.env.FREYA_WORKSPACE || process.cwd()
     }
   });
 
@@ -130,7 +141,8 @@ if (!cliEnabled && !isForeground) {
     stdio: 'inherit',
     env: {
       ...process.env,
-      FREYA_APP_ROOT: __dirname
+      FREYA_APP: process.env.FREYA_APP || appRoot,
+      FREYA_WORKSPACE: process.env.FREYA_WORKSPACE || process.cwd()
     }
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eoasmxd/freya",
-  "version": "0.4.4",
+  "version": "0.5.1",
   "license": "MIT",
   "type": "module",
   "description": "Freya - 微内核智能体系统",
@@ -35,7 +35,7 @@
     "src"
   ],
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.4.4",
+    "@eoasmxd/freya-sdk": "^0.5.1",
     "ws": "^8.18.0",
     "mysql2": "^3.11.0",
     "qrcode": "^1.5.4"

package/plugins/plugin-gemini/package.json

@@ -18,7 +18,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.4.4"
+    "@eoasmxd/freya-sdk": "^0.5.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/plugins/plugin-openai/package.json

@@ -18,7 +18,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.4.4"
+    "@eoasmxd/freya-sdk": "^0.5.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/plugins/plugin-telegram-channel/package.json

@@ -19,7 +19,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.4.4"
+    "@eoasmxd/freya-sdk": "^0.5.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/plugins/plugin-tool-fs/package.json

@@ -21,7 +21,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.4.4"
+    "@eoasmxd/freya-sdk": "^0.5.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/plugins/plugin-tool-memory/dist/tools.js

@@ -80,8 +80,8 @@ function getFormattedDateTime() {
 }
 function cleanPathFromError(err, ctx) {
     const rawMessage = err?.message || String(err);
-    const projectRoot = ctx.paths.projectRoot;
-    const escapedPath = projectRoot.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const homeDir = ctx.paths.homeDir;
+    const escapedPath = homeDir.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
     const regex = new RegExp(escapedPath + '[\\\\/]?', 'g');
     return rawMessage.replace(regex, '');
 }

package/plugins/plugin-tool-memory/package.json

@@ -21,7 +21,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.4.4"
+    "@eoasmxd/freya-sdk": "^0.5.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/plugins/plugin-tool-mysql/dist/audit.js

@@ -10,7 +10,7 @@ export class SqlAuditService {
             return this.cachedPrompt;
         }
         const promptFileName = 'plugin.prompt.mysql.select.audit.md';
-        const runtimeOverridePath = path.join(ctx.paths.projectRoot, 'config', 'prompts', promptFileName);
+        const runtimeOverridePath = path.join(ctx.paths.homeDir, 'config', 'prompts', promptFileName);
         try {
             const content = await fs.readFile(runtimeOverridePath, 'utf-8');
             if (content.trim()) {

package/plugins/plugin-tool-mysql/package.json

@@ -23,7 +23,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.4.4",
+    "@eoasmxd/freya-sdk": "^0.5.1",
     "mysql2": "^3.11.0"
   },
   "devDependencies": {

package/plugins/plugin-tool-web/package.json

@@ -22,7 +22,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.4.4"
+    "@eoasmxd/freya-sdk": "^0.5.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/plugins/plugin-wecom-channel/package.json

@@ -19,7 +19,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.4.4",
+    "@eoasmxd/freya-sdk": "^0.5.1",
     "ws": "^8.18.0"
   },
   "devDependencies": {

package/plugins/plugin-weixin-channel/package.json

@@ -18,7 +18,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.4.4",
+    "@eoasmxd/freya-sdk": "^0.5.1",
     "qrcode": "^1.5.4"
   },
   "devDependencies": {

package/src/packages/core/src/config/config-manager.ts

@@ -6,7 +6,7 @@ import { FreyaConfigFileHandler } from './file-handler.js';
 import { FreyaConfigSchemaRegistry } from './schema-registry.js';
 import type { FreyaSkillRegistry, FreyaSkill } from '../skill/skill-registry.js';
 import path from 'node:path';
-import { PROJECT_ROOT } from '../utils/paths.js';
+import { FREYA_HOME } from '../utils/paths.js';
 
 function cleanPathFromError(err: any): string {
   const rawMessage = err?.message || String(err);
@@ -226,10 +226,10 @@ export class FreyaConfigManager {
     const cloned = JSON.parse(JSON.stringify(config));
     if (cloned.workspace && typeof cloned.workspace === 'string') {
       if (!path.isAbsolute(cloned.workspace)) {
-        cloned.workspace = path.resolve(PROJECT_ROOT, cloned.workspace);
+        cloned.workspace = path.resolve(FREYA_HOME, cloned.workspace);
       }
     } else {
-      cloned.workspace = path.join(PROJECT_ROOT, 'workspace');
+      cloned.workspace = path.join(FREYA_HOME, 'workspace');
     }
     (this.context as any).config = deepFreeze(cloned);
   }

package/src/packages/core/src/config/file-handler.ts

@@ -1,11 +1,11 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { PROJECT_ROOT } from '../utils/paths.js';
+import { FREYA_HOME } from '../utils/paths.js';
 
 /** 配置文件底层 IO 处理器 */
 export class FreyaConfigFileHandler {
   async readFreyaConfig(): Promise<Record<string, any>> {
-    const filePath = path.join(PROJECT_ROOT, 'config', 'freya.json');
+    const filePath = path.join(FREYA_HOME, 'config', 'freya.json');
     try {
       const data = await fs.readFile(filePath, 'utf-8');
       return JSON.parse(data);
@@ -15,13 +15,13 @@ export class FreyaConfigFileHandler {
   }
 
   async writeFreyaConfig(config: Record<string, any>): Promise<void> {
-    const filePath = path.join(PROJECT_ROOT, 'config', 'freya.json');
+    const filePath = path.join(FREYA_HOME, 'config', 'freya.json');
     await fs.mkdir(path.dirname(filePath), { recursive: true });
     await fs.writeFile(filePath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
   }
 
   async readProviders(): Promise<any[]> {
-    const filePath = path.join(PROJECT_ROOT, 'config', 'providers.json');
+    const filePath = path.join(FREYA_HOME, 'config', 'providers.json');
     try {
       const data = await fs.readFile(filePath, 'utf-8');
       return JSON.parse(data);
@@ -31,18 +31,18 @@ export class FreyaConfigFileHandler {
   }
 
   async writeProviders(providers: any[]): Promise<void> {
-    const filePath = path.join(PROJECT_ROOT, 'config', 'providers.json');
+    const filePath = path.join(FREYA_HOME, 'config', 'providers.json');
     await fs.mkdir(path.dirname(filePath), { recursive: true });
     await fs.writeFile(filePath, JSON.stringify(providers, null, 2) + '\n', 'utf-8');
   }
 
   async readPromptFile(name: string): Promise<string> {
-    const filePath = path.join(PROJECT_ROOT, 'config', `${name.toUpperCase()}.md`);
+    const filePath = path.join(FREYA_HOME, 'config', `${name.toUpperCase()}.md`);
     return await fs.readFile(filePath, 'utf-8');
   }
 
   async writePromptFile(name: string, content: string): Promise<void> {
-    const filePath = path.join(PROJECT_ROOT, 'config', `${name.toUpperCase()}.md`);
+    const filePath = path.join(FREYA_HOME, 'config', `${name.toUpperCase()}.md`);
     await fs.mkdir(path.dirname(filePath), { recursive: true });
     await fs.writeFile(filePath, content.trim() + '\n', 'utf-8');
   }

package/src/packages/core/src/context.ts

@@ -6,7 +6,7 @@ import type {
   Logger,
 } from '@eoasmxd/freya-sdk';
 import path from 'node:path';
-import { APP_ROOT, PROJECT_ROOT } from './utils/paths.js';
+import { FREYA_APP, FREYA_HOME, FREYA_WORKSPACE } from './utils/paths.js';
 
 export class DefaultFreyaContext implements FreyaContext {
   logger!: Logger;
@@ -15,17 +15,18 @@ export class DefaultFreyaContext implements FreyaContext {
   llm!: ILLMService;
   get paths(): FreyaPaths {
     const configWorkspace = this.config?.workspace;
-    let workspaceDir = path.join(PROJECT_ROOT, 'workspace');
+    let workspaceDir = path.join(FREYA_HOME, 'workspace');
     if (configWorkspace && typeof configWorkspace === 'string') {
       workspaceDir = path.isAbsolute(configWorkspace)
         ? configWorkspace
-        : path.resolve(PROJECT_ROOT, configWorkspace);
+        : path.resolve(FREYA_HOME, configWorkspace);
     }
 
     return {
-      appRoot: APP_ROOT,
-      projectRoot: PROJECT_ROOT,
-      dataDir: path.join(PROJECT_ROOT, 'data'),
+      appRoot: FREYA_APP,
+      homeDir: FREYA_HOME,
+      workspaceRoot: FREYA_WORKSPACE,
+      dataDir: path.join(FREYA_HOME, 'data'),
       workspaceDir,
     };
   }

package/src/packages/core/src/llm/llm-logger.ts

@@ -1,7 +1,7 @@
 import type { LLMMessage, LLMTokenUsage, ToolDefinition } from '@eoasmxd/freya-sdk';
 import fs from 'node:fs';
 import path from 'node:path';
-import { PROJECT_ROOT } from '../utils/paths.js';
+import { FREYA_HOME } from '../utils/paths.js';
 
 /** LLM 交互日志器，按日期写入 logs/llm-YYYY-MM-DD.log */
 export class FreyaLLMLogger {
@@ -9,7 +9,7 @@ export class FreyaLLMLogger {
     private _enabled: boolean;
 
     constructor(enabled: boolean) {
-        this.logsDir = path.join(PROJECT_ROOT, 'logs');
+        this.logsDir = path.join(FREYA_HOME, 'logs');
         this._enabled = enabled;
         fs.mkdirSync(this.logsDir, { recursive: true });
     }

package/src/packages/core/src/logger.ts

@@ -3,7 +3,7 @@ import fs from 'node:fs';
 import fsPromises from 'node:fs/promises';
 import path from 'node:path';
 import { inspect } from 'node:util';
-import { PROJECT_ROOT } from './utils/paths.js';
+import { FREYA_HOME } from './utils/paths.js';
 
 /** 双轨日志器：按日期滚动写入文件，按配置输出至控制台 */
 export class FreyaLogger implements Logger {
@@ -19,7 +19,7 @@ export class FreyaLogger implements Logger {
   private currentLogFilePath = '';
 
   constructor() {
-    this.logsDir = path.join(PROJECT_ROOT, 'logs');
+    this.logsDir = path.join(FREYA_HOME, 'logs');
     fs.mkdirSync(this.logsDir, { recursive: true });
   }
 

package/src/packages/core/src/plugin/plugin-manager.ts

@@ -6,7 +6,7 @@ import { pathToFileURL } from 'node:url';
 import { FreyaCommandRegistry } from '../command/command-registry.js';
 import { FreyaConfigSchemaRegistry } from '../config/schema-registry.js';
 import { FreyaPromptRegistry } from '../prompt/prompt-registry.js';
-import { APP_ROOT, PROJECT_ROOT } from '../utils/paths.js';
+import { FREYA_APP, FREYA_HOME, FREYA_WORKSPACE } from '../utils/paths.js';
 import { FreyaPluginRegistry } from './plugin-registry.js';
 
 export interface PluginConfigEntry {
@@ -18,7 +18,7 @@ export interface PluginConfigEntry {
   displayName?: string;
   description?: string;
   version?: string;
-  source?: 'builtin' | 'runtime' | 'npm';
+  source?: 'builtin' | 'workspace' | 'runtime' | 'npm';
 }
 
 interface DiscoveredPluginInfo {
@@ -28,7 +28,7 @@ interface DiscoveredPluginInfo {
   displayName: string;
   description: string;
   version: string;
-  source: 'builtin' | 'runtime' | 'npm';
+  source: 'builtin' | 'workspace' | 'runtime' | 'npm';
   defaultEnabled?: boolean;
   prompts?: string[];
   valid: boolean;
@@ -164,7 +164,7 @@ export class FreyaPluginManager {
     entry.enabled = enabled;
     entry.status = enabled ? 'active' : 'disabled';
 
-    const configPluginsPath = path.join(PROJECT_ROOT, 'config', 'plugins.json');
+    const configPluginsPath = path.join(FREYA_HOME, 'config', 'plugins.json');
     try {
       await fs.mkdir(path.dirname(configPluginsPath), { recursive: true });
       const rawEntries = this.pluginEntries.map((e) => ({ id: e.id, enabled: e.enabled }));
@@ -232,7 +232,7 @@ export class FreyaPluginManager {
    */
   private async inspectPluginPackage(
     dirPath: string,
-    source: 'builtin' | 'runtime' | 'npm'
+    source: 'builtin' | 'workspace' | 'runtime' | 'npm'
   ): Promise<DiscoveredPluginInfo | null> {
     try {
       const pkgPath = path.join(dirPath, 'package.json');
@@ -247,7 +247,7 @@ export class FreyaPluginManager {
       const displayName = String(pkg.freya?.displayName || pkg.displayName || id);
       const description = String(pkg.description || '');
       const version = String(pkg.version || '0.1.0');
-      const defaultEnabled = (source === 'builtin' && pkg.freya?.defaultEnabled === true);
+      const defaultEnabled = ((source === 'builtin' || source === 'workspace') && pkg.freya?.defaultEnabled === true);
       const rawPrompts = pkg.freya?.prompts;
       const prompts = Array.isArray(rawPrompts) ? rawPrompts.map(String) : [];
 
@@ -354,7 +354,7 @@ export class FreyaPluginManager {
       let pkgJsonPath = '';
       try {
         pkgJsonPath = req.resolve(`${pkgName}/package.json`, {
-          paths: [path.join(PROJECT_ROOT), path.join(APP_ROOT), process.cwd()]
+          paths: [path.join(FREYA_WORKSPACE), path.join(FREYA_HOME), path.join(FREYA_APP), process.cwd()]
         });
       } catch {
         return {
@@ -407,7 +407,7 @@ export class FreyaPluginManager {
   private async scanAllChannels(configuredIds: Set<string>): Promise<DiscoveredPluginInfo[]> {
     const map = new Map<string, DiscoveredPluginInfo>();
 
-    const builtinDir = path.join(APP_ROOT, 'plugins');
+    const builtinDir = path.join(FREYA_APP, 'plugins');
     try {
       const entries = await fs.readdir(builtinDir, { withFileTypes: true });
       for (const entry of entries) {
@@ -418,13 +418,42 @@ export class FreyaPluginManager {
       }
     } catch { }
 
-    const runtimeDir = path.join(PROJECT_ROOT, 'plugins');
+    const workspaceDir = path.join(FREYA_WORKSPACE, 'plugins');
+    const resolvedBuiltin = path.resolve(builtinDir);
+    const resolvedWorkspace = path.resolve(workspaceDir);
+    const resolvedRuntime = path.resolve(path.join(FREYA_HOME, 'plugins'));
+
+    if (resolvedWorkspace !== resolvedBuiltin && resolvedWorkspace !== resolvedRuntime) {
+      try {
+        const entries = await fs.readdir(workspaceDir, { withFileTypes: true });
+        for (const entry of entries) {
+          if (entry.isDirectory()) {
+            const info = await this.inspectPluginPackage(path.join(workspaceDir, entry.name), 'workspace');
+            if (info) {
+              const existing = map.get(info.id);
+              if (existing?.source === 'builtin') {
+                info.source = 'builtin';
+              }
+              map.set(info.id, info);
+            }
+          }
+        }
+      } catch { }
+    }
+
+    const runtimeDir = path.join(FREYA_HOME, 'plugins');
     try {
       const entries = await fs.readdir(runtimeDir, { withFileTypes: true });
       for (const entry of entries) {
         if (entry.isDirectory()) {
           const info = await this.inspectPluginPackage(path.join(runtimeDir, entry.name), 'runtime');
-          if (info) map.set(info.id, info);
+          if (info) {
+            const existing = map.get(info.id);
+            if (existing?.source === 'builtin') {
+              info.source = 'builtin';
+            }
+            map.set(info.id, info);
+          }
         }
       }
     } catch { }
@@ -445,7 +474,7 @@ export class FreyaPluginManager {
   async loadConfiguredPlugins(pluginRegistry: FreyaPluginRegistry, ctx: FreyaContext): Promise<void> {
     this.ctx = ctx;
     this.pluginRegistry = pluginRegistry;
-    const configPluginsPath = path.join(PROJECT_ROOT, 'config', 'plugins.json');
+    const configPluginsPath = path.join(FREYA_HOME, 'config', 'plugins.json');
 
     let configList: Array<{ id: string; enabled: boolean }> = [];
     try {

package/src/packages/core/src/prompt/prompt-manager.ts

@@ -2,14 +2,14 @@ import type { Logger } from '@eoasmxd/freya-sdk';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { APP_ROOT, PROJECT_ROOT } from '../utils/paths.js';
+import { FREYA_APP, FREYA_HOME } from '../utils/paths.js';
 import { FreyaPromptRegistry } from './prompt-registry.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 /** 提示词物理文件管理器，负责加载、缺失拷贝与持久化覆写 */
 export class FreyaPromptManager {
-  private defaultDirPath = path.join(APP_ROOT, 'config', 'prompts');
+  private defaultDirPath = path.join(FREYA_APP, 'config', 'prompts');
 
   constructor(
     private promptRegistry: FreyaPromptRegistry,
@@ -31,7 +31,7 @@ export class FreyaPromptManager {
       throw new Error(`拒绝执行：配置管理工具仅允许管理核心提示词`);
     }
 
-    const runFilePath = path.join(PROJECT_ROOT, 'config', `${name.toUpperCase()}.md`);
+    const runFilePath = path.join(FREYA_HOME, 'config', `${name.toUpperCase()}.md`);
     await fs.mkdir(path.dirname(runFilePath), { recursive: true });
     await fs.writeFile(runFilePath, content, 'utf-8');
 
@@ -46,7 +46,7 @@ export class FreyaPromptManager {
       throw new Error(`拒绝执行：配置管理工具仅允许管理核心提示词`);
     }
 
-    const runFilePath = path.join(PROJECT_ROOT, 'config', `${name.toUpperCase()}.md`);
+    const runFilePath = path.join(FREYA_HOME, 'config', `${name.toUpperCase()}.md`);
     const registryKey = `core.prompt.${name.toLowerCase()}`;
     const currentText = this.promptRegistry.get(registryKey);
 

package/src/packages/core/src/prompt/prompt-registry.ts

@@ -1,39 +1,63 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { APP_ROOT, PROJECT_ROOT } from '../utils/paths.js';
+import { FREYA_APP, FREYA_HOME, FREYA_WORKSPACE } from '../utils/paths.js';
 
 export interface FreyaPrompt {
   key: string;
   content: string;
   defaultPath: string;
-  runPath?: string;
+  configFileName?: string;
 }
 
 /** 提示词内存注册表，管理所有系统及插件级提示词的分类检索 */
 export class FreyaPromptRegistry {
   private prompts = new Map<string, FreyaPrompt>();
 
-  private getRunFilePath(prompt: Omit<FreyaPrompt, 'content'>): string {
-    return prompt.runPath || path.join(PROJECT_ROOT, 'config', 'prompts', path.basename(prompt.defaultPath));
+  private resolveProbePaths(prompt: Omit<FreyaPrompt, 'content'>): string[] {
+    const baseName = path.basename(prompt.defaultPath);
+    const rawPaths: string[] = [];
+
+    if (prompt.configFileName) {
+      rawPaths.push(path.join(FREYA_HOME, 'config', prompt.configFileName));
+      rawPaths.push(path.join(FREYA_WORKSPACE, 'config', prompt.configFileName));
+    }
+
+    rawPaths.push(path.join(FREYA_HOME, 'config', 'prompts', baseName));
+    rawPaths.push(path.join(FREYA_WORKSPACE, 'config', 'prompts', baseName));
+    rawPaths.push(prompt.defaultPath);
+
+    const candidates: string[] = [];
+    const seen = new Set<string>();
+    for (const rawPath of rawPaths) {
+      const normalized = path.resolve(rawPath);
+      if (!seen.has(normalized)) {
+        seen.add(normalized);
+        candidates.push(normalized);
+      }
+    }
+    return candidates;
   }
 
-  /** 注册提示词元数据声明并执行异步双读载入 */
+  /** 注册提示词元数据声明并执行三层级联探针载入 */
   async register(prompt: Omit<FreyaPrompt, 'content'>): Promise<void> {
-    const runFilePath = this.getRunFilePath(prompt);
+    const probePaths = this.resolveProbePaths(prompt);
     let content = '';
-    try {
+
+    for (const filePath of probePaths) {
       try {
-        content = await fs.readFile(runFilePath, 'utf-8');
-      } catch {
-        content = await fs.readFile(prompt.defaultPath, 'utf-8');
-      }
-    } catch {}
+        const text = await fs.readFile(filePath, 'utf-8');
+        if (text.trim().length > 0) {
+          content = text;
+          break;
+        }
+      } catch {}
+    }
 
     this.prompts.set(prompt.key, {
       key: prompt.key,
       content: content.trim(),
       defaultPath: prompt.defaultPath,
-      runPath: prompt.runPath
+      configFileName: prompt.configFileName
     });
   }
 
@@ -58,16 +82,16 @@ export class FreyaPromptRegistry {
     return this.prompts;
   }
 
-  /** 扫描并装载所有内核提示词，支持运行时提示词覆盖默认提示词 */
+  /** 扫描并装载所有内核提示词 */
   async loadKernelPrompts(): Promise<void> {
-    const defaultDirPath = path.join(APP_ROOT, 'config', 'prompts');
+    const defaultDirPath = path.join(FREYA_APP, 'config', 'prompts');
     try {
       const corePrompts = ['identity', 'soul', 'tools', 'agents', 'user', 'memory'];
       for (const name of corePrompts) {
         await this.register({
           key: `core.prompt.${name}`,
           defaultPath: path.join(defaultDirPath, `core.prompt.${name}.md`),
-          runPath: path.join(PROJECT_ROOT, 'config', `${name.toUpperCase()}.md`)
+          configFileName: `${name.toUpperCase()}.md`
         });
       }
 

package/src/packages/core/src/session/persistence.ts

@@ -1,10 +1,10 @@
 import type { FreyaContext } from '@eoasmxd/freya-sdk';
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { PROJECT_ROOT } from '../utils/paths.js';
+import { FREYA_HOME } from '../utils/paths.js';
 import type { Session, SessionData, SessionIndex, SnapFile } from './types.js';
 
-const DATA_DIR = path.resolve(PROJECT_ROOT, 'data');
+const DATA_DIR = path.resolve(FREYA_HOME, 'data');
 const SESSIONS_DIR = path.resolve(DATA_DIR, 'sessions');
 const INDEX_FILE = path.resolve(DATA_DIR, 'sessions.json');