@eoasmxd/freya 0.5.1 → 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.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';
 /** 提示词内存注册表，管理所有系统及插件级提示词的分类检索 */
 export class FreyaPromptRegistry {
     prompts = new Map();
@@ -9,10 +9,10 @@ export class FreyaPromptRegistry {
         const rawPaths = [];
         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_LAUNCH, 'config', prompt.configFileName));
         }
         rawPaths.push(path.join(FREYA_HOME, 'config', 'prompts', baseName));
-        rawPaths.push(path.join(FREYA_WORKSPACE, 'config', 'prompts', baseName));
+        rawPaths.push(path.join(FREYA_LAUNCH, 'config', 'prompts', baseName));
         rawPaths.push(prompt.defaultPath);
         const candidates = [];
         const seen = new Set();

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.1",
+  "version": "0.5.2",
   "private": false,
   "license": "MIT",
   "publishConfig": {
@@ -16,7 +16,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.5.1",
+    "@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.1",
+  "version": "0.5.2",
   "license": "MIT",
   "type": "module",
   "description": "Freya - 微内核智能体系统",
@@ -35,7 +35,7 @@
     "src"
   ],
   "dependencies": {
-    "@eoasmxd/freya-sdk": "^0.5.1",
+    "@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.1"
+    "@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.1"
+    "@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.1"
+    "@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.1"
+    "@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.1"
+    "@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.1",
+    "@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.1"
+    "@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.1",
+    "@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.1",
+    "@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') {

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 { FREYA_APP, FREYA_HOME, FREYA_WORKSPACE } from '../utils/paths.js';
+import { FREYA_APP, FREYA_HOME, FREYA_LAUNCH } from '../utils/paths.js';
 
 export interface FreyaPrompt {
   key: string;
@@ -19,11 +19,11 @@ export class FreyaPromptRegistry {
 
     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_LAUNCH, 'config', prompt.configFileName));
     }
 
     rawPaths.push(path.join(FREYA_HOME, 'config', 'prompts', baseName));
-    rawPaths.push(path.join(FREYA_WORKSPACE, 'config', 'prompts', baseName));
+    rawPaths.push(path.join(FREYA_LAUNCH, 'config', 'prompts', baseName));
     rawPaths.push(prompt.defaultPath);
 
     const candidates: string[] = [];

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 { FREYA_APP, FREYA_HOME, FREYA_WORKSPACE } from '../utils/paths.js';
+import { FREYA_APP, FREYA_HOME, FREYA_LAUNCH } from '../utils/paths.js';
 
 export interface FreyaSkill {
   id: string;
@@ -9,7 +9,7 @@ export interface FreyaSkill {
   description: string;
   content: string;
   enabled: boolean;
-  source: 'builtin' | 'workspace' | 'runtime';
+  source: 'builtin' | 'launch' | 'runtime';
 }
 
 /** 技能注册表，从 skills/ 目录加载 Markdown 格式技能并管理软开关状态 */
@@ -20,7 +20,7 @@ export class FreyaSkillRegistry {
   async loadSkills(context: FreyaContext): Promise<void> {
     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');
 
@@ -29,11 +29,11 @@ export class FreyaSkillRegistry {
       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);
@@ -77,7 +77,7 @@ export class FreyaSkillRegistry {
   }
 
   /** 从指定目录加载技能到内存注册表中 */
-  private async loadSkillsFromDirectory(dirPath: string, source: 'builtin' | 'workspace' | 'runtime', context: FreyaContext): Promise<void> {
+  private async loadSkillsFromDirectory(dirPath: string, source: 'builtin' | 'launch' | 'runtime', context: FreyaContext): Promise<void> {
     try {
       const files = await fs.readdir(dirPath);
       for (const file of files) {