npm - mcp-probe-kit - Versions diffs - 3.0.5 → 3.0.7 - Mend

mcp-probe-kit 3.0.5 → 3.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (69) hide show

package/README.md +458 -431
package/build/index.js +875 -141
package/build/lib/gitnexus-bridge.d.ts +58 -0
package/build/lib/gitnexus-bridge.js +379 -0
package/build/lib/template-loader.js +317 -317
package/build/lib/tool-execution-context.d.ts +8 -0
package/build/lib/tool-execution-context.js +20 -0
package/build/lib/toolset-manager.d.ts +1 -1
package/build/lib/toolset-manager.js +7 -5
package/build/schemas/code-analysis-tools.d.ts +46 -0
package/build/schemas/code-analysis-tools.js +47 -0
package/build/schemas/git-tools.js +16 -16
package/build/schemas/index.d.ts +46 -0
package/build/tools/__tests__/code_insight.unit.test.d.ts +1 -0
package/build/tools/__tests__/code_insight.unit.test.js +35 -0
package/build/tools/__tests__/start_bugfix.unit.test.js +14 -14
package/build/tools/__tests__/start_ui.unit.test.js +11 -11
package/build/tools/add_feature.js +79 -79
package/build/tools/ask_user.js +5 -5
package/build/tools/code_insight.d.ts +8 -0
package/build/tools/code_insight.js +129 -0
package/build/tools/index.d.ts +1 -0
package/build/tools/index.js +1 -0
package/build/tools/interview.js +9 -9
package/build/tools/start_bugfix.d.ts +2 -1
package/build/tools/start_bugfix.js +170 -126
package/build/tools/start_feature.d.ts +2 -1
package/build/tools/start_feature.js +156 -112
package/build/tools/start_onboard.d.ts +2 -1
package/build/tools/start_onboard.js +57 -51
package/build/tools/start_product.d.ts +2 -1
package/build/tools/start_product.js +9 -1
package/build/tools/start_ralph.d.ts +2 -1
package/build/tools/start_ralph.js +9 -3
package/build/tools/start_ui.d.ts +2 -1
package/build/tools/start_ui.js +102 -88
package/build/tools/ui-ux-tools.d.ts +2 -1
package/build/tools/ui-ux-tools.js +19 -3
package/build/utils/ui-sync.d.ts +6 -2
package/build/utils/ui-sync.js +125 -29
package/docs/assets/font/MaterialSymbolsOutlined.codepoints +4102 -0
package/docs/assets/font/MaterialSymbolsOutlined.ttf +0 -0
package/docs/assets/font/noto-sans-sc-400.ttf +0 -0
package/docs/assets/font/noto-sans-sc-700.ttf +0 -0
package/docs/assets/font/noto-sans-sc-900.ttf +0 -0
package/docs/assets/js/i18n.js +122 -21
package/docs/assets/js/tailwind.js +83 -83
package/docs/data/tools.js +419 -399
package/docs/debug-i18n.html +163 -0
package/docs/i18n/all-tools/en.json +157 -0
package/docs/i18n/all-tools/ja.json +157 -0
package/docs/i18n/all-tools/ko.json +157 -0
package/docs/i18n/all-tools/zh-CN.json +157 -0
package/docs/pages/all-tools.html +514 -352
package/docs/pages/examples.html +689 -689
package/docs/pages/getting-started.html +589 -589
package/docs/pages/migration.html +298 -298
package/docs/specs/user-auth/design.md +82 -0
package/docs/specs/user-auth/requirements.md +52 -0
package/docs/specs/user-auth/tasks.md +55 -0
package/package.json +5 -5
package/docs/project-context/architecture.md +0 -0
package/docs/project-context/how-to-develop.md +0 -313
package/docs/project-context/how-to-test.md +0 -457
package/docs/project-context/tech-stack.md +0 -96
package/docs/project-context.md +0 -53
package/docs/specs/git-work-report/design.md +0 -568
package/docs/specs/git-work-report/requirements.md +0 -131
package/docs/specs/git-work-report/tasks.md +0 -197

package/docs/pages/migration.html CHANGED Viewed

