All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Memory & Cursor History 工具集(6 个新工具)
- 新增
read_memory_asset:从 Qdrant 读取已存储的记忆资产 - 新增
memorize_asset:将记忆资产存储到 Qdrant,支持 Ollama / OpenAI-compatible embedding - 新增
scan_and_extract_patterns:扫描代码库并提取模式到记忆系统 - 新增
cursor_list_conversations:列出本地 Cursor 对话历史 - 新增
cursor_search_conversations:按关键词搜索 Cursor 对话 - 新增
cursor_read_conversation:读取完整 Cursor 对话内容 - 支持 Qdrant 向量存储与自动 collection 创建
- 支持 Windows / macOS / Linux 本地 Cursor 数据库读取
- 环境变量配置:
MEMORY_QDRANT_URL、MEMORY_EMBEDDING_PROVIDER、MEMORY_EMBEDDING_URL等
Git 工作报告工具
- 新增
git_work_report:从 git 历史生成工作报告,支持按作者、时间范围、分支筛选
UI / PRD Skill Bridge 接入
- 新增
skill-bridge模块,统一检测并桥接ui-ux-pro-max、interaction-design、frontend-design start_ui/start_product输出中新增 Skill Bridge 指南区块start_ui/start_product的structuredContent.metadata新增skills状态信息start_ui/start_product的 delegated plan 新增skill-bridge步骤,明确技能调用顺序与缺失回退
工具清单更新
- 工具总数从 20 增至 28
- 新增分类:Memory & Cursor History (6)
- 更新分类:Code Analysis (3 → 4)、Project Management (7 → 6)
tools-manifest.json同步更新至 v3.0.16
UI 数据版本生效策略升级
- 引入会话内版本锁:当前进程不热切换 UI 数据版本,避免同会话输出漂移
- 后台自动检查并下载最新 UI 数据,标记为“下次启动生效”
sync_ui_data输出新增会话状态与“下次启动生效版本”说明
发布产物内嵌数据修复
- 新增
postbuild复制步骤,将src/resources/ui-ux-data复制到build/resources/ui-ux-data - 确保 npm 包内包含内嵌 UI 数据,离线与首启场景可直接使用
- README 新增 UI/PRD 工作流 Skill Bridge 说明与调用顺序
- README 的 Data Sync Strategy 更新为“后台下载 + 下次启动生效”
- docs i18n 版本标记更新至
v3.0.16
多语言 README 全面同步
- 德文/西班牙文/法文/葡语 README 从旧版短文档升级到与英文主 README 同级的信息密度
- 日文/韩文 README 补齐缺失的新章节与配置说明
- 所有语言 README 统一更新至 28 工具、新分类、Memory & Cursor History、GitNexus bridge、TBP workflow、Qdrant 配置等核心章节
- 覆盖语言:de-DE、es-ES、fr-FR、pt-BR、ja-JP、ko-KR、zh-CN
文档站点 i18n 完善
docs/pages/getting-started.html清理所有中文 fallback,统一使用英文默认文案 + i18n 键docs/i18n/*.json补齐 Memory、Cursor History、GitNexus 相关翻译键- 站点四语言(en/zh-CN/ja/ko)翻译覆盖率达到 100%
元数据文件更新
- README 新增 Memory & Cursor History 工具使用说明与配置示例
tools-manifest.json补充 v3.0 新增工具说明与移除工具原因
impact 模式中 file_path 生效问题
- 修复
code_insight的impact流程:当通过context + file_path已解析到具体符号时,impact.target现在会优先使用解析后的uid/id - 避免仍使用原始字符串
target导致误命中同名非目标符号 - 新增回归测试覆盖
context解析结果向impact目标的复用
Windows Notes for Graph Tools 多语言补齐
- 站点文档(en/zh-CN/ja/ko)补充 Build Tools 快速安装说明与命令
- README 多语言文档补齐 Windows 图谱工具说明,确保 de/es/fr/ja/ko/pt-BR/zh-CN 与英文主 README 一致覆盖
- 统一补充快速安装命令:
winget install Microsoft.VisualStudio.2022.BuildTools
code_insight 排序、歧义与使用引导优化
- 强化
query结果重排策略:提高函数名精确/部分匹配与文件路径关键词权重,降低无匹配流程的排序优先级 impact模式新增目标预检查:当目标被解析为Folder/File/Module等不可调用符号时,直接返回歧义提示并建议改用uid或file_path- 简化 delegated plan:从固定多步落盘流程调整为“先消费结果 + 按需保存”
- 在
code_insight返回中增加“使用场景指南 / 下一步建议”,明确goal、uid、file_path、include_content、save_to_docs的使用方式
- README(中英)补充 Windows Build Tools 快速安装命令:
winget install Microsoft.VisualStudio.2022.BuildTools
- 更新
code_insight单测覆盖简化后的 delegated plan 和使用指南输出 - 保持
gitnexus-bridge重排测试通过
GitNexus bridge 启动与 code_insight 可用性增强
- GitNexus bridge 改为优先使用本地已安装的
gitnexusCLI,找不到时再回退到npx - 支持通过
MCP_GITNEXUS_COMMAND/MCP_GITNEXUS_ARGS显式覆盖启动命令 code_insight暴露include_content、uid、file_path参数,减少二次调用成本- 透传 GitNexus 的歧义状态和候选列表,并生成按场景动态变化的 delegated plan
- 新增对
query结果的轻量关键词重排,优先提升与查询词更贴近的流程结果
- 在 README、getting-started 页面及多语言文档中补充 Windows 下图谱工具冷启动、Build Tools 依赖和超时配置说明
- 新增本地
gitnexusCLI 优先启动测试 - 新增 query 结果重排测试
- 新增歧义 delegated plan 与非默认 docs 落盘行为测试
修复 3.0.11 在 Windows 下的二次回归
- 移除手工
cmd.exe /d /s /c包装,改为统一使用cross-spawn处理 Windows 的.cmd/.bat可执行文件 - 修复
3.0.11中引号被 Nodespawn二次转义后变成\"...\",导致code_insight仍然无法启动 GitNexus 的问题 - 保持
npx、npm、以及带空格绝对路径的.cmd可执行文件都能在 Windows 上正常启动
- 新增 Windows 真实执行级测试,不再只检查参数拼装结果
- 覆盖
npx --version实际启动验证 - 覆盖带空格绝对路径的
.cmd脚本实际启动验证
Windows 下 GitNexus Bridge 命令路径带空格时执行失败
- 修复
code_insight桥接 GitNexus 时,cmd.exe /d /s /c包装.cmd/.bat可执行文件未加引号的问题 - 当 Node.js 安装在
C:\Program Files\nodejs\等带空格目录时,npx.cmd现在会被正确引用,不再触发'C:\Program' 不是内部或外部命令 - 补充 Windows 回归测试,覆盖带空格绝对路径的
.cmd启动场景
- 检查项目内其它 Windows 命令拼装入口,未发现同类未加引号的
cmd.exe包装问题
MCP Tasks / Progress / Cancellation 增强
- 基于官方
@modelcontextprotocol/sdk@1.27.1启用原生任务能力(tasks/get|result|list|cancel) tools/call支持任务化执行:创建任务后后台运行并回填任务结果- 长任务增加进度通知(
notifications/progress)与协作式取消(AbortSignal) start_*编排工具和sync_ui_data接入统一执行上下文(进度 + 取消)
前向兼容与扩展能力
- 透传请求
_meta.trace到工具响应_meta(可配置 trace key) - 增加 extensions capability 开关(
MCP_ENABLE_EXTENSIONS_CAPABILITY=1) - 增加可选 MCP Apps UI 资源输出(
ui://...+_meta.ui.resourceUri,MCP_ENABLE_UI_APPS=1)
- 重构
sync_ui_data底层同步流程,支持下载/解压/处理阶段进度上报与取消中断 - 更新 README 与多语言文档中的 SDK 版本与能力说明
MCP Registry 支持
- 在 package.json 中添加
mcpName字段以支持 MCP Registry 发布 - 更新 server.json 使用最新的 schema (2025-12-11)
- 优化英文 README 描述,移除中文内容,提升国际化文档质量
git_work_report 工具重构
- 将
git_work_report从数据驱动工具改为指南型工具 - 工具现在返回指导文本,而不是直接执行 Git 命令
- AI 根据指导在客户端环境中执行 Git 命令并分析
- 解决了 MCP 服务器环境限制和跨平台兼容性问题
- 与其他指南型工具(gencommit、fix_bug 等)保持一致的设计模式
工作方式:
- 用户调用:
git_work_report --date 2026-2-3 - 工具返回:包含 Git 命令和输出要求的指导文本
- AI 执行:根据指导执行
git log和git show,分析 diff 生成报告
Git 工作报告生成工具
- 新增
git_work_report工具,基于 Git diff 分析生成工作报告 - 支持日报模式(单个日期)和周期报模式(日期范围)
- 自动读取指定日期的所有 Git 提交,执行
git show获取完整 diff - 使用 AI 分析 diff 内容,智能提取实际工作内容
- 输出格式:简洁专业的中文,每条以
-开头,格式为"做了什么 + 改了哪里/达到什么效果" - 支持输出到文件(
--output_file参数)
使用示例:
# 生成日报
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)
工具输出标准化
- 修复 6 个指南型工具的输出格式,避免返回空的结构化数据误导 AI:
fix_bug- 改为 okText(返回修复指南)add_feature- 改为 okText(返回规格生成指南)estimate- 改为 okText(返回估算指南)gentest- 改为 okText(返回测试生成指南)code_review- 改为 okText(返回审查指南)refactor- 改为 okText(返回重构指南)
工具分类明确
- 新增
response.okText()函数,专门用于指南型工具 - 工具清晰分为两类:
- 指南型工具(6个):返回
okText,AI 根据指南执行任务 - 数据驱动工具(14个):返回
okStructured,包含真实的执行计划或数据
- 指南型工具(6个):返回
- 更新
tools-manifest.json,明确标注工具类型和 Schema 用途
- 用户体验提升:AI 不再误以为指南型工具已完成任务,会正确地根据指南执行
- 系统更稳定:所有工具都经过系统化测试和验证
- 文档更清晰:工具类型和用途一目了然
工具精简 51%:从 39 个精简至 20 个
编排工具(5 个)
start_review→ 直接使用code_review工具即可start_refactor→ 直接使用refactor工具即可start_api→ AI 可直接生成 APIstart_doc→ AI 可直接生成文档start_release→ 低频操作,手动进行更合适
代码分析工具(2 个)
security_scan→ 功能已集成到code_reviewperf→ 功能已集成到code_review
Git 工具(3 个)
genchangelog→ 低频操作,AI 可直接生成genpr→ AI 可直接写 PR 描述resolve_conflict→ 极低频操作
代码生成工具(5 个)
gendoc→ AI 可直接生成代码注释genapi→ AI 可直接生成 API 文档gensql→ AI 可直接生成 SQLgenreadme→ 低频操作gen_mock→ AI 可直接生成 Mock 数据
产品设计工具(2 个)
gen_prd→ 已集成到start_productgen_prototype→ 已集成到start_product
UI 内部工具(2 个)
init_component_catalog→start_ui内部调用render_ui→start_ui内部调用
编排工具(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 中使用了已删除的工具,请参考以下迁移方案:
- 编排工具 → 直接使用对应的原子工具或让 AI 直接生成
- 代码分析 → 使用
code_review工具,支持focus参数指定分析重点 - Git 工具 → 直接向 AI 描述需求,AI 会生成符合规范的内容
- 代码生成 → 直接向 AI 描述需求,无需专门工具
- 产品设计 → 使用
start_product统一入口 - UI 内部工具 → 使用
start_ui统一入口
工作流与工具清理
- 🧹 工具列表精简:移除低频/重复工具(debug、analyze_project、check_deps、genui、design2code),保持核心工具清晰可维护
- 🧭 工作流分类优化:
start_product归入「工作流编排」,与产品→研发流程一致 - 📚 文档与清单对齐:工具清单、分类与数量(39)统一更新,避免文档/Schema 不一致
start_ui 生产级增强
- 🧩 模板落盘步骤明确:新增“保存模板文件”的执行步骤,确保 UI 生成流程可追踪
- 🧠 产品类型推断:从需求描述中推断
product_type,减少用户输入 - 🎨 颜色策略优化:默认避免蓝紫“AI 风”配色,需明确需求才启用
- 更新 start_ui 相关测试用例,保持流程与文档一致
产品设计工具指导文本优化
- 🔧 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 智能填充的部分 - 移除冗长的编写指南,让模板更简洁直观
产品设计工作流
- 🎯 gen_prd - 生成产品需求文档(PRD),包含产品概述、功能需求、优先级、非功能性需求和页面清单
- 📐 gen_prototype - 生成原型设计文档,为每个页面生成独立的 Markdown 文档,包含页面结构、交互说明和元素清单
- 🎨 HTML 可交互原型 - 自动生成可在浏览器中直接查看的 HTML 原型,应用设计系统样式,支持响应式布局
- 🚀 start_product - 产品设计完整工作流编排,一键完成:PRD → 原型文档 → 设计系统 → HTML 原型 → 项目上下文更新
- 完善产品设计到开发的完整链路
- 与现有 UI/UX 工具深度集成(ui_design_system、start_ui)
- 支持从需求访谈到原型演示的一站式流程
- HTML 原型可直接给客户演示,无需额外的原型工具
- 工具总数从 39 个增加到 42 个
完整产品设计流程:
# 一键生成完整产品设计
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 原型)单独使用工具:
# 只生成 PRD
gen_prd --description "在线教育平台"
# 基于 PRD 生成原型
gen_prototype --prd_path "docs/prd/product-requirements.md"gencommit 工具优化
- 改为只返回指导文本,不再返回结构化 JSON 示例
- AI 根据指导和实际代码变更生成符合规范的 commit 消息
- 避免 AI 直接使用示例数据,确保生成真实的 commit 内容
- 更新 gencommit 相关测试用例,验证纯文本指导输出
- 所有 299 个测试通过
start_ui 工具增强
- 🎯 第一步生成项目上下文:调用
init_project_context确保项目文档完整 - 📝 自动更新索引:生成 UI 文档后自动添加到
project-context.md索引中 - 🔍 智能框架检测:优先从
project-context.md读取框架信息,确保一致性 - 📋 完整工作流:6 个步骤覆盖从项目上下文到 UI 生成的完整流程
- 工作流步骤从 4 个增加到 6 个,更完整的开发流程
- 框架检测优先使用已生成的项目上下文,避免重复检测
- 默认框架改为 html(最通用),而不是 react
- UI 文档自动集成到项目上下文系统中
- gencommit 工具简化:改为只返回指导文本,让 AI 根据实际代码变更生成 commit 消息
- 在文档网站左侧导航添加可展开的工具列表子菜单
- 支持点击工具名称直接跳转到对应位置
- 每个工具添加简短描述(最多 4 个字)
- 优化滚动偏移,避免被页头遮挡
- 添加平滑滚动和高亮效果
- 改善用户体验,方便快速查找工具
- 依赖配置错误:将
csv-parse和tar从devDependencies移到dependencies- 这两个包是运行时依赖,用于 UI/UX 数据同步功能
- 修复了用户安装后可能遇到的模块找不到问题
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 个测试全部通过
解决了用户反馈的问题:"生成的文件太泛了,第一眼看很牛逼,仔细看就不行了"
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字段到ProjectContextSchema,标识使用的生成模式 - 完善的参数验证(拒绝无效的 mode 值)
- 支持自定义文档目录(
docs_dir参数)
- 更新工具使用说明
- 添加模块化模式使用示例
- 新增 9 个契约测试,覆盖单文件和模块化两种模式
- 所有 151 个测试通过
- 默认使用单文件模式,完全兼容 v2.0
- 现有用户无需修改任何代码
✅ 工具精简优化
- 从 48 个工具精简到 39 个核心工具
- 删除低频、重复、过时的工具
- 100% 支持结构化输出
- 提高维护性和用户体验
✅ 完整文档系统
- 全新文档网站:https://mcp-probe-kit.bytezonex.com
- 5 个核心页面:首页、安装配置、所有工具、迁移指南、最佳实践
- 完整的 SEO 优化和响应式设计
- 支持源码编译安装方式
✅ 架构优化
- 修复 MCP SDK 兼容性问题(Tasks API)
- 删除未使用代码(净减少 751 行)
- 优化 CSS 样式(修复点击蓝色边框问题)
工作流编排(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 保留键盘导航可访问性
- 🎨 UI/UX Pro Max 工具集
ui_design_system- 智能设计系统生成器ui_search- UI/UX 数据库搜索(BM25 算法)sync_ui_data- 同步最新 UI/UX 数据- 支持 React、Vue、Next.js、Tailwind 等主流技术栈
- 内嵌数据 + 缓存策略,离线可用
- 🚀 Ralph Wiggum Loop 循环开发
start_ralph- 自动化循环迭代开发- 多重安全保护机制(迭代次数、运行时间、人工确认)
- 生成
.ralph/目录和安全模式脚本 - 跨平台支持(Linux/Mac/Windows)
- 🎸 需求访谈工具
interview- 结构化需求访谈,避免理解偏差ask_user- AI 主动提问工具- 生成访谈记录文档
- 🏗️ 模块化 Schema 定义
- 将 800+ 行代码拆分为模块化结构
- 创建
src/schemas/目录,按功能分类 - 所有工具的 inputSchema.properties 完整定义
- 新增 MCP Resource:
probe://tool-params-guide
- 🎯 自然语言输入支持
- 所有工具支持直接传递自然语言字符串
- inputSchema 类型从
object改为string - 智能参数解析,支持 5+ 种输入格式
- 支持中文字段别名
- 🎸 Agent Skills 支持
gen_skill- 生成 Agent Skills 文档- 支持 agentskills.io 开放标准
- 兼容 Claude/Gemini/OpenCode
- 🎨 设计稿转代码
design2code- 支持图片 URL、Base64、文字描述- 支持 React、Vue 双框架
- 1:1 精确还原设计稿
- 🎸 Commit Emoji 支持
- 为所有 commit 类型添加 emoji(�🎸✏️💄🤖♻️✅)
- 新增
fixed类型用于线上缺陷修复
See GitHub Releases for versions prior to 1.2.6.