@eoasmxd/freya 0.5.0 → 0.5.2

package/core/dist/context.js

@@ -1,5 +1,5 @@
 import path from 'node:path';
-import { FREYA_APP, FREYA_HOME, FREYA_WORKSPACE } from './utils/paths.js';
+import { FREYA_APP, FREYA_HOME, FREYA_LAUNCH } from './utils/paths.js';
 export class DefaultFreyaContext {
     logger;
     eventBus;
@@ -16,7 +16,7 @@ export class DefaultFreyaContext {
         return {
             appRoot: FREYA_APP,
             homeDir: FREYA_HOME,
-            workspaceRoot: FREYA_WORKSPACE,
+            launchDir: FREYA_LAUNCH,
             dataDir: path.join(FREYA_HOME, 'data'),
             workspaceDir,
         };

package/core/dist/plugin/plugin-manager.d.ts

@@ -12,7 +12,7 @@ export interface PluginConfigEntry {
     displayName?: string;
     description?: string;
     version?: string;
-    source?: 'builtin' | 'workspace' | 'runtime' | 'npm';
+    source?: 'builtin' | 'launch' | 'runtime' | 'npm';
 }
 /**
  * Freya 插件生命周期与模块管理器

package/core/dist/plugin/plugin-manager.js

@@ -5,7 +5,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 { FREYA_APP, FREYA_HOME, FREYA_WORKSPACE } from '../utils/paths.js';
+import { FREYA_APP, FREYA_HOME, FREYA_LAUNCH } from '../utils/paths.js';
 import { FreyaPluginRegistry } from './plugin-registry.js';
 /**
  * Freya 插件生命周期与模块管理器
@@ -188,7 +188,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' || source === 'workspace') && pkg.freya?.defaultEnabled === true);
+            const defaultEnabled = ((source === 'builtin' || source === 'launch') && pkg.freya?.defaultEnabled === true);
             const rawPrompts = pkg.freya?.prompts;
             const prompts = Array.isArray(rawPrompts) ? rawPrompts.map(String) : [];
             const isFreyaPlugin = Boolean(pkg.freya ||
@@ -288,7 +288,7 @@ export class FreyaPluginManager {
             let pkgJsonPath = '';
             try {
                 pkgJsonPath = req.resolve(`${pkgName}/package.json`, {
-                    paths: [path.join(FREYA_WORKSPACE), path.join(FREYA_HOME), path.join(FREYA_APP), process.cwd()]
+                    paths: [path.join(FREYA_LAUNCH), path.join(FREYA_HOME), path.join(FREYA_APP), process.cwd()]
                 });
             }
             catch {
@@ -352,16 +352,16 @@ export class FreyaPluginManager {
             }
         }
         catch { }
-        const workspaceDir = path.join(FREYA_WORKSPACE, 'plugins');
+        const launchPluginsDir = path.join(FREYA_LAUNCH, 'plugins');
         const resolvedBuiltin = path.resolve(builtinDir);
-        const resolvedWorkspace = path.resolve(workspaceDir);
+        const resolvedLaunch = path.resolve(launchPluginsDir);
         const resolvedRuntime = path.resolve(path.join(FREYA_HOME, 'plugins'));
-        if (resolvedWorkspace !== resolvedBuiltin && resolvedWorkspace !== resolvedRuntime) {
+        if (resolvedLaunch !== resolvedBuiltin && resolvedLaunch !== resolvedRuntime) {
             try {
-                const entries = await fs.readdir(workspaceDir, { withFileTypes: true });
+                const entries = await fs.readdir(launchPluginsDir, { withFileTypes: true });
                 for (const entry of entries) {
                     if (entry.isDirectory()) {
-                        const info = await this.inspectPluginPackage(path.join(workspaceDir, entry.name), 'workspace');
+                        const info = await this.inspectPluginPackage(path.join(launchPluginsDir, entry.name), 'launch');
                         if (info) {
                             const existing = map.get(info.id);
                             if (existing?.source === 'builtin') {

package/core/dist/prompt/prompt-registry.d.ts

@@ -2,13 +2,13 @@ export interface FreyaPrompt {
     key: string;
     content: string;
     defaultPath: string;
-    runPath?: string;
+    configFileName?: string;
 }
 /** 提示词内存注册表，管理所有系统及插件级提示词的分类检索 */
 export declare class FreyaPromptRegistry {
     private prompts;
-    private getRunFilePath;
-    /** 注册提示词元数据声明并执行异步双读载入 */
+    private resolveProbePaths;
+    /** 注册提示词元数据声明并执行三层级联探针载入 */
     register(prompt: Omit<FreyaPrompt, 'content'>): Promise<void>;
     /** 更新内存中的提示词文本内容 */
     updateContent(key: string, content: string): void;
@@ -16,7 +16,7 @@ export declare class FreyaPromptRegistry {
     unregister(key: string): void;
     get(key: string): string;
     getPrompts(): Map<string, FreyaPrompt>;
-    /** 扫描并装载所有内核提示词，支持运行时提示词覆盖默认提示词 */
+    /** 扫描并装载所有内核提示词 */
     loadKernelPrompts(): Promise<void>;
     /** 获取并拼装完整的核心 System Prompt */
     getSystemPrompt(): string;

package/core/dist/prompt/prompt-registry.js

@@ -1,30 +1,49 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { FREYA_APP, FREYA_HOME } from '../utils/paths.js';
+import { FREYA_APP, FREYA_HOME, FREYA_LAUNCH } from '../utils/paths.js';
 /** 提示词内存注册表，管理所有系统及插件级提示词的分类检索 */
 export class FreyaPromptRegistry {
     prompts = new Map();
-    getRunFilePath(prompt) {
-        return prompt.runPath || path.join(FREYA_HOME, 'config', 'prompts', path.basename(prompt.defaultPath));
+    resolveProbePaths(prompt) {
+        const baseName = path.basename(prompt.defaultPath);
+        const rawPaths = [];
+        if (prompt.configFileName) {
+            rawPaths.push(path.join(FREYA_HOME, 'config', prompt.configFileName));
+            rawPaths.push(path.join(FREYA_LAUNCH, 'config', prompt.configFileName));
+        }
+        rawPaths.push(path.join(FREYA_HOME, 'config', 'prompts', baseName));
+        rawPaths.push(path.join(FREYA_LAUNCH, 'config', 'prompts', baseName));
+        rawPaths.push(prompt.defaultPath);
+        const candidates = [];
+        const seen = new Set();
+        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) {
-        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');
+                const text = await fs.readFile(filePath, 'utf-8');
+                if (text.trim().length > 0) {
+                    content = text;
+                    break;
+                }
             }
+            catch { }
         }
-        catch { }
         this.prompts.set(prompt.key, {
             key: prompt.key,
             content: content.trim(),
             defaultPath: prompt.defaultPath,
-            runPath: prompt.runPath
+            configFileName: prompt.configFileName
         });
     }
     /** 更新内存中的提示词文本内容 */
@@ -44,7 +63,7 @@ export class FreyaPromptRegistry {
     getPrompts() {
         return this.prompts;
     }
-    /** 扫描并装载所有内核提示词，支持运行时提示词覆盖默认提示词 */
+    /** 扫描并装载所有内核提示词 */
     async loadKernelPrompts() {
         const defaultDirPath = path.join(FREYA_APP, 'config', 'prompts');
         try {
@@ -53,7 +72,7 @@ export class FreyaPromptRegistry {
                 await this.register({
                     key: `core.prompt.${name}`,
                     defaultPath: path.join(defaultDirPath, `core.prompt.${name}.md`),
-                    runPath: path.join(FREYA_HOME, 'config', `${name.toUpperCase()}.md`)
+                    configFileName: `${name.toUpperCase()}.md`
                 });
             }
             try {

package/core/dist/skill/skill-registry.d.ts

@@ -5,7 +5,7 @@ export interface FreyaSkill {
     description: string;
     content: string;
     enabled: boolean;
-    source: 'builtin' | 'workspace' | 'runtime';
+    source: 'builtin' | 'launch' | 'runtime';
 }
 /** 技能注册表，从 skills/ 目录加载 Markdown 格式技能并管理软开关状态 */
 export declare class FreyaSkillRegistry {

package/core/dist/skill/skill-registry.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { FREYA_APP, FREYA_HOME, FREYA_WORKSPACE } from '../utils/paths.js';
+import { FREYA_APP, FREYA_HOME, FREYA_LAUNCH } from '../utils/paths.js';
 /** 技能注册表，从 skills/ 目录加载 Markdown 格式技能并管理软开关状态 */
 export class FreyaSkillRegistry {
     skills = new Map();
@@ -8,17 +8,17 @@ export class FreyaSkillRegistry {
     async loadSkills(context) {
         this.context = context;
         const defaultSkillsDir = path.join(FREYA_APP, 'skills');
-        const workspaceSkillsDir = path.join(FREYA_WORKSPACE, 'skills');
+        const launchSkillsDir = path.join(FREYA_LAUNCH, '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 resolvedLaunch = path.resolve(launchSkillsDir);
             const resolvedRuntime = path.resolve(runtimeSkillsDir);
-            if (resolvedWorkspace !== resolvedDefault && resolvedWorkspace !== resolvedRuntime) {
-                await this.loadSkillsFromDirectory(workspaceSkillsDir, 'workspace', context);
+            if (resolvedLaunch !== resolvedDefault && resolvedLaunch !== resolvedRuntime) {
+                await this.loadSkillsFromDirectory(launchSkillsDir, 'launch', context);
             }
             await this.loadSkillsFromDirectory(runtimeSkillsDir, 'runtime', context);
             let configList = [];

package/core/dist/utils/paths.d.ts

@@ -2,5 +2,5 @@
 export declare const FREYA_HOME: string;
 /** 程序代码物理安装根目录（只读代码与包内默认资源区） */
 export declare const FREYA_APP: string;
-/** 宿主工程/工作区根目录（业务工程代码与定制资源区） */
-export declare const FREYA_WORKSPACE: string;
+/** 宿主命令启动执行根目录（默认当前工作目录 process.cwd()） */
+export declare const FREYA_LAUNCH: string;

package/core/dist/utils/paths.js

@@ -4,6 +4,7 @@ import { fileURLToPath } from 'node:url';
 import fs from 'node:fs';
 const customHome = process.env.FREYA_HOME;
 const customApp = process.env.FREYA_APP;
+const customLaunch = process.env.FREYA_LAUNCH;
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 function resolveAppRoot() {
     let current = __dirname;
@@ -38,7 +39,7 @@ export const FREYA_HOME = customHome
 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()） */
+export const FREYA_LAUNCH = customLaunch
+    ? path.resolve(customLaunch)
     : process.cwd();

package/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eoasmxd/freya-core",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "private": false,
   "license": "MIT",
   "publishConfig": {
@@ -16,7 +16,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.5.0",
+    "@eoasmxd/freya-sdk": "^0.5.2",
     "ws": "^8.18.0"
   },
   "devDependencies": {

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

@@ -85,9 +85,9 @@ export interface Logger {
 export interface FreyaPaths {
   appRoot: string;       // 程序物理安装根目录
   homeDir: string;       // 运行态持久化主目录 (默认 ~/.freya)
-  workspaceRoot: string; // 宿主工程根目录 (默认 process.cwd())
+  launchDir: string;     // 宿主命令启动执行目录 (默认 process.cwd())
   dataDir: string;       // 运行时数据持久化目录
-  workspaceDir: string;  // 隔离的读写文件沙箱
+  workspaceDir: string;  // 智能体专属读写工作区
 }
 
 export interface FreyaContext {

package/freya.js

@@ -123,7 +123,7 @@ if (!cliEnabled && !isForeground) {
     env: {
       ...process.env,
       FREYA_APP: process.env.FREYA_APP || appRoot,
-      FREYA_WORKSPACE: process.env.FREYA_WORKSPACE || process.cwd()
+      FREYA_LAUNCH: process.env.FREYA_LAUNCH || process.cwd()
     }
   });
 
@@ -142,7 +142,7 @@ if (!cliEnabled && !isForeground) {
     env: {
       ...process.env,
       FREYA_APP: process.env.FREYA_APP || appRoot,
-      FREYA_WORKSPACE: process.env.FREYA_WORKSPACE || process.cwd()
+      FREYA_LAUNCH: process.env.FREYA_LAUNCH || process.cwd()
     }
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eoasmxd/freya",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "license": "MIT",
   "type": "module",
   "description": "Freya - 微内核智能体系统",
@@ -35,7 +35,7 @@
     "src"
   ],
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.5.0",
+    "@eoasmxd/freya-sdk": "^0.5.2",
     "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.5.0"
+    "@eoasmxd/freya-sdk": "^0.5.2"
   },
   "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.5.0"
+    "@eoasmxd/freya-sdk": "^0.5.2"
   },
   "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.5.0"
+    "@eoasmxd/freya-sdk": "^0.5.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/plugins/plugin-tool-fs/dist/tools.d.ts

@@ -1,5 +1,5 @@
 import type { FreyaContext, ToolDefinition, FreyaTool } from '@eoasmxd/freya-sdk';
-/** 安全工作区路径获取 (支持指定 scope 作用域) */
+/** 获取经过安全边界校验的绝对路径 */
 export declare function getSafePath(ctx: FreyaContext, relativePath: string, scope?: string): {
     targetAbs: string;
     baseAbs: string;

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

@@ -1,13 +1,50 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-/** 安全工作区路径获取 (支持指定 scope 作用域) */
+/** 解析作用域实际物理路径，返回 null 表示显式禁用 */
+function resolveScopeBase(envValue, defaultPath, launchDir) {
+    if (envValue === undefined) {
+        return defaultPath;
+    }
+    const trimmed = envValue.trim();
+    if (trimmed === '' || trimmed.toLowerCase() === 'false') {
+        return null;
+    }
+    return path.isAbsolute(trimmed) ? trimmed : path.resolve(launchDir, trimmed);
+}
+/** 获取当前激活的作用域列表与描述文本 */
+function getActiveScopesInfo() {
+    const scopes = ['workspace'];
+    const descParts = ['默认为 "workspace" 沙箱'];
+    const srcVal = process.env.FREYA_FS_SRC;
+    const isSrcDisabled = srcVal !== undefined && (srcVal.trim() === '' || srcVal.trim().toLowerCase() === 'false');
+    if (!isSrcDisabled) {
+        scopes.push('src');
+        descParts.push('支持指定 "src" 源码区');
+    }
+    const docVal = process.env.FREYA_FS_DOC;
+    const isDocDisabled = docVal !== undefined && (docVal.trim() === '' || docVal.trim().toLowerCase() === 'false');
+    if (!isDocDisabled) {
+        scopes.push('doc');
+        descParts.push('指定 "doc" 文档区');
+    }
+    const description = `读取作用域（可选，${descParts.join('，')}）`;
+    return { scopes, description };
+}
+/** 获取经过安全边界校验的绝对路径 */
 export function getSafePath(ctx, relativePath, scope) {
-    let baseAbs = ctx.paths.workspaceDir;
-    if (scope === 'src') {
-        baseAbs = path.join(ctx.paths.appRoot, 'src');
+    const targetScope = scope || 'workspace';
+    let baseAbs = null;
+    if (targetScope === 'workspace') {
+        baseAbs = ctx.paths.workspaceDir;
+    }
+    else if (targetScope === 'src') {
+        baseAbs = resolveScopeBase(process.env.FREYA_FS_SRC, path.join(ctx.paths.appRoot, 'src'), ctx.paths.launchDir);
     }
-    else if (scope === 'doc') {
-        baseAbs = path.join(ctx.paths.appRoot, 'doc');
+    else if (targetScope === 'doc') {
+        baseAbs = resolveScopeBase(process.env.FREYA_FS_DOC, path.join(ctx.paths.appRoot, 'doc'), ctx.paths.launchDir);
+    }
+    if (!baseAbs) {
+        throw new Error(`安全拒绝：作用域 "${targetScope}" 未开放或已被禁用。`);
     }
     if (relativePath && path.isAbsolute(relativePath)) {
         throw new Error('安全拒绝：只能使用相对路径，不允许使用绝对路径。');
@@ -42,6 +79,7 @@ function formatBytes(bytes) {
 }
 export class ListDirTool {
     getDefinition() {
+        const { scopes, description } = getActiveScopesInfo();
         return {
             name: 'list_dir',
             description: '列出指定目录下的文件和子文件夹列表。注意：仅允许访问相对路径，不可传绝对路径或向上越级 escape 路径。',
@@ -54,8 +92,8 @@ export class ListDirTool {
                     },
                     scope: {
                         type: 'string',
-                        enum: ['workspace', 'src', 'doc'],
-                        description: '读取作用域（可选，默认为 "workspace" 沙箱，支持指定 "src" 源码区或 "doc" 文档区）'
+                        enum: scopes,
+                        description
                     }
                 }
             }
@@ -101,6 +139,7 @@ export class ListDirTool {
 }
 export class ReadFileTool {
     getDefinition() {
+        const { scopes, description } = getActiveScopesInfo();
         return {
             name: 'read_file',
             description: '读取指定文件的文本内容。支持指定行号起止区间切片读取，防范大文件上下文超限。',
@@ -113,8 +152,8 @@ export class ReadFileTool {
                     },
                     scope: {
                         type: 'string',
-                        enum: ['workspace', 'src', 'doc'],
-                        description: '读取作用域（可选，默认为 "workspace" 沙箱，支持指定 "src" 源码区或 "doc" 文档区）'
+                        enum: scopes,
+                        description
                     },
                     startLine: {
                         type: 'integer',
@@ -191,7 +230,7 @@ export class WriteFileTool {
             return '❌ 参数错误：必须指定目标路径与写入内容。';
         }
         if (args.scope && args.scope !== 'workspace') {
-            return `❌ 安全拒绝：物理源码区 (src) 与文档区 (doc) 为只读保护区，严禁写入或修改。`;
+            return '❌ 安全拒绝：仅允许在工作区 (workspace) 进行写入操作，其它区域均为只读保护区。';
         }
         try {
             const { targetAbs, baseAbs } = getSafePath(ctx, args.path);
@@ -235,7 +274,7 @@ export class EditFileTool {
             return '❌ 参数错误：必须指定目标路径、查找目标与替换文本。';
         }
         if (args.scope && args.scope !== 'workspace') {
-            return `❌ 安全拒绝：物理源码区 (src) 与文档区 (doc) 为只读保护区，严禁写入或修改。`;
+            return '❌ 安全拒绝：仅允许在工作区 (workspace) 进行修改操作，其它区域均为只读保护区。';
         }
         try {
             const { targetAbs, baseAbs } = getSafePath(ctx, args.path);
@@ -244,11 +283,15 @@ export class EditFileTool {
                 return `❌ 路径 "${args.path}" 不是一个有效的文件。`;
             }
             const content = await fs.readFile(targetAbs, 'utf-8');
-            const index = content.indexOf(args.target);
-            if (index === -1) {
+            const firstIndex = content.indexOf(args.target);
+            if (firstIndex === -1) {
                 return `❌ 修改失败：在文件 "${args.path}" 中未找到指定的 target 文本。请确保 target 在大小写、缩进和换行上与文件内完全一致。`;
             }
-            const newContent = content.slice(0, index) + args.replacement + content.slice(index + args.target.length);
+            const secondIndex = content.indexOf(args.target, firstIndex + args.target.length);
+            if (secondIndex !== -1) {
+                return `❌ 修改拒绝：在文件 "${args.path}" 中匹配到多处相同的目标文本。请扩大 target 文本段以包含更多上下文行确保唯一性。`;
+            }
+            const newContent = content.slice(0, firstIndex) + args.replacement + content.slice(firstIndex + args.target.length);
             await fs.writeFile(targetAbs, newContent, 'utf-8');
             return `ℹ️ 已成功修改文件 "${args.path}" 的指定部分。`;
         }

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

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

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

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

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

@@ -23,7 +23,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.5.0",
+    "@eoasmxd/freya-sdk": "^0.5.2",
     "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.5.0"
+    "@eoasmxd/freya-sdk": "^0.5.2"
   },
   "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.5.0",
+    "@eoasmxd/freya-sdk": "^0.5.2",
     "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.5.0",
+    "@eoasmxd/freya-sdk": "^0.5.2",
     "qrcode": "^1.5.4"
   },
   "devDependencies": {

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

@@ -6,7 +6,7 @@ import type {
   Logger,
 } from '@eoasmxd/freya-sdk';
 import path from 'node:path';
-import { FREYA_APP, FREYA_HOME, FREYA_WORKSPACE } from './utils/paths.js';
+import { FREYA_APP, FREYA_HOME, FREYA_LAUNCH } from './utils/paths.js';
 
 export class DefaultFreyaContext implements FreyaContext {
   logger!: Logger;
@@ -25,7 +25,7 @@ export class DefaultFreyaContext implements FreyaContext {
     return {
       appRoot: FREYA_APP,
       homeDir: FREYA_HOME,
-      workspaceRoot: FREYA_WORKSPACE,
+      launchDir: FREYA_LAUNCH,
       dataDir: path.join(FREYA_HOME, 'data'),
       workspaceDir,
     };

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 { FREYA_APP, FREYA_HOME, FREYA_WORKSPACE } from '../utils/paths.js';
+import { FREYA_APP, FREYA_HOME, FREYA_LAUNCH } 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' | 'workspace' | 'runtime' | 'npm';
+  source?: 'builtin' | 'launch' | 'runtime' | 'npm';
 }
 
 interface DiscoveredPluginInfo {
@@ -28,7 +28,7 @@ interface DiscoveredPluginInfo {
   displayName: string;
   description: string;
   version: string;
-  source: 'builtin' | 'workspace' | 'runtime' | 'npm';
+  source: 'builtin' | 'launch' | 'runtime' | 'npm';
   defaultEnabled?: boolean;
   prompts?: string[];
   valid: boolean;
@@ -232,7 +232,7 @@ export class FreyaPluginManager {
    */
   private async inspectPluginPackage(
     dirPath: string,
-    source: 'builtin' | 'workspace' | 'runtime' | 'npm'
+    source: 'builtin' | 'launch' | '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' || source === 'workspace') && pkg.freya?.defaultEnabled === true);
+      const defaultEnabled = ((source === 'builtin' || source === 'launch') && 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(FREYA_WORKSPACE), path.join(FREYA_HOME), path.join(FREYA_APP), process.cwd()]
+          paths: [path.join(FREYA_LAUNCH), path.join(FREYA_HOME), path.join(FREYA_APP), process.cwd()]
         });
       } catch {
         return {
@@ -418,17 +418,17 @@ export class FreyaPluginManager {
       }
     } catch { }
 
-    const workspaceDir = path.join(FREYA_WORKSPACE, 'plugins');
+    const launchPluginsDir = path.join(FREYA_LAUNCH, 'plugins');
     const resolvedBuiltin = path.resolve(builtinDir);
-    const resolvedWorkspace = path.resolve(workspaceDir);
+    const resolvedLaunch = path.resolve(launchPluginsDir);
     const resolvedRuntime = path.resolve(path.join(FREYA_HOME, 'plugins'));
 
-    if (resolvedWorkspace !== resolvedBuiltin && resolvedWorkspace !== resolvedRuntime) {
+    if (resolvedLaunch !== resolvedBuiltin && resolvedLaunch !== resolvedRuntime) {
       try {
-        const entries = await fs.readdir(workspaceDir, { withFileTypes: true });
+        const entries = await fs.readdir(launchPluginsDir, { withFileTypes: true });
         for (const entry of entries) {
           if (entry.isDirectory()) {
-            const info = await this.inspectPluginPackage(path.join(workspaceDir, entry.name), 'workspace');
+            const info = await this.inspectPluginPackage(path.join(launchPluginsDir, entry.name), 'launch');
             if (info) {
               const existing = map.get(info.id);
               if (existing?.source === 'builtin') {