@@ -1,299 +1,299 @@
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>迁移指南 - 从 v2.x 升级到 v3.0 | MCP Probe Kit</title>
-    <meta name="description" content="MCP Probe Kit 迁移指南：从 v2.x 升级到 v3.0 的完整步骤。了解重大变更、新增功能、配置调整和最佳实践，确保平滑升级。">
-    <meta name="keywords" content="MCP Probe Kit 升级, 版本迁移, v3.0 新特性, 配置迁移, 工具升级指南, 破坏性变更">
-    <meta name="author" content="小墨 (Kyle) - ByteZoneX">
-    <meta name="robots" content="index, follow">
-    <script src="../assets/js/tailwind.js" data-cfasync="false"></script>
-    <script>
-        tailwind.config = {
-            theme: {
-                extend: {
-                    colors: {
-                        primary: { DEFAULT: '#2563EB', hover: '#1D4ED8' },
-                        text: { primary: '#0F172A', secondary: '#475569', tertiary: '#64748B' },
-                        bg: { page: '#F8FAFC', card: '#FFFFFF', hover: '#F1F5F9' },
-                        border: '#E2E8F0',
-                    },
-                    fontFamily: {
-                        sans: ['-apple-system', 'BlinkMacSystemFont', '"PingFang SC"', '"Microsoft YaHei"', '"Segoe UI"', 'Roboto', '"Helvetica Neue"', 'Arial', '"Noto Sans CJK SC"', 'sans-serif'],
-                        mono: ['ui-monospace', '"SF Mono"', '"Cascadia Code"', '"Consolas"', 'Menlo', 'Monaco', '"PingFang SC"', '"Microsoft YaHei"', '"Courier New"', 'monospace']
-                    },
-                }
-            }
-        }
-    </script>
-    <style>
-        html { scroll-behavior: smooth; }
-        .code-block { overflow-x: auto; -webkit-overflow-scrolling: touch; }
-        .sidebar-drawer { transition: transform 0.3s ease; }
-        @media (max-width: 767px) {
-            .sidebar-drawer { transform: translateX(-100%); }
-            .sidebar-drawer.open { transform: translateX(0); }
-        }
-        .backdrop { opacity: 0; pointer-events: none; transition: opacity 0.3s ease; }
-        .backdrop.active { opacity: 1; pointer-events: auto; }
-        /* i18n 加载优化：防止内容闪烁 */
-        body:not(.i18n-ready) [data-i18n] {
-            visibility: hidden;
-        }
-        body.i18n-ready [data-i18n] {
-            visibility: visible;
-        }
-    </style>
-</head>
-<body class="font-sans bg-bg-page text-text-primary leading-relaxed min-h-screen flex flex-col">
-    <!-- A. 顶部导航栏 -->
-    <nav class="fixed top-0 left-0 right-0 h-14 bg-white/95 backdrop-blur-md border-b border-border z-50">
-        <div class="h-full px-4 flex items-center justify-between">
-            <a href="../index.html" class="flex items-center gap-2 text-base font-semibold text-text-primary no-underline">
-                <span>🚀</span>
-                <span class="sm:inline hidden">MCP Probe Kit</span>
-            </a>
-            <div class="flex items-center gap-3">
-                <div id="lang-switcher-container"></div>
-                <button onclick="toggleSidebar()" class="md:hidden p-2 text-text-secondary hover:text-primary transition-colors">
-                    <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16"/>
-                    </svg>
-                </button>
-            </div>
-        </div>
-    </nav>
-    <!-- 侧边栏遮罩 -->
-    <div class="fixed inset-0 bg-black/50 z-40 backdrop opacity-0 pointer-events-none transition-opacity duration-300 md:hidden" onclick="toggleSidebar()" id="backdrop"></div>
-    <!-- B. 侧边栏 -->
-    <aside class="fixed left-0 top-14 bottom-0 w-64 bg-white border-r border-border z-50 sidebar-drawer overflow-y-auto md:translate-x-0 md:block" id="sidebar">
-        <div class="p-4">
-            <div class="mb-4">
-                <div class="text-xs font-semibold text-text-tertiary uppercase tracking-wider mb-2 px-2" data-i18n="sidebar.quickStart">快速开始</div>
-                <a href="../index.html" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
-                    <span>🏠</span>
-                    <span data-i18n="sidebar.home">文档首页</span>
-                </a>
-                <a href="./getting-started.html" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
-                    <span>📖</span>
-                    <span data-i18n="sidebar.installation">安装配置</span>
-                </a>
-            </div>
-            <div class="mb-4">
-                <div class="text-xs font-semibold text-text-tertiary uppercase tracking-wider mb-2 px-2" data-i18n="sidebar.toolsDocs">工具文档</div>
-                <a href="./all-tools.html" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
-                    <span>🛠️</span>
-                    <span data-i18n="sidebar.allTools">所有工具</span>
-                    <span class="ml-auto bg-bg-page text-xs px-2 py-0.5 rounded-full">21</span>
-                </a>
-            </div>
-            <div class="mb-4">
-                <div class="text-xs font-semibold text-text-tertiary uppercase tracking-wider mb-2 px-2" data-i18n="sidebar.guides">指南</div>
-                <a href="./migration.html" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm font-medium bg-blue-50 text-primary no-underline border-l-3 border-primary">
-                    <span>🚀</span>
-                    <span data-i18n="sidebar.migration">迁移指南</span>
-                </a>
-                <a href="./examples.html" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
-                    <span>💡</span>
-                    <span data-i18n="sidebar.examples">最佳实践</span>
-                </a>
-            </div>
-            <div class="pt-4 border-t border-border">
-                <a href="https://github.com/mybolide/mcp-probe-kit" target="_blank" rel="noopener" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
-                    <span>💻</span>
-                    <span>GitHub</span>
-                    <span class="ml-auto text-xs">↗</span>
-                </a>
-                <a href="https://npmjs.com/package/mcp-probe-kit" target="_blank" rel="noopener" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
-                    <span>📦</span>
-                    <span>npm</span>
-                    <span class="ml-auto text-xs">↗</span>
-                </a>
-            </div>
-            <!-- QR Code -->
-            <div class="mt-4 pt-4 border-t border-border">
-                <div class="text-center">
-                    <div class="text-xs font-semibold text-text-tertiary mb-2" data-i18n="sidebar.followUs">关注公众号</div>
-                    <img src="https://oss.bolzjb.com/wx_qrcode.jpg" alt="微信公众号" class="w-[100px] h-[100px] mx-auto rounded-lg border border-border" />
-                    <div class="text-xs text-text-tertiary mt-2" data-i18n="sidebar.getTechSharing">获取更多技术分享</div>
-                </div>
-            </div>
-        </div>
-    </aside>
-    <!-- C. 主内容区 -->
-    <main class="flex-1 mt-14 min-h-screen md:ml-64">
-        <div class="max-w-4xl mx-auto p-4 sm:p-6 lg:p-8">
-            <!-- 面包屑 -->
-            <nav class="flex items-center gap-1 text-sm text-text-secondary mb-4 overflow-x-auto whitespace-nowrap">
-                <a href="../index.html" class="hover:text-primary transition-colors no-underline flex-shrink-0" data-i18n="migration.breadcrumb.home">文档首页</a>
-                <span class="text-text-tertiary">/</span>
-                <span class="text-text-primary flex-shrink-0" data-i18n="migration.breadcrumb.guides">指南</span>
-                <span class="text-text-tertiary">/</span>
-                <span class="text-text-primary flex-shrink-0" data-i18n="migration.breadcrumb.migration">迁移指南</span>
-            </nav>
-            <!-- 页面标题 -->
-            <div class="mb-6">
-                <h1 class="text-2xl sm:text-3xl font-bold text-text-primary mb-2" data-i18n="migration.title">v3.0 迁移指南</h1>
-                <p class="text-sm sm:text-base text-text-secondary" data-i18n="migration.subtitle">从 v2.x 平滑迁移到 v3.0，了解重大变更和新特性</p>
-                <div class="flex flex-wrap items-center gap-2 mt-3 text-xs text-text-tertiary">
-                    <span class="bg-blue-100 text-blue-700 px-2 py-0.5 rounded">v3.0.5</span>
-                    <span>MCP 2025-11-25</span>
-                    <span>SDK 1.25.3</span>
-                </div>
-            </div>
-            <!-- 概述 -->
-            <section class="bg-white rounded-xl border border-border p-4 sm:p-6 mb-6 shadow-sm">
-                <h2 class="text-lg sm:text-xl font-semibold text-text-primary mb-4" data-i18n="migration.overview.title">概述</h2>
-                <p class="text-text-secondary mb-4 text-sm" data-i18n="migration.overview.description">MCP Probe Kit v3.0 是一个重大版本更新，精简优化到 20 个核心工具，带来了更强大的功能和更好的开发体验。</p>
-                <div class="p-3 bg-blue-50 border-l-3 border-blue-500 rounded-r text-sm">
-                    <strong>💡 <span data-i18n="migration.overview.migrationTime">迁移时间：</span></strong><span data-i18n="migration.overview.migrationTimeText">大多数项目可以在 10-15 分钟内完成迁移，v2.x 的核心工具在 v3.0 中都保持兼容。</span>
-                </div>
-            </section>
-            <!-- 主要变更 -->
-            <section class="bg-white rounded-xl border border-border p-4 sm:p-6 mb-6 shadow-sm">
-                <h2 class="text-lg sm:text-xl font-semibold text-text-primary mb-4" data-i18n="migration.changes.title">主要变更</h2>
-                <div class="mb-4">
-                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
-                        <span>🛠️</span>
-                        <span data-i18n="migration.changes.toolsOptimization.title">1. 工具精简优化</span>
-                    </h3>
-                    <p class="text-text-secondary text-sm pl-7" data-i18n="migration.changes.toolsOptimization.description">v2.x: 39 个工具 → v3.0: 20 个核心工具（移除低频工具，保留高价值工具）</p>
-                </div>
-                <div class="mb-4">
-                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
-                        <span>🔄</span>
-                        <span data-i18n="migration.changes.workflows.title">2. 新增工作流编排</span>
-                    </h3>
-                    <p class="text-text-secondary text-sm pl-7 mb-2"><span data-i18n="migration.changes.workflows.description">11 个</span> <code class="bg-gray-200 px-1 rounded text-xs">start_*</code> <span data-i18n="migration.changes.workflows.description2">工作流编排工具，提供端到端的自动化开发流程：</span></p>
-                    <ul class="list-disc list-inside space-y-1 text-sm text-text-primary pl-7">
-                        <li><code class="bg-gray-200 px-1 rounded text-xs">start_feature</code> - <span data-i18n="migration.changes.workflows.startFeature">功能开发工作流</span></li>
-                        <li><code class="bg-gray-200 px-1 rounded text-xs">start_bugfix</code> - <span data-i18n="migration.changes.workflows.startBugfix">Bug 修复工作流</span></li>
-                        <li><code class="bg-gray-200 px-1 rounded text-xs">start_ui</code> - <span data-i18n="migration.changes.workflows.startUi">UI 开发工作流</span></li>
-                        <li><code class="bg-gray-200 px-1 rounded text-xs">start_product</code> - <span data-i18n="migration.changes.workflows.startProduct">产品设计工作流</span></li>
-                        <li><code class="bg-gray-200 px-1 rounded text-xs">start_ralph</code> - <span data-i18n="migration.changes.workflows.startRalph">Ralph Loop 自动化开发</span></li>
-                    </ul>
-                </div>
-                <div class="mb-4">
-                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
-                        <span>🎨</span>
-                        <span data-i18n="migration.changes.uiTools.title">3. 新增 UI/UX 工具集</span>
-                    </h3>
-                    <p class="text-text-secondary text-sm pl-7 mb-2" data-i18n="migration.changes.uiTools.description">完整的 UI/UX 工具链：</p>
-                    <ul class="list-disc list-inside space-y-1 text-sm text-text-primary pl-7">
-                        <li><code class="bg-gray-200 px-1 rounded text-xs">ui_design_system</code> - <span data-i18n="migration.changes.uiTools.designSystem">智能设计系统生成器</span></li>
-                        <li><code class="bg-gray-200 px-1 rounded text-xs">ui_search</code> - <span data-i18n="migration.changes.uiTools.uiSearch">UI/UX 数据库搜索</span></li>
-                        <li><code class="bg-gray-200 px-1 rounded text-xs">sync_ui_data</code> - <span data-i18n="migration.changes.uiTools.syncUiData">UI/UX 数据同步</span></li>
-                        <li><code class="bg-gray-200 px-1 rounded text-xs">init_component_catalog</code> - <span data-i18n="migration.changes.uiTools.componentCatalog">组件目录初始化</span></li>
-                        <li><code class="bg-gray-200 px-1 rounded text-xs">render_ui</code> - <span data-i18n="migration.changes.uiTools.renderUi">UI 渲染引擎</span></li>
-                    </ul>
-                </div>
-                <div>
-                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
-                        <span>📊</span>
-                        <span data-i18n="migration.changes.structuredOutput.title">4. 结构化输出升级</span>
-                    </h3>
-                    <p class="text-text-secondary text-sm pl-7" data-i18n="migration.changes.structuredOutput.description">核心与编排工具优先支持结构化输出，输出格式一致、可预测，便于工具串联与状态追踪。</p>
-                </div>
-            </section>
-            <!-- 迁移步骤 -->
-            <section class="bg-white rounded-xl border border-border p-4 sm:p-6 mb-6 shadow-sm">
-                <h2 class="text-lg sm:text-xl font-semibold text-text-primary mb-4" data-i18n="migration.steps.title">迁移步骤</h2>
-                <div class="mb-4">
-                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
-                        <span>📦</span>
-                        <span data-i18n="migration.steps.step1.title">步骤 1：更新版本</span>
-                    </h3>
-                    <div class="bg-slate-900 rounded-lg overflow-hidden ml-7">
-                        <div class="flex items-center justify-between px-3 py-2 bg-slate-800">
-                            <span class="text-xs text-slate-300 font-medium">Bash</span>
-                        </div>
-                        <pre class="code-block p-4 text-sm text-slate-200 overflow-x-auto"><code><span data-i18n="migration.steps.step1.npxNote"># 如果使用 npx（推荐）</span>
-<span data-i18n="migration.steps.step1.npxDesc"># 无需操作，自动使用最新版本</span>
-<span data-i18n="migration.steps.step1.globalNote"># 如果全局安装</span>
-npm update -g mcp-probe-kit</code></pre>
-                    </div>
-                </div>
-                <div>
-                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
-                        <span>📝</span>
-                        <span data-i18n="migration.steps.step2.title">步骤 2：检查配置文件</span>
-                    </h3>
-                    <p class="text-text-secondary text-sm ml-7 mb-3" data-i18n="migration.steps.step2.description">v3.0 的配置文件格式与 v2.x 完全兼容，无需修改。</p>
-                    <div class="ml-7 p-3 bg-green-50 border-l-3 border-green-500 rounded-r text-sm">
-                        <strong>✅ <span data-i18n="migration.steps.step2.compatible">向后兼容：</span></strong><span data-i18n="migration.steps.step2.compatibleText">v2.x 的核心工具在 v3.0 中都保持兼容，可以无缝升级。</span>
-                    </div>
-                </div>
-            </section>
-            <!-- 获取帮助 -->
-            <section class="bg-white rounded-xl border border-border p-4 sm:p-6 mb-6 shadow-sm">
-                <h2 class="text-lg sm:text-xl font-semibold text-text-primary mb-4" data-i18n="migration.help.title">获取帮助</h2>
-                <p class="text-text-secondary text-sm mb-4" data-i18n="migration.help.description">如果在迁移过程中遇到问题：</p>
-                <ul class="list-disc list-inside space-y-2 text-sm text-text-primary">
-                    <li>📖 <span data-i18n="migration.help.viewDocs">查看</span> <a href="./all-tools.html" class="text-primary hover:underline" data-i18n="migration.help.toolsReference">完整工具参考</a></li>
-                    <li>💬 <span data-i18n="migration.help.askIn">在</span> <a href="https://github.com/mybolide/mcp-probe-kit/discussions" target="_blank" rel="noopener" class="text-primary hover:underline">GitHub Discussions</a> <span data-i18n="migration.help.askQuestion">提问</span></li>
-                    <li>🐛 <span data-i18n="migration.help.reportIn">在</span> <a href="https://github.com/mybolide/mcp-probe-kit/issues" target="_blank" rel="noopener" class="text-primary hover:underline">GitHub Issues</a> <span data-i18n="migration.help.reportBug">报告 Bug</span></li>
-                </ul>
-            </section>
-            <!-- 迁移完成 -->
-            <section class="bg-gradient-to-br from-primary to-primary-hover text-white rounded-xl p-4 sm:p-6 mb-6 shadow-sm">
-                <h2 class="text-lg sm:text-xl font-semibold mb-3" data-i18n="migration.complete.title">🎉 迁移完成！</h2>
-                <p class="text-sm opacity-95 mb-4" data-i18n="migration.complete.description">开始探索 v3.0 的强大功能</p>
-                <div class="flex flex-col sm:flex-row gap-3">
-                    <a href="./all-tools.html" class="bg-white/20 text-white px-4 py-2.5 rounded-md text-sm font-medium text-center hover:bg-white/30 transition-colors no-underline">
-                        🛠️ <span data-i18n="migration.complete.viewTools">查看所有工具</span>
-                    </a>
-                    <a href="./examples.html" class="bg-white/20 text-white px-4 py-2.5 rounded-md text-sm font-medium text-center hover:bg-white/30 transition-colors no-underline">
-                        💡 <span data-i18n="migration.complete.learnBestPractices">学习最佳实践</span>
-                    </a>
-                </div>
-            </section>
-            <!-- Footer -->
-            <footer class="text-center text-sm text-text-tertiary py-4 border-t border-border">
-                <p><span data-i18n="footer.madeWith">Made with ❤️ by</span> <a href="https://www.bytezonex.com/" target="_blank" rel="noopener" class="text-primary hover:underline">小墨 (Kyle)</a></p>
-                <p class="mt-1">© 2024-2026 MCP Probe Kit · <a href="https://github.com/mybolide/mcp-probe-kit" target="_blank" rel="noopener" class="text-primary hover:underline">GitHub ↗</a></p>
-            </footer>
-        </div>
-    </main>
-    <script>
-        function toggleSidebar() {
-            const sidebar = document.getElementById('sidebar');
-            const backdrop = document.getElementById('backdrop');
-            const isOpen = sidebar.classList.contains('open');
-            if (isOpen) {
-                sidebar.classList.remove('open');
-                backdrop.classList.remove('active');
-            } else {
-                sidebar.classList.add('open');
-                backdrop.classList.add('active');
-            }
-        }
-    </script>
-    <script src="../assets/js/i18n.js"></script>
-</body>
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>迁移指南 - 从 v2.x 升级到 v3.0 | MCP Probe Kit</title>
+    <meta name="description" content="MCP Probe Kit 迁移指南：从 v2.x 升级到 v3.0 的完整步骤。了解重大变更、新增功能、配置调整和最佳实践，确保平滑升级。">
+    <meta name="keywords" content="MCP Probe Kit 升级, 版本迁移, v3.0 新特性, 配置迁移, 工具升级指南, 破坏性变更">
+    <meta name="author" content="小墨 (Kyle) - ByteZoneX">
+    <meta name="robots" content="index, follow">
+    <script src="../assets/js/tailwind.js" data-cfasync="false"></script>
+    <script>
+        tailwind.config = {
+            theme: {
+                extend: {
+                    colors: {
+                        primary: { DEFAULT: '#2563EB', hover: '#1D4ED8' },
+                        text: { primary: '#0F172A', secondary: '#475569', tertiary: '#64748B' },
+                        bg: { page: '#F8FAFC', card: '#FFFFFF', hover: '#F1F5F9' },
+                        border: '#E2E8F0',
+                    },
+                    fontFamily: {
+                        sans: ['-apple-system', 'BlinkMacSystemFont', '"PingFang SC"', '"Microsoft YaHei"', '"Segoe UI"', 'Roboto', '"Helvetica Neue"', 'Arial', '"Noto Sans CJK SC"', 'sans-serif'],
+                        mono: ['ui-monospace', '"SF Mono"', '"Cascadia Code"', '"Consolas"', 'Menlo', 'Monaco', '"PingFang SC"', '"Microsoft YaHei"', '"Courier New"', 'monospace']
+                    },
+                }
+            }
+        }
+    </script>
+    <style>
+        html { scroll-behavior: smooth; }
+        .code-block { overflow-x: auto; -webkit-overflow-scrolling: touch; }
+        .sidebar-drawer { transition: transform 0.3s ease; }
+        @media (max-width: 767px) {
+            .sidebar-drawer { transform: translateX(-100%); }
+            .sidebar-drawer.open { transform: translateX(0); }
+        }
+        .backdrop { opacity: 0; pointer-events: none; transition: opacity 0.3s ease; }
+        .backdrop.active { opacity: 1; pointer-events: auto; }
+        /* i18n 加载优化：防止内容闪烁 */
+        body:not(.i18n-ready) [data-i18n] {
+            visibility: hidden;
+        }
+        body.i18n-ready [data-i18n] {
+            visibility: visible;
+        }
+    </style>
+</head>
+<body class="font-sans bg-bg-page text-text-primary leading-relaxed min-h-screen flex flex-col">
+    <!-- A. 顶部导航栏 -->
+    <nav class="fixed top-0 left-0 right-0 h-14 bg-white/95 backdrop-blur-md border-b border-border z-50">
+        <div class="h-full px-4 flex items-center justify-between">
+            <a href="../index.html" class="flex items-center gap-2 text-base font-semibold text-text-primary no-underline">
+                <span>🚀</span>
+                <span class="sm:inline hidden">MCP Probe Kit</span>
+            </a>
+            <div class="flex items-center gap-3">
+                <div id="lang-switcher-container"></div>
+                <button onclick="toggleSidebar()" class="md:hidden p-2 text-text-secondary hover:text-primary transition-colors">
+                    <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 12h16M4 18h16"/>
+                    </svg>
+                </button>
+            </div>
+        </div>
+    </nav>
+    <!-- 侧边栏遮罩 -->
+    <div class="fixed inset-0 bg-black/50 z-40 backdrop opacity-0 pointer-events-none transition-opacity duration-300 md:hidden" onclick="toggleSidebar()" id="backdrop"></div>
+    <!-- B. 侧边栏 -->
+    <aside class="fixed left-0 top-14 bottom-0 w-64 bg-white border-r border-border z-50 sidebar-drawer overflow-y-auto md:translate-x-0 md:block" id="sidebar">
+        <div class="p-4">
+            <div class="mb-4">
+                <div class="text-xs font-semibold text-text-tertiary uppercase tracking-wider mb-2 px-2" data-i18n="sidebar.quickStart">快速开始</div>
+                <a href="../index.html" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
+                    <span>🏠</span>
+                    <span data-i18n="sidebar.home">文档首页</span>
+                </a>
+                <a href="./getting-started.html" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
+                    <span>📖</span>
+                    <span data-i18n="sidebar.installation">安装配置</span>
+                </a>
+            </div>
+            <div class="mb-4">
+                <div class="text-xs font-semibold text-text-tertiary uppercase tracking-wider mb-2 px-2" data-i18n="sidebar.toolsDocs">工具文档</div>
+                <a href="./all-tools.html" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
+                    <span>🛠️</span>
+                    <span data-i18n="sidebar.allTools">所有工具</span>
+                    <span class="ml-auto bg-bg-page text-xs px-2 py-0.5 rounded-full">21</span>
+                </a>
+            </div>
+            <div class="mb-4">
+                <div class="text-xs font-semibold text-text-tertiary uppercase tracking-wider mb-2 px-2" data-i18n="sidebar.guides">指南</div>
+                <a href="./migration.html" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm font-medium bg-blue-50 text-primary no-underline border-l-3 border-primary">
+                    <span>🚀</span>
+                    <span data-i18n="sidebar.migration">迁移指南</span>
+                </a>
+                <a href="./examples.html" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
+                    <span>💡</span>
+                    <span data-i18n="sidebar.examples">最佳实践</span>
+                </a>
+            </div>
+            <div class="pt-4 border-t border-border">
+                <a href="https://github.com/mybolide/mcp-probe-kit" target="_blank" rel="noopener" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
+                    <span>💻</span>
+                    <span>GitHub</span>
+                    <span class="ml-auto text-xs">↗</span>
+                </a>
+                <a href="https://npmjs.com/package/mcp-probe-kit" target="_blank" rel="noopener" class="flex items-center gap-2 px-3 py-2 rounded-md text-sm text-text-secondary hover:bg-bg-page hover:text-primary transition-colors no-underline">
+                    <span>📦</span>
+                    <span>npm</span>
+                    <span class="ml-auto text-xs">↗</span>
+                </a>
+            </div>
+            <!-- QR Code -->
+            <div class="mt-4 pt-4 border-t border-border">
+                <div class="text-center">
+                    <div class="text-xs font-semibold text-text-tertiary mb-2" data-i18n="sidebar.followUs">关注公众号</div>
+                    <img src="https://oss.bolzjb.com/wx_qrcode.jpg" alt="微信公众号" class="w-[100px] h-[100px] mx-auto rounded-lg border border-border" />
+                    <div class="text-xs text-text-tertiary mt-2" data-i18n="sidebar.getTechSharing">获取更多技术分享</div>
+                </div>
+            </div>
+        </div>
+    </aside>
+    <!-- C. 主内容区 -->
+    <main class="flex-1 mt-14 min-h-screen md:ml-64">
+        <div class="max-w-4xl mx-auto p-4 sm:p-6 lg:p-8">
+            <!-- 面包屑 -->
+            <nav class="flex items-center gap-1 text-sm text-text-secondary mb-4 overflow-x-auto whitespace-nowrap">
+                <a href="../index.html" class="hover:text-primary transition-colors no-underline flex-shrink-0" data-i18n="migration.breadcrumb.home">文档首页</a>
+                <span class="text-text-tertiary">/</span>
+                <span class="text-text-primary flex-shrink-0" data-i18n="migration.breadcrumb.guides">指南</span>
+                <span class="text-text-tertiary">/</span>
+                <span class="text-text-primary flex-shrink-0" data-i18n="migration.breadcrumb.migration">迁移指南</span>
+            </nav>
+            <!-- 页面标题 -->
+            <div class="mb-6">
+                <h1 class="text-2xl sm:text-3xl font-bold text-text-primary mb-2" data-i18n="migration.title">v3.0 迁移指南</h1>
+                <p class="text-sm sm:text-base text-text-secondary" data-i18n="migration.subtitle">从 v2.x 平滑迁移到 v3.0，了解重大变更和新特性</p>
+                <div class="flex flex-wrap items-center gap-2 mt-3 text-xs text-text-tertiary">
+                    <span class="bg-blue-100 text-blue-700 px-2 py-0.5 rounded">v3.0.5</span>
+                    <span>MCP 2025-11-25</span>
+                    <span>SDK 1.27.1</span>
+                </div>
+            </div>
+            <!-- 概述 -->
+            <section class="bg-white rounded-xl border border-border p-4 sm:p-6 mb-6 shadow-sm">
+                <h2 class="text-lg sm:text-xl font-semibold text-text-primary mb-4" data-i18n="migration.overview.title">概述</h2>
+                <p class="text-text-secondary mb-4 text-sm" data-i18n="migration.overview.description">MCP Probe Kit v3.0 是一个重大版本更新，精简优化到 20 个核心工具，带来了更强大的功能和更好的开发体验。</p>
+                <div class="p-3 bg-blue-50 border-l-3 border-blue-500 rounded-r text-sm">
+                    <strong>💡 <span data-i18n="migration.overview.migrationTime">迁移时间：</span></strong><span data-i18n="migration.overview.migrationTimeText">大多数项目可以在 10-15 分钟内完成迁移，v2.x 的核心工具在 v3.0 中都保持兼容。</span>
+                </div>
+            </section>
+            <!-- 主要变更 -->
+            <section class="bg-white rounded-xl border border-border p-4 sm:p-6 mb-6 shadow-sm">
+                <h2 class="text-lg sm:text-xl font-semibold text-text-primary mb-4" data-i18n="migration.changes.title">主要变更</h2>
+                <div class="mb-4">
+                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
+                        <span>🛠️</span>
+                        <span data-i18n="migration.changes.toolsOptimization.title">1. 工具精简优化</span>
+                    </h3>
+                    <p class="text-text-secondary text-sm pl-7" data-i18n="migration.changes.toolsOptimization.description">v2.x: 39 个工具 → v3.0: 20 个核心工具（移除低频工具，保留高价值工具）</p>
+                </div>
+                <div class="mb-4">
+                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
+                        <span>🔄</span>
+                        <span data-i18n="migration.changes.workflows.title">2. 新增工作流编排</span>
+                    </h3>
+                    <p class="text-text-secondary text-sm pl-7 mb-2"><span data-i18n="migration.changes.workflows.description">11 个</span> <code class="bg-gray-200 px-1 rounded text-xs">start_*</code> <span data-i18n="migration.changes.workflows.description2">工作流编排工具，提供端到端的自动化开发流程：</span></p>
+                    <ul class="list-disc list-inside space-y-1 text-sm text-text-primary pl-7">
+                        <li><code class="bg-gray-200 px-1 rounded text-xs">start_feature</code> - <span data-i18n="migration.changes.workflows.startFeature">功能开发工作流</span></li>
+                        <li><code class="bg-gray-200 px-1 rounded text-xs">start_bugfix</code> - <span data-i18n="migration.changes.workflows.startBugfix">Bug 修复工作流</span></li>
+                        <li><code class="bg-gray-200 px-1 rounded text-xs">start_ui</code> - <span data-i18n="migration.changes.workflows.startUi">UI 开发工作流</span></li>
+                        <li><code class="bg-gray-200 px-1 rounded text-xs">start_product</code> - <span data-i18n="migration.changes.workflows.startProduct">产品设计工作流</span></li>
+                        <li><code class="bg-gray-200 px-1 rounded text-xs">start_ralph</code> - <span data-i18n="migration.changes.workflows.startRalph">Ralph Loop 自动化开发</span></li>
+                    </ul>
+                </div>
+                <div class="mb-4">
+                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
+                        <span>🎨</span>
+                        <span data-i18n="migration.changes.uiTools.title">3. 新增 UI/UX 工具集</span>
+                    </h3>
+                    <p class="text-text-secondary text-sm pl-7 mb-2" data-i18n="migration.changes.uiTools.description">完整的 UI/UX 工具链：</p>
+                    <ul class="list-disc list-inside space-y-1 text-sm text-text-primary pl-7">
+                        <li><code class="bg-gray-200 px-1 rounded text-xs">ui_design_system</code> - <span data-i18n="migration.changes.uiTools.designSystem">智能设计系统生成器</span></li>
+                        <li><code class="bg-gray-200 px-1 rounded text-xs">ui_search</code> - <span data-i18n="migration.changes.uiTools.uiSearch">UI/UX 数据库搜索</span></li>
+                        <li><code class="bg-gray-200 px-1 rounded text-xs">sync_ui_data</code> - <span data-i18n="migration.changes.uiTools.syncUiData">UI/UX 数据同步</span></li>
+                        <li><code class="bg-gray-200 px-1 rounded text-xs">init_component_catalog</code> - <span data-i18n="migration.changes.uiTools.componentCatalog">组件目录初始化</span></li>
+                        <li><code class="bg-gray-200 px-1 rounded text-xs">render_ui</code> - <span data-i18n="migration.changes.uiTools.renderUi">UI 渲染引擎</span></li>
+                    </ul>
+                </div>
+                <div>
+                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
+                        <span>📊</span>
+                        <span data-i18n="migration.changes.structuredOutput.title">4. 结构化输出升级</span>
+                    </h3>
+                    <p class="text-text-secondary text-sm pl-7" data-i18n="migration.changes.structuredOutput.description">核心与编排工具优先支持结构化输出，输出格式一致、可预测，便于工具串联与状态追踪。</p>
+                </div>
+            </section>
+            <!-- 迁移步骤 -->
+            <section class="bg-white rounded-xl border border-border p-4 sm:p-6 mb-6 shadow-sm">
+                <h2 class="text-lg sm:text-xl font-semibold text-text-primary mb-4" data-i18n="migration.steps.title">迁移步骤</h2>
+                <div class="mb-4">
+                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
+                        <span>📦</span>
+                        <span data-i18n="migration.steps.step1.title">步骤 1：更新版本</span>
+                    </h3>
+                    <div class="bg-slate-900 rounded-lg overflow-hidden ml-7">
+                        <div class="flex items-center justify-between px-3 py-2 bg-slate-800">
+                            <span class="text-xs text-slate-300 font-medium">Bash</span>
+                        </div>
+                        <pre class="code-block p-4 text-sm text-slate-200 overflow-x-auto"><code><span data-i18n="migration.steps.step1.npxNote"># 如果使用 npx（推荐）</span>
+<span data-i18n="migration.steps.step1.npxDesc"># 无需操作，自动使用最新版本</span>
+<span data-i18n="migration.steps.step1.globalNote"># 如果全局安装</span>
+npm update -g mcp-probe-kit</code></pre>
+                    </div>
+                </div>
+                <div>
+                    <h3 class="font-medium text-text-primary mb-2 flex items-center gap-2">
+                        <span>📝</span>
+                        <span data-i18n="migration.steps.step2.title">步骤 2：检查配置文件</span>
+                    </h3>
+                    <p class="text-text-secondary text-sm ml-7 mb-3" data-i18n="migration.steps.step2.description">v3.0 的配置文件格式与 v2.x 完全兼容，无需修改。</p>
+                    <div class="ml-7 p-3 bg-green-50 border-l-3 border-green-500 rounded-r text-sm">
+                        <strong>✅ <span data-i18n="migration.steps.step2.compatible">向后兼容：</span></strong><span data-i18n="migration.steps.step2.compatibleText">v2.x 的核心工具在 v3.0 中都保持兼容，可以无缝升级。</span>
+                    </div>
+                </div>
+            </section>
+            <!-- 获取帮助 -->
+            <section class="bg-white rounded-xl border border-border p-4 sm:p-6 mb-6 shadow-sm">
+                <h2 class="text-lg sm:text-xl font-semibold text-text-primary mb-4" data-i18n="migration.help.title">获取帮助</h2>
+                <p class="text-text-secondary text-sm mb-4" data-i18n="migration.help.description">如果在迁移过程中遇到问题：</p>
+                <ul class="list-disc list-inside space-y-2 text-sm text-text-primary">
+                    <li>📖 <span data-i18n="migration.help.viewDocs">查看</span> <a href="./all-tools.html" class="text-primary hover:underline" data-i18n="migration.help.toolsReference">完整工具参考</a></li>
+                    <li>💬 <span data-i18n="migration.help.askIn">在</span> <a href="https://github.com/mybolide/mcp-probe-kit/discussions" target="_blank" rel="noopener" class="text-primary hover:underline">GitHub Discussions</a> <span data-i18n="migration.help.askQuestion">提问</span></li>
+                    <li>🐛 <span data-i18n="migration.help.reportIn">在</span> <a href="https://github.com/mybolide/mcp-probe-kit/issues" target="_blank" rel="noopener" class="text-primary hover:underline">GitHub Issues</a> <span data-i18n="migration.help.reportBug">报告 Bug</span></li>
+                </ul>
+            </section>
+            <!-- 迁移完成 -->
+            <section class="bg-gradient-to-br from-primary to-primary-hover text-white rounded-xl p-4 sm:p-6 mb-6 shadow-sm">
+                <h2 class="text-lg sm:text-xl font-semibold mb-3" data-i18n="migration.complete.title">🎉 迁移完成！</h2>
+                <p class="text-sm opacity-95 mb-4" data-i18n="migration.complete.description">开始探索 v3.0 的强大功能</p>
+                <div class="flex flex-col sm:flex-row gap-3">
+                    <a href="./all-tools.html" class="bg-white/20 text-white px-4 py-2.5 rounded-md text-sm font-medium text-center hover:bg-white/30 transition-colors no-underline">
+                        🛠️ <span data-i18n="migration.complete.viewTools">查看所有工具</span>
+                    </a>
+                    <a href="./examples.html" class="bg-white/20 text-white px-4 py-2.5 rounded-md text-sm font-medium text-center hover:bg-white/30 transition-colors no-underline">
+                        💡 <span data-i18n="migration.complete.learnBestPractices">学习最佳实践</span>
+                    </a>
+                </div>
+            </section>
+            <!-- Footer -->
+            <footer class="text-center text-sm text-text-tertiary py-4 border-t border-border">
+                <p><span data-i18n="footer.madeWith">Made with ❤️ by</span> <a href="https://www.bytezonex.com/" target="_blank" rel="noopener" class="text-primary hover:underline">小墨 (Kyle)</a></p>
+                <p class="mt-1">© 2024-2026 MCP Probe Kit · <a href="https://github.com/mybolide/mcp-probe-kit" target="_blank" rel="noopener" class="text-primary hover:underline">GitHub ↗</a></p>
+            </footer>
+        </div>
+    </main>
+    <script>
+        function toggleSidebar() {
+            const sidebar = document.getElementById('sidebar');
+            const backdrop = document.getElementById('backdrop');
+            const isOpen = sidebar.classList.contains('open');
+            if (isOpen) {
+                sidebar.classList.remove('open');
+                backdrop.classList.remove('active');
+            } else {
+                sidebar.classList.add('open');
+                backdrop.classList.add('active');
+            }
+        }
+    </script>
+    <script src="../assets/js/i18n.js"></script>
+</body>
 </html>