@becrafter/prompt-manager 0.1.22 → 0.2.2

package/packages/server/toolm/validate-system.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * 工具系统全面验证脚本
- * 
+ *
  * 验证内容：
  * 1. 目录结构是否完整
  * 2. 文件是否存在且可读
@@ -12,9 +12,9 @@
 
 import fs from 'fs-extra';
 import path from 'path';
-import os from 'os';
 import { fileURLToPath } from 'url';
 import { pathExists } from './tool-utils.js';
+import { config } from '../utils/config.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -53,7 +53,6 @@ function section(title) {
   log(`\n${'='.repeat(60)}`, 'blue');
   log(` ${title}`, 'bright');
   log('='.repeat(60), 'blue');
-  console.log();
 }
 
 // 验证结果收集
@@ -65,32 +64,6 @@ const results = {
   errors: []
 };
 
-function check(description, test) {
-  results.total++;
-  try {
-    const result = test();
-    if (result === true || result === undefined) {
-      success(description);
-      results.passed++;
-      return true;
-    } else if (result === 'warning') {
-      warning(description);
-      results.warnings++;
-      return 'warning';
-    } else {
-      error(description);
-      results.failed++;
-      results.errors.push(description);
-      return false;
-    }
-  } catch (err) {
-    error(`${description}: ${err.message}`);
-    results.failed++;
-    results.errors.push(`${description}: ${err.message}`);
-    return false;
-  }
-}
-
 async function asyncCheck(description, test) {
   results.total++;
   try {
@@ -120,14 +93,14 @@ async function asyncCheck(description, test) {
 // 1. 验证目录结构
 async function validateDirectoryStructure() {
   section('1. 验证目录结构');
-  
+
   const rootDir = path.join(__dirname, '..', '..', '..', '..');
   const paths = {
-    'tools目录': path.join(__dirname),
-    '系统工具目录': path.join(rootDir, 'packages', 'resources', 'tools'),
-    '用户工具目录': path.join(os.homedir(), '.prompt-manager', 'tools'),
+    tools目录: path.join(__dirname),
+    系统工具目录: path.join(rootDir, 'packages', 'resources', 'tools'),
+    用户工具目录: config.getToolboxDir()
   };
-  
+
   for (const [name, dirPath] of Object.entries(paths)) {
     await asyncCheck(`${name} 存在: ${dirPath}`, async () => {
       const exists = await pathExists(dirPath);
@@ -145,19 +118,19 @@ async function validateDirectoryStructure() {
 // 2. 验证核心文件
 async function validateCoreFiles() {
   section('2. 验证核心文件');
-  
+
   const coreFiles = [
     { name: '工具加载服务', path: path.join(__dirname, 'tool-loader.service.js') },
     { name: '工具管理处理器', path: path.join(__dirname, 'tool-manager.handler.js') },
     { name: '工具系统入口', path: path.join(__dirname, 'index.js') },
-    { name: 'MCP服务器', path: path.join(__dirname, '..', 'mcp.server.js') },
+    { name: 'MCP服务器', path: path.join(__dirname, '..', 'mcp.server.js') }
   ];
-  
+
   for (const file of coreFiles) {
     await asyncCheck(`${file.name} 文件存在`, async () => {
       return await pathExists(file.path);
     });
-    
+
     await asyncCheck(`${file.name} 可读`, async () => {
       try {
         await fs.access(file.path, fs.constants.R_OK);
@@ -172,24 +145,24 @@ async function validateCoreFiles() {
 // 3. 验证工具文件
 async function validateToolFiles() {
   section('3. 验证工具文件');
-  
+
   const rootDir = path.join(__dirname, '..', '..', '..', '..');
   const toolsDir = path.join(rootDir, 'packages', 'resources', 'tools');
-  
-  if (!await pathExists(toolsDir)) {
+
+  if (!(await pathExists(toolsDir))) {
     error(`工具目录不存在: ${toolsDir}`);
     return;
   }
-  
+
   const toolDirs = await fs.readdir(toolsDir);
   info(`找到 ${toolDirs.length} 个工具目录`);
-  
+
   for (const toolDir of toolDirs) {
     const toolPath = path.join(toolsDir, toolDir);
     const stat = await fs.stat(toolPath);
-    
+
     if (!stat.isDirectory()) continue;
-    
+
     const toolFile = path.join(toolPath, `${toolDir}.tool.js`);
     await asyncCheck(`工具 '${toolDir}' 文件存在`, async () => {
       return await pathExists(toolFile);
@@ -200,19 +173,19 @@ async function validateToolFiles() {
 // 4. 验证模块导入
 async function validateModuleImports() {
   section('4. 验证模块导入');
-  
+
   // 验证工具加载服务
   await asyncCheck('导入工具加载服务', async () => {
     const module = await import('./tool-loader.service.js');
     return module.toolLoaderService !== undefined;
   });
-  
+
   // 验证工具管理处理器
   await asyncCheck('导入工具管理处理器', async () => {
     const module = await import('./tool-manager.handler.js');
     return typeof module.handleToolM === 'function';
   });
-  
+
   // 验证工具系统入口
   await asyncCheck('导入工具系统入口', async () => {
     const module = await import('./index.js');
@@ -223,44 +196,44 @@ async function validateModuleImports() {
 // 5. 验证工具接口规范
 async function validateToolInterfaces() {
   section('5. 验证工具接口规范');
-  
+
   const rootDir = path.join(__dirname, '..', '..', '..', '..');
   const toolsDir = path.join(rootDir, 'packages', 'resources', 'tools');
-  
-  if (!await pathExists(toolsDir)) {
+
+  if (!(await pathExists(toolsDir))) {
     warning('工具目录不存在，跳过接口验证');
     return;
   }
-  
+
   const toolDirs = await fs.readdir(toolsDir);
-  
+
   for (const toolDir of toolDirs) {
     const toolPath = path.join(toolsDir, toolDir);
     const stat = await fs.stat(toolPath);
-    
+
     if (!stat.isDirectory()) continue;
-    
+
     const toolFile = path.join(toolPath, `${toolDir}.tool.js`);
-    
-    if (!await pathExists(toolFile)) continue;
-    
+
+    if (!(await pathExists(toolFile))) continue;
+
     await asyncCheck(`工具 '${toolDir}' 符合接口规范`, async () => {
       const toolModule = await import(toolFile);
       const tool = toolModule.default || toolModule;
-      
+
       // 必需方法
       if (typeof tool.execute !== 'function') {
         throw new Error('缺少 execute 方法');
       }
-      
+
       // 推荐方法
       const recommendedMethods = ['getMetadata', 'getSchema', 'getDependencies', 'getBusinessErrors'];
       const missing = recommendedMethods.filter(method => typeof tool[method] !== 'function');
-      
+
       if (missing.length > 0) {
         info(`  缺少推荐方法: ${missing.join(', ')}`);
       }
-      
+
       return true;
     });
   }
@@ -269,25 +242,25 @@ async function validateToolInterfaces() {
 // 6. 验证工具加载器功能
 async function validateToolLoaderFunctionality() {
   section('6. 验证工具加载器功能');
-  
+
   const { toolLoaderService } = await import('./tool-loader.service.js');
-  
+
   await asyncCheck('初始化工具加载器', async () => {
     await toolLoaderService.initialize();
     return toolLoaderService.initialized === true;
   });
-  
+
   await asyncCheck('获取工具列表', async () => {
     const tools = toolLoaderService.getAllTools();
     info(`  加载了 ${tools.length} 个工具`);
     return Array.isArray(tools);
   });
-  
+
   // 检查 filesystem 工具
   await asyncCheck('filesystem 工具已加载', async () => {
     return toolLoaderService.hasTool('filesystem');
   });
-  
+
   if (toolLoaderService.hasTool('filesystem')) {
     await asyncCheck('获取 filesystem 工具详情', async () => {
       const tool = toolLoaderService.getTool('filesystem');
@@ -295,7 +268,7 @@ async function validateToolLoaderFunctionality() {
       info(`  工具描述: ${tool.metadata.description}`);
       return tool !== undefined;
     });
-    
+
     await asyncCheck('生成 filesystem 工具手册', async () => {
       const manual = toolLoaderService.generateManual('filesystem');
       return typeof manual === 'string' && manual.length > 0;
@@ -306,29 +279,29 @@ async function validateToolLoaderFunctionality() {
 // 7. 验证工具管理处理器功能
 async function validateToolManagerFunctionality() {
   section('7. 验证工具管理处理器功能');
-  
+
   const { handleToolM } = await import('./tool-manager.handler.js');
-  
+
   // 测试 manual 模式
   await asyncCheck('手册模式正常工作', async () => {
     const yamlInput = `tool: tool://filesystem
 mode: manual`;
-    
+
     const result = await handleToolM({ yaml: yamlInput });
     return result.content && result.content[0].type === 'text';
   });
-  
+
   // 测试 execute 模式
   await asyncCheck('执行模式正常工作', async () => {
     const yamlInput = `tool: tool://filesystem
 mode: execute
 parameters:
   method: list_allowed_directories`;
-    
+
     const result = await handleToolM({ yaml: yamlInput });
     return result.content && result.content[0].type === 'text';
   });
-  
+
   // 测试错误处理
   await asyncCheck('错误处理正常工作', async () => {
     try {
@@ -345,12 +318,12 @@ mode: execute`;
 // 8. 验证 MCP 服务器集成
 async function validateMCPServerIntegration() {
   section('8. 验证 MCP 服务器集成');
-  
+
   await asyncCheck('MCP 服务器模块可导入', async () => {
     const module = await import('../mcp.server.js');
     return typeof module.getMcpServer === 'function';
   });
-  
+
   await asyncCheck('MCP 服务器包含 toolm 工具', async () => {
     // 这需要实际启动服务器才能验证，这里只检查导入
     info('  需要启动服务器才能完全验证，当前仅检查模块导入');
@@ -361,7 +334,7 @@ async function validateMCPServerIntegration() {
 // 9. 生成报告
 function generateReport() {
   section('验证结果汇总');
-  
+
   console.log(`总计测试: ${results.total}`);
   log(`通过: ${results.passed}`, 'green');
   if (results.warnings > 0) {
@@ -370,17 +343,17 @@ function generateReport() {
   if (results.failed > 0) {
     log(`失败: ${results.failed}`, 'red');
   }
-  
-  const percentage = (results.passed / results.total * 100).toFixed(1);
+
+  const percentage = ((results.passed / results.total) * 100).toFixed(1);
   console.log(`\n通过率: ${percentage}%`);
-  
+
   if (results.errors.length > 0) {
     section('失败的测试');
     results.errors.forEach((err, index) => {
       error(`${index + 1}. ${err}`);
     });
   }
-  
+
   console.log();
   if (results.failed === 0) {
     log('🎉 所有验证通过！工具系统已准备就绪。', 'green');
@@ -396,7 +369,7 @@ async function main() {
   log('\n╔════════════════════════════════════════════════════════╗', 'cyan');
   log('║     Prompt Manager 工具系统全面验证                    ║', 'cyan');
   log('╚════════════════════════════════════════════════════════╝', 'cyan');
-  
+
   try {
     await validateDirectoryStructure();
     await validateCoreFiles();
@@ -406,7 +379,7 @@ async function main() {
     await validateToolLoaderFunctionality();
     await validateToolManagerFunctionality();
     await validateMCPServerIntegration();
-    
+
     const success = generateReport();
     process.exit(success ? 0 : 1);
   } catch (error) {
@@ -418,4 +391,3 @@ async function main() {
 
 // 运行验证
 main();
-

package/packages/server/utils/config.js

@@ -1,7 +1,6 @@
 import fs from 'fs-extra';
 import path from 'path';
 import os from 'os';
-import { fileURLToPath } from 'url';
 import crypto from 'crypto';
 import dotenv from 'dotenv';
 
@@ -25,8 +24,6 @@ function expandPath(inputPath) {
 const configHome = path.join(os.homedir(), '.prompt-manager');
 dotenv.config({ path: path.join(configHome, '.env') });
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
 const DEFAULT_HOME_DIR = path.join(os.homedir(), '.prompt-manager');
 const DEFAULT_PROMPTS_DIR = path.join(DEFAULT_HOME_DIR, 'prompts');
 
@@ -109,10 +106,8 @@ export class Config {
     }
 
     // 确定prompts目录
-    this.promptsDir = expandPath(cliArgs.promptsDir) ||
-      expandPath(process.env.PROMPTS_DIR) ||
-      DEFAULT_PROMPTS_DIR;
-    this.configHome = path.dirname(this.promptsDir);
+    this.promptsDir = expandPath(cliArgs.promptsDir) || expandPath(process.env.PROMPTS_DIR) || DEFAULT_PROMPTS_DIR;
+    this.configHome = DEFAULT_HOME_DIR;
 
     // 服务器端口
     this.port = cliArgs.port || process.env.SERVER_PORT || 5621;
@@ -147,7 +142,7 @@ export class Config {
     ];
 
     if (cliArgs.version) {
-      process.stderr.write(this.serverVersion + '\n');
+      process.stderr.write(`${this.serverVersion}\n`);
       process.exit(0);
     }
 
@@ -181,7 +176,6 @@ export class Config {
 
     if (promptsDir) {
       this.promptsDir = expandPath(promptsDir);
-      this.configHome = path.dirname(this.promptsDir);
     }
     if (port) {
       this.port = port;
@@ -221,7 +215,6 @@ export class Config {
     }
   }
 
-
   /**
    * 确保prompts目录存在
    */
@@ -230,7 +223,7 @@ export class Config {
       await fs.ensureDir(this.promptsDir);
       return true;
     } catch (error) {
-      process.stderr.write('Failed to create prompts directory: ' + error.message + '\n');
+      process.stderr.write(`Failed to create prompts directory: ${error.message}\n`);
       return false;
     }
   }
@@ -260,6 +253,67 @@ export class Config {
     this.port = port;
   }
 
+  /**
+   * 获取临时文件目录
+   * @returns {string} 临时文件目录路径
+   */
+  getTempDir() {
+    return path.join(this.getConfigHome(), 'temp');
+  }
+
+  /**
+   * 获取工具箱目录
+   * @returns {string} 工具箱目录路径
+   */
+  getToolboxDir() {
+    return path.join(this.getConfigHome(), 'toolbox');
+  }
+
+  /**
+   * 获取指定工具的目录
+   * @param {string} toolName - 工具名称
+   * @returns {string} 工具目录路径
+   * @throws {Error} 如果 toolName 未提供
+   */
+  getToolDir(toolName) {
+    if (!toolName) {
+      throw new Error('toolName is required for getToolDir()');
+    }
+    return path.join(this.getToolboxDir(), toolName);
+  }
+
+  /**
+   * 获取模型配置目录
+   * @returns {string} 模型配置目录路径
+   */
+  getModelsDir() {
+    return path.join(this.getConfigHome(), 'configs', 'models');
+  }
+
+  /**
+   * 获取模板配置目录
+   * @returns {string} 模板配置目录路径
+   */
+  getTemplatesDir() {
+    return path.join(this.getConfigHome(), 'configs', 'templates');
+  }
+
+  /**
+   * 获取用户配置目录
+   * @returns {string} 用户配置目录路径
+   */
+  getConfigsDir() {
+    return path.join(this.getConfigHome(), 'configs');
+  }
+
+  /**
+   * 获取环境变量文件路径
+   * @returns {string} .env 文件路径
+   */
+  getEnvFilePath() {
+    return path.join(this.getConfigHome(), '.env');
+  }
+
   /**
    * 获取服务器名称
    */
@@ -308,6 +362,36 @@ export class Config {
     }
   }
 
+  /**
+   * 验证配置路径一致性
+   * @throws {Error} 如果路径配置不一致
+   */
+  validatePaths() {
+    const configHome = this.getConfigHome();
+    const expectedHome = DEFAULT_HOME_DIR;
+
+    if (configHome !== expectedHome) {
+      throw new Error(`ConfigHome不一致: 期望 ${expectedHome}, 实际 ${configHome}`);
+    }
+
+    // 仅验证路径格式，不实际创建目录
+    const dirsToCheck = [
+      this.getPromptsDir(),
+      this.getTempDir(),
+      this.getToolboxDir(),
+      this.getModelsDir(),
+      this.getTemplatesDir()
+    ];
+
+    for (const dir of dirsToCheck) {
+      if (!dir || typeof dir !== 'string') {
+        throw new Error(`无效的目录路径: ${dir}`);
+      }
+    }
+
+    return true;
+  }
+
   /**
    * 获取公开配置（前端可访问的配置信息）
    */
@@ -318,7 +402,8 @@ export class Config {
       port: this.port,
       adminEnable: this.adminEnable,
       adminPath: this.adminPath,
-      websocketPort: null, // 这个会在 admin.routes.js 中动态设置
+      // WebSocket端口由WebSocketService动态分配，通过admin.routes.js暴露给前端
+      websocketPort: null,
       features: {
         terminal: true,
         optimization: true,

package/packages/server/utils/logger.js

@@ -22,7 +22,7 @@ export class Logger {
   /**
    * 格式化日志消息
    */
-  formatMessage(level, message, ...args) {
+  formatMessage(level, message) {
     const timestamp = new Date().toISOString();
     return `[${timestamp}] [${level.toUpperCase()}] ${message}`;
   }

package/packages/server/utils/port-checker.js

@@ -6,16 +6,16 @@ import net from 'net';
  * @returns {Promise<boolean>} - 端口是否可用
  */
 export async function checkPortAvailable(port) {
-  return new Promise((resolve) => {
+  return new Promise(resolve => {
     const server = net.createServer();
-    
+
     server.listen(port, () => {
       server.once('close', () => {
         resolve(true);
       });
       server.close();
     });
-    
+
     server.on('error', () => {
       resolve(false);
     });
@@ -44,15 +44,15 @@ export async function findAvailablePort(startPort, maxAttempts = 10) {
  * @returns {Promise<Object>} - 端口占用信息
  */
 export async function getPortInfo(port) {
-  return new Promise((resolve) => {
+  return new Promise(resolve => {
     const server = net.createServer();
-    
+
     server.listen(port, () => {
       server.close();
       resolve({ available: true, process: null });
     });
-    
-    server.on('error', (error) => {
+
+    server.on('error', error => {
       if (error.code === 'EADDRINUSE') {
         resolve({ available: false, error: '端口已被占用' });
       } else {
@@ -60,4 +60,4 @@ export async function getPortInfo(port) {
       }
     });
   });
-}
+}