@becrafter/prompt-manager 0.1.21 → 0.1.31

package/packages/server/toolm/tool-description-generator-optimized.service.js

@@ -1,6 +1,6 @@
 /**
  * 工具描述生成服务（优化版）
- * 
+ *
  * 从AI模型理解和使用工具的角度优化：
  * 1. 提高信息密度，减少冗余
  * 2. 增强语义匹配能力（利用tags、category）
@@ -19,7 +19,7 @@ import { logger } from '../utils/logger.js';
  */
 function groupToolsByCategory(tools) {
   const grouped = {};
-  
+
   for (const tool of tools) {
     const category = tool.metadata.category || 'other';
     if (!grouped[category]) {
@@ -27,14 +27,14 @@ function groupToolsByCategory(tools) {
     }
     grouped[category].push(tool);
   }
-  
+
   // 按category名称排序
   const sortedCategories = Object.keys(grouped).sort();
   const result = {};
   for (const cat of sortedCategories) {
     result[cat] = grouped[cat].sort((a, b) => a.name.localeCompare(b.name));
   }
-  
+
   return result;
 }
 
@@ -45,14 +45,14 @@ function groupToolsByCategory(tools) {
  */
 function generateUsageScenarios(tools) {
   const scenarios = [];
-  
+
   for (const tool of tools) {
     const { name, metadata } = tool;
     const toolId = `tool://${name}`;
-    
+
     // 策略1：优先使用scenarios，合并前2个场景（如果存在）
     let scenarioText = '';
-    
+
     if (metadata.scenarios && metadata.scenarios.length > 0) {
       // 合并前2个场景，用"或"连接，提供更丰富的语义信息
       if (metadata.scenarios.length >= 2) {
@@ -62,26 +62,28 @@ function generateUsageScenarios(tools) {
       }
     } else if (metadata.description) {
       // 策略2：从description中提取核心语义（前80字符，更完整）
-      scenarioText = metadata.description.length > 80 
-        ? metadata.description.substring(0, 80) + '...'
-        : metadata.description;
+      scenarioText =
+        metadata.description.length > 80 ? `${metadata.description.substring(0, 80)}...` : metadata.description;
     } else {
       // 策略3：使用工具名称和category
       const category = metadata.category ? `（${metadata.category}类）` : '';
       scenarioText = `需要使用 ${name} 功能${category}`;
     }
-    
+
     // 添加tags作为语义增强（如果存在）
     let tagsHint = '';
     if (metadata.tags && metadata.tags.length > 0) {
       // 只显示前3个最相关的tags
-      const keyTags = metadata.tags.slice(0, 3).map(t => `#${t}`).join(' ');
+      const keyTags = metadata.tags
+        .slice(0, 3)
+        .map(t => `#${t}`)
+        .join(' ');
       tagsHint = ` ${keyTags}`;
     }
-    
+
     scenarios.push(`- IF ${scenarioText}${tagsHint} → 使用 ${toolId}`);
   }
-  
+
   return scenarios.join('\n');
 }
 
@@ -92,26 +94,26 @@ function generateUsageScenarios(tools) {
  */
 function generateCategorizedToolList(groupedTools) {
   const sections = [];
-  
+
   const categoryNames = {
-    'system': '系统工具',
-    'utility': '实用工具',
-    'ai': 'AI工具',
-    'browser': '浏览器工具',
-    'other': '其他工具'
+    system: '系统工具',
+    utility: '实用工具',
+    ai: 'AI工具',
+    browser: '浏览器工具',
+    other: '其他工具'
   };
-  
+
   for (const [category, tools] of Object.entries(groupedTools)) {
     const categoryName = categoryNames[category] || category;
     const toolItems = [];
-    
+
     for (const tool of tools) {
       const { name, metadata } = tool;
       const toolId = `tool://${name}`;
-      
+
       // 生成工具描述（优化截断逻辑）
       let description = metadata.description || `${name} 工具`;
-      
+
       // 智能截断：尝试在句号、逗号处截断，保持语义完整
       if (description.length > 120) {
         const truncated = description.substring(0, 120);
@@ -124,22 +126,22 @@ function generateCategorizedToolList(groupedTools) {
         if (lastPunctuation > 80) {
           description = truncated.substring(0, lastPunctuation + 1);
         } else {
-          description = truncated + '...';
+          description = `${truncated}...`;
         }
       }
-      
+
       // 添加tags（如果存在）
       let tagsDisplay = '';
       if (metadata.tags && metadata.tags.length > 0) {
         tagsDisplay = ` [${metadata.tags.slice(0, 3).join(', ')}]`;
       }
-      
+
       toolItems.push(`  - **${toolId}** - ${description}${tagsDisplay}`);
     }
-    
+
     sections.push(`### ${categoryName}\n${toolItems.join('\n')}`);
   }
-  
+
   return sections.join('\n\n');
 }
 
@@ -152,55 +154,55 @@ function generateToolComparison(tools) {
   // 识别相似工具（基于category和tags）
   const similarGroups = [];
   const processed = new Set();
-  
+
   for (let i = 0; i < tools.length; i++) {
     if (processed.has(i)) continue;
-    
+
     const tool1 = tools[i];
     const group = [tool1];
     processed.add(i);
-    
+
     // 查找相似工具（相同category或tags重叠）
     for (let j = i + 1; j < tools.length; j++) {
       if (processed.has(j)) continue;
-      
+
       const tool2 = tools[j];
-      
+
       // 判断相似度：相同category或tags有重叠
       const sameCategory = tool1.metadata.category === tool2.metadata.category;
-      const tagsOverlap = tool1.metadata.tags && tool2.metadata.tags &&
+      const tagsOverlap =
+        tool1.metadata.tags &&
+        tool2.metadata.tags &&
         tool1.metadata.tags.some(tag => tool2.metadata.tags.includes(tag));
-      
+
       if (sameCategory && tagsOverlap) {
         group.push(tool2);
         processed.add(j);
       }
     }
-    
+
     if (group.length > 1) {
       similarGroups.push(group);
     }
   }
-  
+
   if (similarGroups.length === 0) {
     return '';
   }
-  
+
   const comparisons = [];
   for (const group of similarGroups) {
     const toolNames = group.map(t => `tool://${t.name}`).join('、');
     const differences = [];
-    
+
     for (const tool of group) {
-      const keyFeature = tool.metadata.description?.split('，')[0] || 
-                        tool.metadata.scenarios?.[0] || 
-                        tool.name;
+      const keyFeature = tool.metadata.description?.split('，')[0] || tool.metadata.scenarios?.[0] || tool.name;
       differences.push(`- **${tool.name}**：${keyFeature}`);
     }
-    
+
     comparisons.push(`**相似工具对比**（${toolNames}）：\n${differences.join('\n')}`);
   }
-  
+
   return comparisons.join('\n\n');
 }
 
@@ -215,30 +217,30 @@ export function generateToolmDescription() {
       logger.warn('工具加载器尚未初始化，使用默认描述');
       return getDefaultDescription();
     }
-    
+
     // 获取所有工具
     const tools = toolLoaderService.getAllTools();
-    
+
     if (tools.length === 0) {
       logger.warn('未发现任何工具，使用默认描述');
       return getDefaultDescription();
     }
-    
+
     // 按名称排序（用于IF-THEN规则）
     tools.sort((a, b) => a.name.localeCompare(b.name));
-    
+
     // 按分类组织工具
     const groupedTools = groupToolsByCategory(tools);
-    
+
     // 生成使用场景规则
     const usageScenarios = generateUsageScenarios(tools);
-    
+
     // 生成分类工具列表
     const categorizedToolList = generateCategorizedToolList(groupedTools);
-    
+
     // 生成工具对比信息
     const toolComparison = generateToolComparison(tools);
-    
+
     // 组装完整的描述（优化结构，减少冗余）
     const description = `🛠️ ToolM 是 Prompt Manager 新一代工具系统运行时，提供统一的工具管理和执行能力。
 
@@ -309,7 +311,6 @@ ${categorizedToolList}
 
     logger.debug('工具描述生成成功（优化版）', { toolCount: tools.length });
     return description;
-    
   } catch (error) {
     logger.error('生成工具描述失败，使用默认描述', { error: error.message });
     return getDefaultDescription();
@@ -375,4 +376,3 @@ parameters:
 - 不要忘记 "tool://" 前缀
 - 不要跳过手册，首次使用必须先看 manual`;
 }
-

package/packages/server/toolm/tool-description-generator.service.js

@@ -1,6 +1,6 @@
 /**
  * 工具描述生成服务
- * 
+ *
  * 职责：
  * 1. 从工具加载服务获取所有工具的元数据
  * 2. 动态生成 toolm 工具的 description
@@ -17,31 +17,30 @@ import { logger } from '../utils/logger.js';
  */
 function generateUsageScenarios(tools) {
   const scenarios = [];
-  
+
   for (const tool of tools) {
     const { name, metadata } = tool;
     const toolId = `tool://${name}`;
-    
+
     // 从 metadata 中提取使用场景描述
     // 优先使用 scenarios 字段的第一个场景，如果没有则从 description 提取关键词
     let scenarioText = '';
-    
+
     if (metadata.scenarios && metadata.scenarios.length > 0) {
       // 使用第一个场景作为主要描述
       scenarioText = metadata.scenarios[0];
     } else if (metadata.description) {
       // 从描述中提取核心功能关键词（前60个字符）
-      scenarioText = metadata.description.length > 60 
-        ? metadata.description.substring(0, 60) + '...'
-        : metadata.description;
+      scenarioText =
+        metadata.description.length > 60 ? `${metadata.description.substring(0, 60)}...` : metadata.description;
     } else {
       // 使用工具名称
       scenarioText = `需要使用 ${name} 功能`;
     }
-    
+
     scenarios.push(`- IF ${scenarioText} → 使用 ${toolId}`);
   }
-  
+
   return scenarios.join('\n');
 }
 
@@ -52,22 +51,22 @@ function generateUsageScenarios(tools) {
  */
 function generateToolList(tools) {
   const toolItems = [];
-  
+
   for (const tool of tools) {
     const { name, metadata } = tool;
     const toolId = `tool://${name}`;
-    
+
     // 生成工具描述
     let description = metadata.description || `${name} 工具`;
-    
+
     // 如果描述太长，截取前100个字符
     if (description.length > 100) {
-      description = description.substring(0, 100) + '...';
+      description = `${description.substring(0, 100)}...`;
     }
-    
+
     toolItems.push(`- **${toolId}** - ${description}`);
   }
-  
+
   return toolItems.join('\n');
 }
 
@@ -82,24 +81,24 @@ export function generateToolmDescription() {
       logger.warn('工具加载器尚未初始化，使用默认描述');
       return getDefaultDescription();
     }
-    
+
     // 获取所有工具
     const tools = toolLoaderService.getAllTools();
-    
+
     if (tools.length === 0) {
       logger.warn('未发现任何工具，使用默认描述');
       return getDefaultDescription();
     }
-    
+
     // 按名称排序
     tools.sort((a, b) => a.name.localeCompare(b.name));
-    
+
     // 生成使用场景规则
     const usageScenarios = generateUsageScenarios(tools);
-    
+
     // 生成工具列表
     const toolList = generateToolList(tools);
-    
+
     // 组装完整的描述
     const description = `ToolM 是 Prompt Manager 新一代工具系统运行时，提供统一的工具管理和执行能力。
 
@@ -240,7 +239,6 @@ mode: manual\`
 
     logger.debug('工具描述生成成功', { toolCount: tools.length });
     return description;
-    
   } catch (error) {
     logger.error('生成工具描述失败，使用默认描述', { error: error.message });
     return getDefaultDescription();
@@ -309,4 +307,3 @@ yaml 参数必须是完整的 YAML 文档：
 - 不要忘记 "tool://" 前缀（不是 "tool: filesystem"）
 - 不要跳过手册，首次使用必须先看 manual`;
 }
-

package/packages/server/toolm/tool-environment.service.js

@@ -1,6 +1,6 @@
 /**
  * 工具环境变量管理服务
- * 
+ *
  * 职责：
  * 1. 管理工具的环境变量配置（.env 文件）
  * 2. 加载环境变量到工具执行环境
@@ -9,9 +9,9 @@
 
 import fs from 'fs-extra';
 import path from 'path';
-import os from 'os';
 import { logger } from '../utils/logger.js';
 import { pathExists } from './tool-utils.js';
+import { config } from '../utils/config.js';
 
 /**
  * 加载工具环境变量
@@ -19,52 +19,50 @@ import { pathExists } from './tool-utils.js';
  * @returns {object} 环境变量对象
  */
 export async function loadToolEnvironment(toolName) {
-  const toolDir = path.join(os.homedir(), '.prompt-manager', 'toolbox', toolName);
+  const toolDir = config.getToolDir(toolName);
   const envFilePath = path.join(toolDir, '.env');
-  
+
   // 检查 .env 文件是否存在
-  if (!await pathExists(envFilePath)) {
+  if (!(await pathExists(envFilePath))) {
     logger.debug(`工具 ${toolName} 的 .env 文件不存在`);
     return {};
   }
-  
+
   try {
     // 读取 .env 文件内容
     const envContent = await fs.readFile(envFilePath, 'utf-8');
-    
+
     // 解析 .env 文件内容
     const envVars = {};
     const lines = envContent.split('\n');
-    
+
     for (const line of lines) {
       // 跳过注释和空行
       const trimmedLine = line.trim();
       if (!trimmedLine || trimmedLine.startsWith('#')) {
         continue;
       }
-      
+
       // 解析键值对
       const equalIndex = trimmedLine.indexOf('=');
       if (equalIndex === -1) {
         continue;
       }
-      
+
       const key = trimmedLine.substring(0, equalIndex).trim();
       let value = trimmedLine.substring(equalIndex + 1).trim();
-      
+
       // 处理带引号的值
-      if ((value.startsWith('"') && value.endsWith('"')) || 
-          (value.startsWith("'") && value.endsWith("'"))) {
+      if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
         value = value.substring(1, value.length - 1);
       }
-      
+
       // 处理转义字符
       value = value.replace(/\\n/g, '\n').replace(/\\t/g, '\t');
-      
+
       // 尝试解析JSON（如果是JSON数组或对象）
       try {
-        if ((value.startsWith('[') && value.endsWith(']')) || 
-            (value.startsWith('{') && value.endsWith('}'))) {
+        if ((value.startsWith('[') && value.endsWith(']')) || (value.startsWith('{') && value.endsWith('}'))) {
           const parsed = JSON.parse(value);
           envVars[key] = parsed;
         } else {
@@ -75,13 +73,12 @@ export async function loadToolEnvironment(toolName) {
         envVars[key] = value;
       }
     }
-    
-    logger.debug(`工具 ${toolName} 环境变量加载成功`, { 
-      count: Object.keys(envVars).length 
+
+    logger.debug(`工具 ${toolName} 环境变量加载成功`, {
+      count: Object.keys(envVars).length
     });
-    
+
     return envVars;
-    
   } catch (error) {
     logger.error(`加载工具 ${toolName} 的环境变量失败`, { error: error.message });
     return {};
@@ -94,20 +91,20 @@ export async function loadToolEnvironment(toolName) {
  * @param {object} envVars - 环境变量对象
  */
 export async function saveToolEnvironment(toolName, envVars) {
-  const toolDir = path.join(os.homedir(), '.prompt-manager', 'toolbox', toolName);
+  const toolDir = config.getToolDir(toolName);
   await fs.ensureDir(toolDir);
-  
+
   const envFilePath = path.join(toolDir, '.env');
-  
+
   // 读取现有配置（如果存在）
   const existingVars = await loadToolEnvironment(toolName);
-  
+
   // 合并配置
   const mergedVars = {
     ...existingVars,
     ...envVars
   };
-  
+
   // 生成 .env 文件内容
   let envContent = `# Tool Environment Variables
 # Tool: ${toolName}
@@ -115,11 +112,11 @@ export async function saveToolEnvironment(toolName, envVars) {
 # Last modified: ${new Date().toISOString()}
 
 `;
-  
+
   // 写入环境变量
   for (const [key, value] of Object.entries(mergedVars)) {
     let escapedValue;
-    
+
     // 如果值是对象或数组，转换为JSON字符串
     if (typeof value === 'object' && value !== null) {
       escapedValue = JSON.stringify(value);
@@ -131,20 +128,25 @@ export async function saveToolEnvironment(toolName, envVars) {
         .replace(/\n/g, '\\n')
         .replace(/\t/g, '\\t');
     }
-    
+
     // 如果值包含空格、等号或特殊字符，用引号包裹
-    if (escapedValue.includes(' ') || escapedValue.includes('=') || escapedValue.includes('[') || escapedValue.includes('{')) {
+    if (
+      escapedValue.includes(' ') ||
+      escapedValue.includes('=') ||
+      escapedValue.includes('[') ||
+      escapedValue.includes('{')
+    ) {
       escapedValue = `"${escapedValue}"`;
     }
-    
+
     envContent += `${key}=${escapedValue}\n`;
   }
-  
+
   // 写入文件
   await fs.writeFile(envFilePath, envContent, 'utf-8');
-  
-  logger.info(`工具 ${toolName} 环境变量配置已保存`, { 
-    count: Object.keys(mergedVars).length 
+
+  logger.info(`工具 ${toolName} 环境变量配置已保存`, {
+    count: Object.keys(mergedVars).length
   });
 }
 
@@ -155,23 +157,23 @@ export async function saveToolEnvironment(toolName, envVars) {
  * @returns {object} 配置信息对象
  */
 export async function getToolEnvironmentInfo(toolName, schema) {
-  const toolDir = path.join(os.homedir(), '.prompt-manager', 'toolbox', toolName);
+  const toolDir = config.getToolDir(toolName);
   const envFilePath = path.join(toolDir, '.env');
-  
+
   // 加载当前配置
   const currentVars = await loadToolEnvironment(toolName);
-  
+
   // 获取环境变量定义
   const envProps = schema?.environment?.properties || {};
-  
+
   // 构建配置信息
   const configured = [];
   const unconfigured = [];
-  
+
   for (const [key, def] of Object.entries(envProps)) {
     const value = currentVars[key];
     const defaultValue = def.default;
-    
+
     if (value !== undefined) {
       configured.push({
         key,
@@ -188,7 +190,7 @@ export async function getToolEnvironmentInfo(toolName, schema) {
       });
     }
   }
-  
+
   return {
     toolName,
     envFilePath,
@@ -197,4 +199,3 @@ export async function getToolEnvironmentInfo(toolName, schema) {
     hasConfig: await pathExists(envFilePath)
   };
 }
-