AI导哈

版本验证插件

version-guard是一个Claude Code插件，通过实时文档查询验证和强制执行最新稳定库和包版本的使用，防止推荐过时的版本。

  • by zircote-plugins
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 zircote/version-guard

使用说明

版本保护

A. 克劳德代码 该插件使用实时文档查找来验证和强制使用最新的稳定库和包版本。

问题

克劳德的训练数据有一个知识边界。在推荐库版本、安装命令或依赖配置时，它可能会建议过时的版本，从而导致：

  • 安全漏洞 来自已知易受攻击的旧版本
  • 浪费的迁移努力 当用户安装旧版本并立即需要升级时
  • 不推荐使用API 来自针对被取代版本的代码示例
  • 糟糕的开发人员体验 来自过时的模式和缺失的功能

解决方案

版本保护拦截对版本敏感的上下文，并通过实时文档验证当前的稳定版本 背景7 在做出任何建议之前，请先访问MCP服务器。它适用于13个以上的软件包生态系统。

支持的生态系统

生态系统 依赖文件
节点/npm package.json, package-lock.json
Python/pip requirements.txt, pyproject.toml, setup.py, Pipfile
Python/uv pyproject.toml, uv.lock
Python/诗歌 pyproject.toml, poetry.lock
锈蚀/货物 Cargo.toml, Cargo.lock
去吧 go.mod, go.sum
红宝石 Gemfile, Gemfile.lock, *.gemspec
Java/Maven pom.xml
Java/Gradle build.gradle, build.gradle.kts
.NET *.csproj, packages.config
PHP/编辑器 composer.json, composer.lock
Swift Package.swift
灵丹妙药 mix.exs

安装

来自插件市场

claude plugin install version-guard@<marketplace-name>

从本地路径

克隆存储库并从本地目录安装：

git clone https://github.com/zircote/version-guard.git
claude plugin install --local /path/to/version-guard

来自GitHub

claude plugin install --git https://github.com/zircote/version-guard.git

需求

  • 克劳德代码 命令行界面
  • Context7 MCP服务器 --该插件使用Context7进行实时文档查找。在Claude Code MCP设置中配置它：
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp"]
    }
  }
}
  • 网络接入 --需要查询Context7和（作为后备）网络搜索版本信息

用法

显式调用

/version-guard

然后描述您需要验证的库或依赖关系。例如：

/version-guard What is the latest version of React?

主动激活

当Claude检测到版本敏感的上下文时，该插件会自动激活：

  • 推荐或选择库版本
  • 向项目添加依赖项
  • 编写安装命令(npm install, pip install, cargo add等等）
  • 使用版本敏感的导入编写代码示例
  • 回答“我应该使用哪个版本的X？”问题
  • 升级或审核现有依赖关系

输出示例

当插件验证版本时，您将看到如下输出：

使用React v19.1.0（经过验证的当前训练数据可能引用v18.x）

如果检测到断裂变化：

React 19删除了遗留上下文API(contextType).使用 createContext + useContext 相反。请参阅迁移指南：https://react.dev/blog/2024/04/25/react-19-upgrade-guide

运作原理

  1. 发现 对话中的版本敏感上下文
  2. 负载 Context7 MCP工具（延迟工具，按需加载）
  3. 解决 图书馆via mcp__context7__resolve-library-id
  4. 查询 当前文档通过 mcp__context7__query-docs
  5. 适用于 已验证的版本符合建议和安装命令
  6. 旗帜 升级时破坏更改和弃用模式

后备方案

如果Context7无法解析库，版本保护将回退到：

  1. 网络搜索最新版本
  2. GitHub发布页面或包注册表
  3. 明确说明版本信息的来源

插件结构

version-guard/
├── .claude-plugin/
│   └── plugin.json              # Plugin manifest
├── commands/
│   └── version-guard.md         # User-invocable /version-guard command
├── skills/
│   └── version-guard/
│       └── SKILL.md             # Proactive skill definition
├── references/
│   └── ecosystem-patterns.md    # Ecosystem detection and naming patterns
├── LICENSE
└── README.md

配置

除了Context7 MCP服务器之外，不需要其他配置。该插件安装后即可开箱即用，Context7可用。

许可证

MIT许可证。看 许可证 了解详情。

相关 MCP