@eoasmxd/freya 0.4.4 → 0.5.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.0"
   },
   "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.0"
   },
   "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.0"
   },
   "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.0"
   },
   "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.0",
     "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.0"
   },
   "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.0",
     "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.0",
     "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,6 +1,6 @@
 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 } from '../utils/paths.js';
 
 export interface FreyaPrompt {
   key: string;
@@ -14,7 +14,7 @@ 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));
+    return prompt.runPath || path.join(FREYA_HOME, 'config', 'prompts', path.basename(prompt.defaultPath));
   }
 
   /** 注册提示词元数据声明并执行异步双读载入 */
@@ -60,14 +60,14 @@ export class FreyaPromptRegistry {
 
   /** 扫描并装载所有内核提示词，支持运行时提示词覆盖默认提示词 */
   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`)
+          runPath: path.join(FREYA_HOME, 'config', `${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');
 

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

@@ -1,7 +1,7 @@
 import type { FreyaContext } from '@eoasmxd/freya-sdk';
 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 FreyaSkill {
   id: string;
@@ -9,7 +9,7 @@ export interface FreyaSkill {
   description: string;
   content: string;
   enabled: boolean;
-  source: 'builtin' | 'runtime';
+  source: 'builtin' | 'workspace' | 'runtime';
 }
 
 /** 技能注册表，从 skills/ 目录加载 Markdown 格式技能并管理软开关状态 */
@@ -19,13 +19,23 @@ export class FreyaSkillRegistry {
 
   async loadSkills(context: FreyaContext): Promise<void> {
     this.context = context;
-    const runtimeSkillsDir = path.join(PROJECT_ROOT, 'skills');
-    const defaultSkillsDir = path.join(APP_ROOT, 'skills');
-    const configSkillsPath = path.join(PROJECT_ROOT, 'config', 'skills.json');
+    const defaultSkillsDir = path.join(FREYA_APP, 'skills');
+    const workspaceSkillsDir = path.join(FREYA_WORKSPACE, 'skills');
+    const runtimeSkillsDir = path.join(FREYA_HOME, 'skills');
+    const configSkillsPath = path.join(FREYA_HOME, 'config', 'skills.json');
 
     try {
       await fs.mkdir(runtimeSkillsDir, { recursive: true });
       await this.loadSkillsFromDirectory(defaultSkillsDir, 'builtin', context);
+
+      const resolvedDefault = path.resolve(defaultSkillsDir);
+      const resolvedWorkspace = path.resolve(workspaceSkillsDir);
+      const resolvedRuntime = path.resolve(runtimeSkillsDir);
+
+      if (resolvedWorkspace !== resolvedDefault && resolvedWorkspace !== resolvedRuntime) {
+        await this.loadSkillsFromDirectory(workspaceSkillsDir, 'workspace', context);
+      }
+
       await this.loadSkillsFromDirectory(runtimeSkillsDir, 'runtime', context);
 
       let configList: Array<{ id: string; enabled: boolean }> = [];
@@ -67,7 +77,7 @@ export class FreyaSkillRegistry {
   }
 
   /** 从指定目录加载技能到内存注册表中 */
-  private async loadSkillsFromDirectory(dirPath: string, source: 'builtin' | 'runtime', context: FreyaContext): Promise<void> {
+  private async loadSkillsFromDirectory(dirPath: string, source: 'builtin' | 'workspace' | 'runtime', context: FreyaContext): Promise<void> {
     try {
       const files = await fs.readdir(dirPath);
       for (const file of files) {
@@ -77,15 +87,19 @@ export class FreyaSkillRegistry {
           if (metadata.id) {
             const defaultEnabled = metadata.defaultEnabled !== undefined
               ? metadata.defaultEnabled !== 'false'
-              : source === 'builtin';
+              : source !== 'runtime';
+
+            const existing = this.skills.get(metadata.id);
+            const finalSource = existing?.source === 'builtin' ? 'builtin' : source;
+            const finalEnabled = existing !== undefined ? existing.enabled : defaultEnabled;
 
             this.skills.set(metadata.id, {
               id: metadata.id,
               name: metadata.name || file.replace('.md', ''),
               description: metadata.description || '',
               content: content.trim(),
-              enabled: defaultEnabled,
-              source
+              enabled: finalEnabled,
+              source: finalSource
             });
           }
         }
@@ -126,7 +140,7 @@ export class FreyaSkillRegistry {
     }
 
     skill.enabled = enabled;
-    const configSkillsPath = path.join(PROJECT_ROOT, 'config', 'skills.json');
+    const configSkillsPath = path.join(FREYA_HOME, 'config', 'skills.json');
     try {
       await this.persistSkillsConfig(configSkillsPath);
       this.context?.logger.info(`技能 "${skill.name || skillId}" 已切换为: ${enabled ? '启用' : '禁用'}`);

package/src/packages/core/src/utils/paths.ts

@@ -5,13 +5,10 @@ import { fileURLToPath } from 'node:url';
 import fs from 'node:fs';
 
 const customHome = process.env.FREYA_HOME;
+const customApp = process.env.FREYA_APP;
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 function resolveAppRoot(): string {
-  if (process.env.FREYA_APP_ROOT) {
-    return path.resolve(process.env.FREYA_APP_ROOT);
-  }
-
   let current = __dirname;
   let coreDir = current;
 
@@ -36,10 +33,17 @@ function resolveAppRoot(): string {
   return coreDir;
 }
 
-/** 运行态下的项目根目录（数据与配置存放区） */
-export const PROJECT_ROOT = customHome
+/** 运行态持久化主目录（数据与配置存放区） */
+export const FREYA_HOME = customHome
   ? path.resolve(customHome)
   : path.join(os.homedir(), '.freya');
 
 /** 程序代码物理安装根目录（只读代码与包内默认资源区） */
-export const APP_ROOT = resolveAppRoot();
+export const FREYA_APP = customApp
+  ? path.resolve(customApp)
+  : resolveAppRoot();
+
+/** 宿主工程/工作区根目录（业务工程代码与定制资源区） */
+export const FREYA_WORKSPACE = process.env.FREYA_WORKSPACE
+  ? path.resolve(process.env.FREYA_WORKSPACE)
+  : process.cwd();

package/src/packages/core/src/web/web-container.ts

@@ -5,7 +5,7 @@ import fsSync from 'node:fs';
 import fs from 'node:fs/promises';
 import http from 'node:http';
 import path from 'node:path';
-import { APP_ROOT } from '../utils/paths.js';
+import { FREYA_APP } from '../utils/paths.js';
 
 const mimeTypes: Record<string, string> = {
     '.html': 'text/html; charset=utf-8',
@@ -43,7 +43,7 @@ export class FreyaWebContainer {
     async start(ctx: FreyaContext, configManager: FreyaConfigManager): Promise<void> {
         this.port = (ctx.config as any)?.server?.port ?? 3000;
         this.configApi = new FreyaConfigApi(configManager);
-        const uiDist = this.getUiDistPath(APP_ROOT);
+        const uiDist = this.getUiDistPath(FREYA_APP);
         const safePrefix = uiDist.endsWith(path.sep) ? uiDist : uiDist + path.sep;
 
         this.httpServer = http.createServer(async (req, res) => {
@@ -113,9 +113,9 @@ export class FreyaWebContainer {
         });
     }
 
-    private getUiDistPath(projectRoot: string): string {
-        const devPath = path.join(projectRoot, 'packages', 'ui', 'dist');
-        const prodPath = path.join(projectRoot, 'ui');
+    private getUiDistPath(appRoot: string): string {
+        const devPath = path.join(appRoot, 'packages', 'ui', 'dist');
+        const prodPath = path.join(appRoot, 'ui');
         if (fsSync.existsSync(devPath)) return devPath;
         return prodPath;
     }

package/src/packages/sdk/src/types/context.ts

@@ -16,8 +16,10 @@ export interface Logger {
 export interface FreyaPaths {
   /** 程序物理安装根目录（只读代码与程序级静态资源区） */
   appRoot: string;
-  /** 运行态主目录（用户个性化配置与持久化数据区，默认 ~/.freya） */
-  projectRoot: string;
+  /** 运行态持久化主目录（用户个性化配置与持久化数据区，默认 ~/.freya） */
+  homeDir: string;
+  /** 宿主工程根目录（默认为启动执行路径 process.cwd()） */
+  workspaceRoot: string;
   /** 运行时数据持久化目录（~/.freya/data） */
   dataDir: string;
   /** 宿主与大模型交互隔离的文件读写沙箱（~/.freya/workspace） */