@becrafter/prompt-manager 0.1.20 → 0.1.21

package/packages/server/api/admin.routes.js

@@ -16,6 +16,7 @@ import {adminAuthMiddleware} from '../middlewares/auth.middleware.js'
 import { templateManager } from '../services/template.service.js';
 import { modelManager } from '../services/model.service.js';
 import { optimizationService } from '../services/optimization.service.js';
+import { webSocketService } from '../services/WebSocketService.js';
 
 const router = express.Router();
 
@@ -36,6 +37,24 @@ router.get('/config', (req, res) => {
     });
 });
 
+// 获取公开配置端点（无需认证）
+router.get('/config/public', (req, res) => {
+  const publicConfig = config.getPublicConfig();
+
+  // 如果 WebSocket 服务已启动，使用实际分配的端口
+  if (webSocketService.isRunning) {
+    publicConfig.websocketPort = webSocketService.getPort();
+  } else {
+    // 如果 WebSocket 服务未启动，返回 null 表示尚未确定
+    publicConfig.websocketPort = null;
+  }
+
+  res.json({
+    success: true,
+    data: publicConfig
+  });
+});
+
 // 登录端点
 router.post('/login', (req, res) => {
     // 检查是否启用了管理员功能

package/packages/server/mcp/mcp.server.js

@@ -130,12 +130,12 @@ export const getMcpServer = async () => {
                 return handleToolM(args);
             }
         },
-        {
-            name: 'thinking',
-            description: `🧭 **智能思考工具箱**\n\n【规范名称】promptmanager_thinking\n【调用说明】在提示词中使用 promptmanager_thinking，实际调用时自动映射到 mcp__[server]__action\n\n⚠️ **务必先读说明**：每次首次使用某个 scenario 时，先发送仅包含 \`{"scenario":"..."}\` 的请求获取完整描述，确认理解适用场景与参数要求后，再携带 payload 调用。跳过此步骤易导致字段缺失或流程误用。\n\n## 核心特性\n\n- **双模式思考** - 提供顺序思考（exploratory）和思考规划（execution）两种模式\n- **智能引导** - 通过场景参数自动匹配合适的思考策略\n- **结构化流程** - 支持多轮思考追踪和分支管理\n- **错误预防** - 强制预读说明，避免参数配置错误\n- **灵活扩展** - 支持修订、分支和会话管理\n\n## 何时使用 Thinking Toolkit\n\n### 快速决策（IF-THEN 规则）：\n- IF 需要探索性思考、诊断问题、发散推理 → 使用 scenario: "exploratory"\n- IF 需要结构化规划、制定执行步骤 → 使用 scenario: "execution"\n- IF 看到 scenario 参数 → 使用 thinking_toolkit 调用\n- IF 不确定场景用法 → 先用仅包含 scenario 的请求查看说明\n\n### 首次使用任何场景\n⚠️ **必须先发送仅包含 scenario 的请求** 阅读场景完整描述\n⚠️ 示例：thinking_toolkit with scenario: "exploratory" (无payload)\n\n## 如何使用 Thinking Toolkit\n\n### 模式 1：查看场景说明（首次使用）\n\n\`\`\`javascript\nmcp_mcp-router_thinking_toolkit({\n  scenario: "exploratory"\n})\n\`\`\`\n\n**重要**：每次使用新场景前必须先执行此步骤，了解场景的具体参数要求和使用方法。\n\n### 模式 2：执行顺序思考\n\n\`\`\`javascript\nmcp_mcp-router_thinking_toolkit({\n  scenario: "exploratory",\n  payload: {\n    thought: "分析性能下降的可能原因",\n    totalThoughts: 5,\n    nextThoughtNeeded: true\n  }\n})\n\`\`\`\n\n### 模式 3：执行思考规划\n\n\`\`\`javascript\nmcp_mcp-router_thinking_toolkit({\n  scenario: "execution",\n  payload: {\n    thought: "需要上线新版本",\n    plan: "1. 备份 2. 部署 3. 验证",\n    action: "先执行备份脚本",\n    thoughtNumber: "TP-001"\n  }\n})\n\`\`\`\n\n## 关键规则\n\n### ✅ 正确格式\n- 先发送 \`{"scenario": "..."}\` 获取场景说明\n- 根据说明确认参数要求后，再携带 payload 调用\n- scenario 必填：exploratory（顺序思考）或 execution（思考规划）\n- payload 根据场景填写对应字段\n\n### ❌ 常见错误\n- 不要跳过场景说明，直接携带 payload 调用（易导致参数错误）\n- 不要混用不同场景的参数字段\n- 不要在首次使用场景时直接执行 payload\n\n## 支持的思考场景\n\n### Exploratory（顺序思考）\n适合探索、诊断、发散推理场景，支持多轮思考追踪和分支管理。\n\n### Execution（思考规划）\n适合结构化计划制定和行动追踪，按步骤执行任务规划。\n\n更多场景正在开发中...`,
-            inputSchema: thinkingToolkitInputSchema,
-            handler: async (args) => handleThinkingToolkit(args)
-        }
+        // {
+        //     name: 'thinking',
+        //     description: `🧭 **智能思考工具箱**\n\n【规范名称】promptmanager_thinking\n【调用说明】在提示词中使用 promptmanager_thinking，实际调用时自动映射到 mcp__[server]__action\n\n⚠️ **务必先读说明**：每次首次使用某个 scenario 时，先发送仅包含 \`{"scenario":"..."}\` 的请求获取完整描述，确认理解适用场景与参数要求后，再携带 payload 调用。跳过此步骤易导致字段缺失或流程误用。\n\n## 核心特性\n\n- **双模式思考** - 提供顺序思考（exploratory）和思考规划（execution）两种模式\n- **智能引导** - 通过场景参数自动匹配合适的思考策略\n- **结构化流程** - 支持多轮思考追踪和分支管理\n- **错误预防** - 强制预读说明，避免参数配置错误\n- **灵活扩展** - 支持修订、分支和会话管理\n\n## 何时使用 Thinking Toolkit\n\n### 快速决策（IF-THEN 规则）：\n- IF 需要探索性思考、诊断问题、发散推理 → 使用 scenario: "exploratory"\n- IF 需要结构化规划、制定执行步骤 → 使用 scenario: "execution"\n- IF 看到 scenario 参数 → 使用 thinking_toolkit 调用\n- IF 不确定场景用法 → 先用仅包含 scenario 的请求查看说明\n\n### 首次使用任何场景\n⚠️ **必须先发送仅包含 scenario 的请求** 阅读场景完整描述\n⚠️ 示例：thinking_toolkit with scenario: "exploratory" (无payload)\n\n## 如何使用 Thinking Toolkit\n\n### 模式 1：查看场景说明（首次使用）\n\n\`\`\`javascript\nmcp_mcp-router_thinking_toolkit({\n  scenario: "exploratory"\n})\n\`\`\`\n\n**重要**：每次使用新场景前必须先执行此步骤，了解场景的具体参数要求和使用方法。\n\n### 模式 2：执行顺序思考\n\n\`\`\`javascript\nmcp_mcp-router_thinking_toolkit({\n  scenario: "exploratory",\n  payload: {\n    thought: "分析性能下降的可能原因",\n    totalThoughts: 5,\n    nextThoughtNeeded: true\n  }\n})\n\`\`\`\n\n### 模式 3：执行思考规划\n\n\`\`\`javascript\nmcp_mcp-router_thinking_toolkit({\n  scenario: "execution",\n  payload: {\n    thought: "需要上线新版本",\n    plan: "1. 备份 2. 部署 3. 验证",\n    action: "先执行备份脚本",\n    thoughtNumber: "TP-001"\n  }\n})\n\`\`\`\n\n## 关键规则\n\n### ✅ 正确格式\n- 先发送 \`{"scenario": "..."}\` 获取场景说明\n- 根据说明确认参数要求后，再携带 payload 调用\n- scenario 必填：exploratory（顺序思考）或 execution（思考规划）\n- payload 根据场景填写对应字段\n\n### ❌ 常见错误\n- 不要跳过场景说明，直接携带 payload 调用（易导致参数错误）\n- 不要混用不同场景的参数字段\n- 不要在首次使用场景时直接执行 payload\n\n## 支持的思考场景\n\n### Exploratory（顺序思考）\n适合探索、诊断、发散推理场景，支持多轮思考追踪和分支管理。\n\n### Execution（思考规划）\n适合结构化计划制定和行动追踪，按步骤执行任务规划。\n\n更多场景正在开发中...`,
+        //     inputSchema: thinkingToolkitInputSchema,
+        //     handler: async (args) => handleThinkingToolkit(args)
+        // }
         // {
         //     name: 'reload_prompts',
         //     description: 'Force a reload of all preset prompts to overwrite the cache.',

package/packages/server/server.js

@@ -150,10 +150,11 @@ export async function startServer(options = {}) {
             // 设置服务器实例
             serverInstance = server;
             
-            // 启动WebSocket服务
+            // 启动WebSocket服务，传入 HTTP 服务器端口
             try {
-              await webSocketService.start();
-              logger.info(`WebSocket服务启动成功，端口: 5622`);
+                await webSocketService.start({ port: config.getPort() });
+                const wsPort = webSocketService.getPort();
+                logger.info(`WebSocket服务启动成功，端口: ${wsPort}`);
             } catch (wsError) {
               logger.error('WebSocket服务启动失败:', wsError.message);
               // WebSocket服务失败不影响主服务器运行

package/packages/server/services/WebSocketService.js

@@ -274,7 +274,7 @@ class WebSocketConnection {
 export class WebSocketService {
   constructor(options = {}) {
     this.options = {
-      port: 5622,
+      port: options.port || 0, // 0 表示让系统自动分配端口，或使用外部指定的端口
       host: '0.0.0.0',
       maxConnections: 100,
       heartbeatInterval: 30000, // 30秒心跳
@@ -318,11 +318,14 @@ export class WebSocketService {
 
         this.wss.on('listening', () => {
           this.isRunning = true;
-          logger.info(`WebSocket server listening on ${this.options.host}:${this.options.port}`);
-          
+          // 获取实际分配的端口
+          const address = this.wss.address();
+          this.actualPort = typeof address === 'string' ? parseInt(address) : address.port;
+          logger.info(`WebSocket server listening on ${this.options.host}:${this.actualPort}`);
+
           // 启动心跳检测
           this.startHeartbeat();
-          
+
           resolve();
         });
 
@@ -457,6 +460,13 @@ export class WebSocketService {
     return Array.from(this.connections.values());
   }
 
+  /**
+   * 获取实际分配的端口
+   */
+  getPort() {
+    return this.actualPort || this.options.port;
+  }
+
   /**
    * 获取服务状态
    */
@@ -467,7 +477,7 @@ export class WebSocketService {
 
     return {
       isRunning: this.isRunning,
-      port: this.options.port,
+      port: this.getPort(),
       host: this.options.host,
       totalConnections: this.connections.size,
       activeConnections: activeConnections.length,

package/packages/server/utils/config.js

@@ -77,14 +77,12 @@ MCP Prompt Server - 智能 Prompt 管理服务器
   -v, --version              显示版本信息
 
 环境变量:
-  MCP_SERVER_NAME            服务器名称 (默认: prompt-manager)
   SERVER_PORT                服务器端口 (默认: 5621)
   PROMPTS_DIR                Prompts目录路径
-  MCP_SERVER_VERSION         服务器版本
   LOG_LEVEL                  日志级别 (默认: info)
   MAX_PROMPTS                最大prompt数量限制 (默认: 1000)
   RECURSIVE_SCAN             是否启用递归扫描子目录 (默认: true)
-  ADMIN_ENABLE               是否启用管理员功能 (默认: true)
+  ADMIN_ENABLE               是否启用管理界面 (默认: true)
   ADMIN_REQUIRE_AUTH         是否需要登录认证 (默认: true)
   ADMIN_USERNAME             管理员用户名 (默认: admin)
   ADMIN_PASSWORD             管理员密码 (默认: admin)
@@ -120,8 +118,8 @@ export class Config {
     this.port = cliArgs.port || process.env.SERVER_PORT || 5621;
 
     // 其他配置
-    this.serverName = process.env.MCP_SERVER_NAME || 'prompt-manager';
-    this.serverVersion = process.env.MCP_SERVER_VERSION || '0.1.20';
+    this.serverName = 'prompt-manager';
+    this.serverVersion = '0.1.20';
     this.logLevel = process.env.LOG_LEVEL || 'info';
     this.maxPrompts = parseInt(process.env.MAX_PROMPTS) || 1000;
     this.recursiveScan = process.env.RECURSIVE_SCAN !== 'false'; // 默认启用递归扫描
@@ -310,6 +308,26 @@ export class Config {
     }
   }
 
+  /**
+   * 获取公开配置（前端可访问的配置信息）
+   */
+  getPublicConfig() {
+    return {
+      serverName: this.serverName,
+      serverVersion: this.serverVersion,
+      port: this.port,
+      adminEnable: this.adminEnable,
+      adminPath: this.adminPath,
+      websocketPort: null, // 这个会在 admin.routes.js 中动态设置
+      features: {
+        terminal: true,
+        optimization: true,
+        templates: true,
+        models: true
+      }
+    };
+  }
+
   /**
    * 显示当前配置（输出到 stderr，不干扰 MCP 通信）
    */
@@ -322,7 +340,7 @@ export class Config {
     process.stderr.write(`   递归扫描: ${this.recursiveScan ? '启用' : '禁用'}\n`);
     process.stderr.write(`   Prompts目录: ${this.promptsDir}\n`);
     process.stderr.write(`   最大Prompt数量: ${this.maxPrompts}\n`);
-    process.stderr.write(`   管理员功能: ${this.adminEnable ? '启用' : '禁用'}\n`);
+    process.stderr.write(`   管理界面: ${this.adminEnable ? '启用' : '禁用'}\n`);
     if (this.adminEnable) {
       process.stderr.write(`   登录认证: ${this.adminRequireAuth ? '需要' : '不需要'}\n`);
     }

package/packages/server/utils/util.js

@@ -385,39 +385,84 @@ export class Util {
     }
 
     getWebUiRoot() {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+
+        console.log('🔍 getWebUiRoot() called from:', __dirname);
+
         // 检查是否在 Electron 环境中运行
-        const isElectron = typeof process !== 'undefined' && 
-                          process.versions && 
+        const isElectron = typeof process !== 'undefined' &&
+                          process.versions &&
                           process.versions.electron;
-        
+
         // 检查是否是打包应用
         if (isElectron && process.resourcesPath) {
-            // 检查是否在打包模式（在我们的应用目录下有 app.asar）
             const ourAppAsar = path.join(process.resourcesPath, 'app.asar');
             if (fs.existsSync(ourAppAsar)) {
-                // 在打包的 Electron 应用中，web UI 位于 app.asar 内
-                return path.join(process.resourcesPath, 'app.asar', 'web');
+                const asarPath = path.join(process.resourcesPath, 'app.asar', 'web');
+                console.log('📦 Using Electron ASAR path:', asarPath);
+                return asarPath;
             }
         }
-        
-        // 在开发环境中，web UI 位于项目目录中的 packages/web
-        const __filename = fileURLToPath(import.meta.url);
-        const __dirname = path.dirname(__filename);
-        const devWebPath = path.join(__dirname, '..', 'web');
 
+        // 在开发环境中，web UI 位于项目目录中的 packages/web
+        const devWebPath = path.join(__dirname, '..', '..', 'web');
+        console.log('🔍 Checking dev path:', devWebPath);
         if (this._pathExistsSync(devWebPath)) {
+            console.log('✅ Using dev environment path:', devWebPath);
             return devWebPath;
         }
 
-        // 在 npm 包环境中，优先查找 packages/web（编译后的）
-        const projectRoot = path.resolve(__dirname, '../../..');
-        const webPath = path.join(projectRoot, 'packages', 'web');
-        if (this._pathExistsSync(webPath)) {
-            return webPath;
+        // 在 npm 包环境中，查找 packages/web
+        // 从当前文件位置向上查找可能的包根目录
+        let currentDir = __dirname;
+        let searchDepth = 0;
+        const maxDepth = 5;
+
+        while (searchDepth < maxDepth) {
+            // 检查 packages/web
+            const webPath = path.join(currentDir, 'packages', 'web');
+            console.log('🔍 Checking npm package path:', webPath);
+            if (this._pathExistsSync(webPath)) {
+                console.log('✅ Found web UI in npm package:', webPath);
+                return webPath;
+            }
+
+            // 检查直接的 web 目录（某些打包场景）
+            const altWebPath = path.join(currentDir, 'web');
+            console.log('🔍 Checking alternative path:', altWebPath);
+            if (this._pathExistsSync(altWebPath)) {
+                console.log('✅ Found web UI in alternative path:', altWebPath);
+                return altWebPath;
+            }
+
+            // 向上查找
+            const parentDir = path.dirname(currentDir);
+            if (parentDir === currentDir) {
+                // 已经到达根目录
+                break;
+            }
+            currentDir = parentDir;
+            searchDepth++;
+        }
+
+        // 如果都找不到，使用当前工作目录作为最后尝试
+        const cwdWebPath = path.join(process.cwd(), 'packages', 'web');
+        console.log('🔍 Checking CWD path:', cwdWebPath);
+        if (this._pathExistsSync(cwdWebPath)) {
+            console.log('✅ Found web UI in CWD:', cwdWebPath);
+            return cwdWebPath;
         }
 
-        // 返回默认路径
-        return devWebPath;
+        // 最后的fallback
+        console.error('❌ Web UI not found in any location. This will cause blank pages.');
+        console.error('Current directory:', __dirname);
+        console.error('Working directory:', process.cwd());
+        console.error('Checked paths:');
+        console.error('  - Dev path:', devWebPath);
+        console.error('  - CWD path:', cwdWebPath);
+
+        return devWebPath; // 返回开发路径作为fallback，虽然它不存在
     };
 
     /**