mcp-probe-kit 2.2.0 → 2.2.1

package/build/tools/gencommit.d.ts

@@ -1,4 +1,4 @@
-export declare function gencommit(args: any): Promise<import("../lib/response.js").ToolResponse | {
+export declare function gencommit(args: any): Promise<{
     content: {
         type: string;
         text: string;

package/build/tools/gencommit.js

@@ -1,6 +1,4 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
-import { okStructured } from "../lib/response.js";
-import { CommitMessageSchema } from "../schemas/structured-output.js";
 // gencommit 工具实现
 export async function gencommit(args) {
     try {
@@ -112,24 +110,17 @@ chore: 🤖 升级依赖版本至 1.2.9
 - 如果暂存区为空，提示用户先使用 \`git add\` 添加文件
 - 如果变更较多，建议分多次提交
 - 确保 commit 消息清晰描述了"做了什么"和"为什么"`;
-        // 创建示例结构化数据（用于演示格式）
-        // 注意：实际的 commit 数据应该由 AI 根据实际变更生成
-        const exampleCommitData = {
-            type: type || 'feat',
-            scope: '',
-            subject: '示例：添加新功能',
-            body: '这是一个示例 commit 消息\n\n实际使用时，AI 会根据代码变更生成真实的 commit 内容',
-            footer: '',
-            fullMessage: 'feat: 🎸 示例：添加新功能\n\n这是一个示例 commit 消息\n\n实际使用时，AI 会根据代码变更生成真实的 commit 内容',
-            emoji: '🎸',
+        // 返回纯文本指导
+        // AI 会根据这些指导分析代码变更并生成符合规范的 commit 消息
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: textMessage,
+                },
+            ],
+            isError: false,
         };
-        // 返回结构化输出
-        // textMessage 提供人类可读的指导信息
-        // exampleCommitData 提供结构化数据示例（AI 会根据实际情况生成真实数据）
-        return okStructured(textMessage, exampleCommitData, {
-            schema: CommitMessageSchema,
-            note: 'AI 应该根据实际代码变更生成真实的 commit 数据，而不是使用这个示例',
-        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);

package/docs/pages/all-tools.html

@@ -477,6 +477,72 @@
             submenu.classList.toggle('expanded');
         }
         
+        // 工具简短描述（最多4个字）
+        const toolDescriptions = {
+            // 工作流编排
+            'start_feature': '新功能',
+            'start_bugfix': '修Bug',
+            'start_review': '代码审查',
+            'start_release': '发版本',
+            'start_refactor': '重构',
+            'start_onboard': '快速上手',
+            'start_api': 'API开发',
+            'start_doc': '写文档',
+            'start_ui': 'UI开发',
+            'start_ralph': '循环开发',
+            
+            // 代码分析
+            'code_review': '审查代码',
+            'security_scan': '安全扫描',
+            'debug': '调试',
+            'perf': '性能优化',
+            'refactor': '重构建议',
+            'fix_bug': '修复Bug',
+            'estimate': '工作量',
+            
+            // Git 工具
+            'gencommit': '生成提交',
+            'genchangelog': '生成日志',
+            'genpr': '生成PR',
+            'resolve_conflict': '解决冲突',
+            
+            // 生成工具
+            'genapi': 'API文档',
+            'gendoc': '生成注释',
+            'gentest': '生成测试',
+            'gensql': '生成SQL',
+            'genreadme': '生成说明',
+            'gen_mock': '生成数据',
+            'genui': '生成UI',
+            
+            // 项目管理
+            'init_project': '初始化',
+            'analyze_project': '分析项目',
+            'init_project_context': '项目上下文',
+            'add_feature': '添加功能',
+            'check_deps': '检查依赖',
+            'interview': '需求访谈',
+            'ask_user': '提问用户',
+            
+            // UI/UX 工具
+            'ui_design_system': '设计系统',
+            'ui_search': '搜索UI',
+            'sync_ui_data': '同步数据',
+            'init_component_catalog': '组件目录',
+            'render_ui': '渲染UI',
+            'design2code': '设计转码',
+            
+            // 其他工具
+            'fix': '修复',
+            'split': '拆分',
+            'convert': '转换',
+            'explain': '解释',
+            'css_order': 'CSS排序',
+            'detect_shell': '检测Shell',
+            'init_setting': '初始设置',
+            'gen_skill': '生成技能'
+        };
+        
         // 生成侧边栏工具列表
         function generateSidebarTools() {
             const submenu = document.getElementById('tools-submenu');
@@ -488,9 +554,12 @@
                 
                 tools.forEach(tool => {
                     const toolId = tool.name.replace(/_/g, '-');
+                    const desc = toolDescriptions[tool.name] || '';
+                    const displayText = desc ? `${tool.name} (${desc})` : tool.name;
+                    
                     html += `
-                        <a href="#${toolId}" class="nav-subitem" onclick="scrollToTool('${toolId}')">
-                            ${tool.name}
+                        <a href="javascript:void(0)" class="nav-subitem" onclick="scrollToTool('${toolId}', event)" title="${tool.description}">
+                            ${displayText}
                         </a>
                     `;
                 });
@@ -500,10 +569,34 @@
         }
         
         // 滚动到指定工具
-        function scrollToTool(toolId) {
+        function scrollToTool(toolId, event) {
+            // 阻止默认行为
+            if (event) {
+                event.preventDefault();
+            }
+            
+            // 移除所有选中状态
+            document.querySelectorAll('.nav-subitem').forEach(item => {
+                item.classList.remove('active');
+            });
+            
+            // 添加当前选中状态
+            if (event && event.currentTarget) {
+                event.currentTarget.classList.add('active');
+            }
+            
             const element = document.getElementById(toolId);
             if (element) {
-                element.scrollIntoView({ behavior: 'smooth', block: 'start' });
+                // 计算滚动位置，留出 header 高度 (60px) + 间距 (40px)
+                const headerHeight = 100;
+                const elementPosition = element.getBoundingClientRect().top + window.pageYOffset;
+                const offsetPosition = elementPosition - headerHeight;
+                
+                window.scrollTo({
+                    top: offsetPosition,
+                    behavior: 'smooth'
+                });
+                
                 // 高亮显示
                 element.style.transition = 'background 0.3s';
                 element.style.background = 'rgba(37, 99, 235, 0.05)';

package/docs/styles/page.css

@@ -126,7 +126,7 @@ body {
 
 /* ========== Sidebar ========== */
 .sidebar {
-    width: 260px;
+    width: 300px;
     background: var(--bg-card);
     border-right: 1px solid var(--border);
     position: fixed;
@@ -246,14 +246,18 @@ body {
 
 .nav-subitem {
     display: block;
-    padding: 8px 20px 8px 48px;
-    margin: 2px 12px;
+    padding: 8px 16px 8px 40px;
+    margin: 2px 8px;
     color: var(--text-secondary);
     text-decoration: none;
     transition: all 0.2s;
     border-radius: 6px;
-    font-size: 13px;
+    font-size: 12px;
     position: relative;
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    font-family: 'Courier New', monospace;
 }
 
 .nav-subitem:hover {
@@ -350,7 +354,7 @@ body {
 /* ========== Main Content ========== */
 .main-content {
     flex: 1;
-    margin-left: 260px;
+    margin-left: 300px;
     display: flex;
     flex-direction: column;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-probe-kit",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "AI-Powered Development Toolkit - MCP Server with 39 practical tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, UI/UX Pro Max, and Requirements Interview.",
   "type": "module",
   "main": "build/index.js",