版本保护
   
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@从本地路径
克隆存储库并从本地目录安装：
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
运作原理
- 发现 对话中的版本敏感上下文
- 负载 Context7 MCP工具（延迟工具，按需加载）
- 解决 图书馆via
mcp__context7__resolve-library-id - 查询 当前文档通过
mcp__context7__query-docs - 适用于 已验证的版本符合建议和安装命令
- 旗帜 升级时破坏更改和弃用模式
后备方案
如果Context7无法解析库，版本保护将回退到：
- 网络搜索最新版本
- GitHub发布页面或包注册表
- 明确说明版本信息的来源
插件结构
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许可证。看 许可证 了解详情。