MCP Probe Kit

# Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). --- ## [3.0.5] - 2026-02-04 ### 🔧 改进 **MCP Registry 支持** - 在 package.json 中添加 `mcpName` 字段以支持 MCP Registry 发布 - 更新 server.json 使用最新的 schema (2025-12-11) - 优化英文 README 描述，移除中文内容，提升国际化文档质量 --- ## [3.0.3] - 2026-02-03 ### 🔧 改进 **git_work_report 工具重构** - 将 `git_work_report` 从数据驱动工具改为指南型工具 - 工具现在返回指导文本，而不是直接执行 Git 命令 - AI 根据指导在客户端环境中执行 Git 命令并分析 - 解决了 MCP 服务器环境限制和跨平台兼容性问题 - 与其他指南型工具（gencommit、fix_bug 等）保持一致的设计模式 **工作方式**： 1. 用户调用：`git_work_report --date 2026-2-3` 2. 工具返回：包含 Git 命令和输出要求的指导文本 3. AI 执行：根据指导执行 `git log` 和 `git show`，分析 diff 生成报告 --- ## [3.0.2] - 2026-02-03 ### ✨ 新功能 **Git 工作报告生成工具** - 新增 `git_work_report` 工具，基于 Git diff 分析生成工作报告 - 支持日报模式（单个日期）和周期报模式（日期范围） - 自动读取指定日期的所有 Git 提交，执行 `git show` 获取完整 diff - 使用 AI 分析 diff 内容，智能提取实际工作内容 - 输出格式：简洁专业的中文，每条以 `-` 开头，格式为"做了什么 + 改了哪里/达到什么效果" - 支持输出到文件（`--output_file` 参数） **使用示例**： ```bash # 生成日报 git_work_report --date 2026-1-27 # 生成周报 git_work_report --start_date 2026-2-1 --end_date 2026-2-6 # 保存到文件 git_work_report --date 2026-1-27 --output_file daily-report.md ``` ### 📝 文档更新 - 更新 README.md，工具数量从 20 个增加到 21 个 - 更新 Git 工具分类，从 1 个增加到 2 个 - 添加 `git_work_report` 使用示例和说明 - 更新 `docs/data/tools.js` 工具数据 - 新增完整的规格文档（requirements.md, design.md, tasks.md） --- ## [3.0.1] - 2026-02-02 ### 🐛 修复 **工具输出标准化** - 修复 6 个指南型工具的输出格式，避免返回空的结构化数据误导 AI： - `fix_bug` - 改为 okText（返回修复指南） - `add_feature` - 改为 okText（返回规格生成指南） - `estimate` - 改为 okText（返回估算指南） - `gentest` - 改为 okText（返回测试生成指南） - `code_review` - 改为 okText（返回审查指南） - `refactor` - 改为 okText（返回重构指南） **工具分类明确** - 新增 `response.okText()` 函数，专门用于指南型工具 - 工具清晰分为两类： - **指南型工具（6个）**：返回 `okText`，AI 根据指南执行任务 - **数据驱动工具（14个）**：返回 `okStructured`，包含真实的执行计划或数据 - 更新 `tools-manifest.json`，明确标注工具类型和 Schema 用途 ### 🎯 影响 - **用户体验提升**：AI 不再误以为指南型工具已完成任务，会正确地根据指南执行 - **系统更稳定**：所有工具都经过系统化测试和验证 - **文档更清晰**：工具类型和用途一目了然 --- ## [3.0.0] - 2026-02-02 ### 🚀 重大变更 **工具精简 51%：从 39 个精简至 20 个** ### ❌ 删除的工具（19 个） **编排工具（5 个）** - `start_review` → 直接使用 `code_review` 工具即可 - `start_refactor` → 直接使用 `refactor` 工具即可 - `start_api` → AI 可直接生成 API - `start_doc` → AI 可直接生成文档 - `start_release` → 低频操作，手动进行更合适 **代码分析工具（2 个）** - `security_scan` → 功能已集成到 `code_review` - `perf` → 功能已集成到 `code_review` **Git 工具（3 个）** - `genchangelog` → 低频操作，AI 可直接生成 - `genpr` → AI 可直接写 PR 描述 - `resolve_conflict` → 极低频操作 **代码生成工具（5 个）** - `gendoc` → AI 可直接生成代码注释 - `genapi` → AI 可直接生成 API 文档 - `gensql` → AI 可直接生成 SQL - `genreadme` → 低频操作 - `gen_mock` → AI 可直接生成 Mock 数据 **产品设计工具（2 个）** - `gen_prd` → 已集成到 `start_product` - `gen_prototype` → 已集成到 `start_product` **UI 内部工具（2 个）** - `init_component_catalog` → `start_ui` 内部调用 - `render_ui` → `start_ui` 内部调用 ### ✨ 保留的工具（20 个） **编排工具（6 个）** - `start_feature`, `start_bugfix`, `start_onboard`, `start_ui`, `start_product`, `start_ralph` **日常工具（9 个）** - `gencommit`, `code_review`, `gentest`, `refactor`, `fix_bug`, `add_feature`, `init_project`, `init_project_context`, `estimate` **交互工具（2 个）** - `interview`, `ask_user` **UI/UX 工具（3 个）** - `ui_design_system`, `ui_search`, `sync_ui_data` ### 📝 设计哲学 v3.0 专注于以下核心理念： - **消除选择困难**：减少工具数量，让用户快速找到正确的工具 - **专注核心竞争力**：保留编排工具和高频工具，删除 AI 可直接完成的任务 - **让 AI 做更多**：低频、简单的生成任务直接交给 AI 原生能力 ### ⚠️ 迁移指南 如果您在 v2.x 中使用了已删除的工具，请参考以下迁移方案： 1. **编排工具** → 直接使用对应的原子工具或让 AI 直接生成 2. **代码分析** → 使用 `code_review` 工具，支持 `focus` 参数指定分析重点 3. **Git 工具** → 直接向 AI 描述需求，AI 会生成符合规范的内容 4. **代码生成** → 直接向 AI 描述需求，无需专门工具 5. **产品设计** → 使用 `start_product` 统一入口 6. **UI 内部工具** → 使用 `start_ui` 统一入口 --- ## [2.5.0] - 2026-01-30 ### ✨ 改进 **工作流与工具清理** - 🧹 **工具列表精简**：移除低频/重复工具（debug、analyze_project、check_deps、genui、design2code），保持核心工具清晰可维护 - 🧭 **工作流分类优化**：`start_product` 归入「工作流编排」，与产品→研发流程一致 - 📚 **文档与清单对齐**：工具清单、分类与数量（39）统一更新，避免文档/Schema 不一致 **start_ui 生产级增强** - 🧩 **模板落盘步骤明确**：新增“保存模板文件”的执行步骤，确保 UI 生成流程可追踪 - 🧠 **产品类型推断**：从需求描述中推断 `product_type`，减少用户输入 - 🎨 **颜色策略优化**：默认避免蓝紫“AI 风”配色，需明确需求才启用 ### 🧪 测试 - 更新 start_ui 相关测试用例，保持流程与文档一致 --- ## [2.3.1] - 2026-01-29 ### 🐛 Bug 修复 **产品设计工具指导文本优化** - 🔧 **add_feature** - 重构指导文本模板，参考 gen_prd 的格式，使用更清晰的 markdown 模板和 `[填写：xxx]` 标记 - 🔧 **gen_prd** - 统一目录结构为 `docs/specs/{feature_name}/`，与 add_feature 保持一致 - 🔧 **gen_prototype** - 添加 featureName 提取逻辑，统一目录结构 - 🔧 **start_product** - 更新工作流指导，确保所有文档在正确的目录下创建 ### 📝 改进说明 之前的工具指导文本不够清晰，AI 可能无法正确理解如何创建文件。本次更新： - 所有产品设计工具现在使用统一的 `docs/specs/{feature_name}/` 目录结构 - 指导文本更加明确，直接提供完整的 markdown 模板 - 使用 `[填写：xxx]` 标记需要 AI 智能填充的部分 - 移除冗长的编写指南，让模板更简洁直观 --- ## [2.3.0] - 2026-01-29 ### ✨ 新功能 **产品设计工作流** - 🎯 **gen_prd** - 生成产品需求文档（PRD），包含产品概述、功能需求、优先级、非功能性需求和页面清单 - 📐 **gen_prototype** - 生成原型设计文档，为每个页面生成独立的 Markdown 文档，包含页面结构、交互说明和元素清单 - 🎨 **HTML 可交互原型** - 自动生成可在浏览器中直接查看的 HTML 原型，应用设计系统样式，支持响应式布局 - 🚀 **start_product** - 产品设计完整工作流编排，一键完成：PRD → 原型文档 → 设计系统 → HTML 原型 → 项目上下文更新 ### 🔧 改进 - 完善产品设计到开发的完整链路 - 与现有 UI/UX 工具深度集成（ui_design_system、start_ui） - 支持从需求访谈到原型演示的一站式流程 - HTML 原型可直接给客户演示，无需额外的原型工具 - 工具总数从 39 个增加到 42 个 ### 📚 使用场景 **完整产品设计流程：** ```bash # 一键生成完整产品设计 start_product --description "在线教育平台" --product_name "EduPro" # 生成的文件： # - docs/prd/product-requirements.md (PRD 文档) # - docs/prototype/*.md (原型文档) # - docs/design-system/design-system.json (设计系统) # - docs/html-prototype/index.html (HTML 原型索引) # - docs/html-prototype/page-*.html (各页面 HTML 原型) ``` **单独使用工具：** ```bash # 只生成 PRD gen_prd --description "在线教育平台" # 基于 PRD 生成原型 gen_prototype --prd_path "docs/prd/product-requirements.md" ``` --- ## [2.2.1] - 2026-01-28 ### 🔧 改进 **gencommit 工具优化** - 改为只返回指导文本，不再返回结构化 JSON 示例 - AI 根据指导和实际代码变更生成符合规范的 commit 消息 - 避免 AI 直接使用示例数据，确保生成真实的 commit 内容 ### 🧪 测试 - 更新 gencommit 相关测试用例，验证纯文本指导输出 - 所有 299 个测试通过 --- ## [2.2.0] - 2026-01-28 ### ✨ 新功能 **start_ui 工具增强** - 🎯 **第一步生成项目上下文**：调用 `init_project_context` 确保项目文档完整 - 📝 **自动更新索引**：生成 UI 文档后自动添加到 `project-context.md` 索引中 - 🔍 **智能框架检测**：优先从 `project-context.md` 读取框架信息，确保一致性 - 📋 **完整工作流**：6 个步骤覆盖从项目上下文到 UI 生成的完整流程 ### 🔧 改进 - 工作流步骤从 4 个增加到 6 个，更完整的开发流程 - 框架检测优先使用已生成的项目上下文，避免重复检测 - 默认框架改为 html（最通用），而不是 react - UI 文档自动集成到项目上下文系统中 - **gencommit 工具简化**：改为只返回指导文本，让 AI 根据实际代码变更生成 commit 消息 ### 🎨 文档优化 - 在文档网站左侧导航添加可展开的工具列表子菜单 - 支持点击工具名称直接跳转到对应位置 - 每个工具添加简短描述（最多 4 个字） - 优化滚动偏移，避免被页头遮挡 - 添加平滑滚动和高亮效果 - 改善用户体验，方便快速查找工具 --- ## [2.1.2] - 2026-01-28 ### 🐛 修复 - **依赖配置错误**：将 `csv-parse` 和 `tar` 从 `devDependencies` 移到 `dependencies` - 这两个包是运行时依赖，用于 UI/UX 数据同步功能 - 修复了用户安装后可能遇到的模块找不到问题 --- ## [2.1.1] - 2026-01-28 ### 🎯 重大改进 **init_project_context 工具重新设计** - 🔥 **移除复杂的"分析任务"系统**，采用简单直接的模板方式 - ✨ **始终生成索引文件** `project-context.md` 作为项目上下文的入口（项目的灵魂） - 📋 **提供具体的 Markdown 模板**，而不是抽象的分析任务 - 🎯 **新增"开发时查看对应文档"部分**，按开发场景（添加新功能、修改代码、调试问题等）智能分类文档 - 💡 **强调从项目中提取真实代码示例**，避免生成泛化内容 ### 📚 文档生成改进 **根据项目类型生成不同文档**： - **后端 API 项目**：索引 + 技术栈 + 架构 + 如何添加接口 + 如何操作数据库 + 如何处理认证 - **前端 SPA 项目**：索引 + 技术栈 + 架构 + 如何创建新页面 + 如何调用API + 如何管理状态 - **全栈项目**：索引 + 技术栈 + 架构 + 如何开发新功能 + 如何添加接口 + 如何创建新页面 - **库/SDK 项目**：索引 + 技术栈 + 架构 + 如何添加新工具 + 如何编写测试 - **CLI 工具**：索引 + 技术栈 + 架构 + 如何添加新命令 + 如何编写测试 ### 🗑️ 移除 - 删除 `src/lib/analysis-tasks.ts` - 过于复杂的分析任务系统 - 删除 `src/lib/task-generator.ts` - 任务指导生成器 - 移除 `mode` 参数 - 现在只有一种模式（模块化），更简单 ### 🎨 用户体验提升 - 索引文件包含**按场景分类的文档导航**（添加新功能、修改现有代码、调试问题、编写测试、部署上线） - 每个文档都有**清晰的填写指导**和**具体的模板结构** - 多次强调**必须从项目中提取真实代码**，不要编造示例 ### 📝 文档 - 新增 `docs/specs/project-context-modular/implementation-v2.md` - 详细说明新设计 - 新增 `docs/specs/project-context-modular/example-output.md` - 输出示例 - 更新 `docs/specs/project-context-modular/tasks.md` - 添加 v2.1 重新设计说明 ### 🧪 测试 - 所有 299 个测试通过 - `init_project_context` 的 9 个测试全部通过 ### 💬 用户反馈 解决了用户反馈的问题："生成的文件太泛了，第一眼看很牛逼，仔细看就不行了" --- ## [2.1.0] - 2026-01-27 ### ✨ 新功能 **init_project_context 工具增强** - 新增 `mode` 参数，支持两种文档生成模式： - `single`（单文件模式）：生成一个包含所有信息的 `project-context.md` 文件（默认，v2.0 兼容） - `modular`（模块化模式）：生成 1 个索引文件 + 5 个分类文档，便于大型项目管理 - 模块化模式生成 6 个文档： - `project-context.md` - 索引文件（唯一入口） - `project-context/tech-stack.md` - 技术栈信息 - `project-context/architecture.md` - 架构和项目结构 - `project-context/coding-standards.md` - 编码规范 - `project-context/dependencies.md` - 依赖管理 - `project-context/workflows.md` - 开发流程和命令 ### 🔧 改进 - 增强错误处理，提供更友好的错误提示 - 添加 `mode` 字段到 `ProjectContext` Schema，标识使用的生成模式 - 完善的参数验证（拒绝无效的 mode 值） - 支持自定义文档目录（`docs_dir` 参数） ### 📝 文档 - 更新工具使用说明 - 添加模块化模式使用示例 ### 🧪 测试 - 新增 9 个契约测试，覆盖单文件和模块化两种模式 - 所有 151 个测试通过 ### 🔄 向后兼容 - 默认使用单文件模式，完全兼容 v2.0 - 现有用户无需修改任何代码 --- ## [2.0.0] - 2026-01-27 ### 🎉 重大版本发布 - 完整文档系统与工具精简 #### 核心变更 **✅ 工具精简优化** - 从 48 个工具精简到 39 个核心工具 - 删除低频、重复、过时的工具 - 100% 支持结构化输出 - 提高维护性和用户体验 **✅ 完整文档系统** - 全新文档网站：https://mcp-probe-kit.bytezonex.com - 5 个核心页面：首页、安装配置、所有工具、迁移指南、最佳实践 - 完整的 SEO 优化和响应式设计 - 支持源码编译安装方式 **✅ 架构优化** - 修复 MCP SDK 兼容性问题（Tasks API） - 删除未使用代码（净减少 751 行） - 优化 CSS 样式（修复点击蓝色边框问题） #### 工具分类（39 个） **工作流编排（10 个）** - start_feature, start_bugfix, start_review, start_release, start_refactor - start_onboard, start_api, start_doc, start_ui, start_ralph **代码分析（7 个）** - code_review, security_scan, debug, perf, refactor, fix_bug, estimate **Git 工具（4 个）** - gencommit, genchangelog, genpr, resolve_conflict **生成工具（7 个）** - genapi, gendoc, gentest, gensql, genreadme, gen_mock, genui **项目管理（7 个）** - init_project, analyze_project, init_project_context, add_feature - check_deps, interview, ask_user **UI/UX 工具（6 个）** - ui_design_system, ui_search, sync_ui_data, init_component_catalog - render_ui, design2code #### 文档更新 - ✅ 完整的在线文档系统 - ✅ 简化的 README（从 1755 行精简到 200 行） - ✅ 迁移指南（v1.x → v2.0） - ✅ 最佳实践指南（完整研发流程） #### 技术细节 - 修复 "Schema is missing a method literal" 错误 - 暂时禁用 Tasks API（等待 MCP SDK 正式支持） - 删除未使用文件：elicitation-helper.ts, tool-params-guide.ts, resources/index.ts - 优化 CSS：使用 :focus-visible 保留键盘导航可访问性 --- ## [1.14.0] - 2025-01-24 ### Added - 🎨 **UI/UX Pro Max 工具集** - `ui_design_system` - 智能设计系统生成器 - `ui_search` - UI/UX 数据库搜索（BM25 算法） - `sync_ui_data` - 同步最新 UI/UX 数据 - 支持 React、Vue、Next.js、Tailwind 等主流技术栈 - 内嵌数据 + 缓存策略，离线可用 --- ## [1.13.0] - 2025-01-21 ### Added - 🚀 **Ralph Wiggum Loop 循环开发** - `start_ralph` - 自动化循环迭代开发 - 多重安全保护机制（迭代次数、运行时间、人工确认） - 生成 `.ralph/` 目录和安全模式脚本 - 跨平台支持（Linux/Mac/Windows） --- ## [1.12.0] - 2025-01-21 ### Added - 🎸 **需求访谈工具** - `interview` - 结构化需求访谈，避免理解偏差 - `ask_user` - AI 主动提问工具 - 生成访谈记录文档 --- ## [1.11.0] - 2025-01-17 ### Changed - 🏗️ **模块化 Schema 定义** - 将 800+ 行代码拆分为模块化结构 - 创建 `src/schemas/` 目录，按功能分类 - 所有工具的 inputSchema.properties 完整定义 - 新增 MCP Resource: `probe://tool-params-guide` --- ## [1.10.0] - 2025-01-17 ### Changed - 🎯 **自然语言输入支持** - 所有工具支持直接传递自然语言字符串 - inputSchema 类型从 `object` 改为 `string` - 智能参数解析，支持 5+ 种输入格式 - 支持中文字段别名 --- ## [1.8.0] - 2025-01-16 ### Added - 🎸 **Agent Skills 支持** - `gen_skill` - 生成 Agent Skills 文档 - 支持 agentskills.io 开放标准 - 兼容 Claude/Gemini/OpenCode --- ## [1.7.0] - 2025-01-14 ### Added - 🎨 **设计稿转代码** - `design2code` - 支持图片 URL、Base64、文字描述 - 支持 React、Vue 双框架 - 1:1 精确还原设计稿 --- ## [1.2.6] - 2025-10-27 ### Added - 🎸 **Commit Emoji 支持** - 为所有 commit 类型添加 emoji（�🎸✏️💄🤖♻️✅） - 新增 `fixed` 类型用于线上缺陷修复 --- ## Earlier Versions See [GitHub Releases](https://github.com/mybolide/mcp-probe-kit/releases) for versions prior to 1.2.6. --- ## Links - [Documentation](https://mcp-probe-kit.bytezonex.com) - [GitHub Repository](https://github.com/mybolide/mcp-probe-kit) - [npm Package](https://www.npmjs.com/package/mcp-probe-kit) - [Issue Tracker](https://github.com/mybolide/mcp-probe-kit/issues)