1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | qdrant-version-upgrade | SKILL.md |
| 作者/维护者 | Qdrant 官方仓库 qdrant/skills；核心提交者包括 Qdrant CTO Andrey Vasnetsov（GitHub: generall）及多名 Qdrant 工程师 |
GitHub API |
| 来源链接 | https://github.com/qdrant/skills/tree/main/skills/qdrant-version-upgrade | — |
| 许可证 | Apache License 2.0 | GitHub API |
| GitHub Stars / Forks | 所属仓库 208★ / 23 forks（该数字属整个 Qdrant Skills 合集，不代表本技能个体热度，仅供了解所属仓库规模） | GitHub API |
| 最新版本 | SKILL.md 未单独标注版本号，随仓库持续滚动更新；本技能最近一次提交为 2026-07-16，仓库唯一正式发布标签为 v0.1.0 | 仓库提交历史 |
| 安装方式 | 见第 10 章 | 官方 README |
2. 功能介绍与亮点
qdrant-version-upgrade 是 Qdrant 官方提供的版本升级操作指南，把“如何在不中断服务、不丢数据的前提下升级 Qdrant”这件容易踩坑的运维工作，浓缩成一套清晰的兼容性规则：
- 版本兼容性规则：明确 Qdrant 服务端与 SDK 的大版本/小版本匹配要求，以及跨小版本时应先升 SDK 还是先升服务端
- 存储兼容性边界：数据存储格式只保证向后兼容一个小版本，跨多个版本升级时必须按顺序逐级升级，而非一步到位
- 零停机滚动升级：说明副本因子达到 2 及以上时，如何通过逐节点滚动升级维持服务可用性
- 云端简化路径：指出 Qdrant Cloud 环境可自动处理跨版本升级，无需手动逐级操作
亮点：内容是官方对“升级什么时候安全、什么时候会踩坑”的直接回答，而非泛泛的 CHANGELOG 罗列；纯文本指南，不含任何脚本或可执行代码。
3. 适用场景
所属分类：DevOps 与基础设施
适用于已经在生产环境运行 Qdrant、需要规划版本升级的团队：例如从 1.15.x 升级到最新版本时判断该走几步、判断集群副本数是否足以支撑滚动升级、或需要向团队解释“为什么不能跳版本升级”时，可直接把这份指南交给编码 Agent 作为决策依据。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。官方提供
/plugin marketplace add qdrant/skills插件市场安装，也可克隆仓库后复制到~/.claude/skills/ - Codex：✅ 支持。仓库 README 明确列出 OpenAI Codex 为受支持 Agent，并给出
~/.codex/skills/的手动安装路径 - OpenClaw：❓ 未验证。仓库 README 的受支持 Agent 列表中出现的是 OpenCode（另一独立项目），未提及 OpenClaw，暂无法判断
- Hermes Agent：❓ 未验证。README 受支持列表未提及 Hermes Agent
5. 推荐理由
多数数据库的官方资料只回答“新版本加了什么功能”，很少正面回答“升级路上会在哪一步炸”。这份指南反过来把大版本匹配、存储向后兼容窗口、滚动升级前置条件这几个真正决定升级成不成功的变量讲清楚，且随 Qdrant 版本持续更新，对已经把 Qdrant 用在生产环境、但缺乏专职 DBA 经验的团队是一份可以直接照做的操作手册。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 仓库整体规模有限（208★）；本技能自身有 11 次提交，参与者包含 Qdrant CTO 本人及多名工程师，持续维护超过 4 个月，但尚无第三方平台的独立讨论 |
| 可用性 | 9 | 纯文本决策指南，无需额外配置或账号，一次复制/安装即可使用；最近一次提交为 2026-07-16，维护活跃 |
| 安全性 | 9 | 纯参考文档类内容，不含任何可执行 shell 命令，不发起网络请求，许可证明确 |
安全检查清单：① 不执行 shell 命令；② 运行时不联网外发数据；③ 不要求任何 API key 或凭据；④ 全文核查未发现可疑指令或 prompt injection 迹象；⑤ 作者为 Qdrant 官方仓库，无造假迹象；⑥ License（Apache-2.0）明确；⑦ 最近一次提交为 2026-07-16，维护活跃
综合评分：7.7（三项均值）
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与本技能的差异 |
|---|---|---|
| database-skills（PlanetScale 官方） | 覆盖 MySQL/PostgreSQL/Vitess 的 schema 设计、索引、事务锁与运维排查 | 面向关系型数据库的日常设计与调优，不涉及版本升级路径判断；适用对象是做应用开发的工程师，而非负责版本运维的团队 |
| redis-core（Redis 官方） | 教 Agent 做出正确的 Redis 数据结构选型与 key 命名规范 | 聚焦编码阶段的最佳实践，同样不涉及服务端版本升级与滚动升级策略 |
qdrant-version-upgrade 的差异化在于：它不是数据库使用手册，而是专门解决“服务已经在跑、现在要不出事地升级”这一个动作，这是同类数据库技能里普遍缺失的一块。
8. 用户评价
该技能目前在 Reddit、Hacker News 等第三方社区平台尚无独立具名用户评价。
9. 安装使用方式
- 完整安装（含本技能）：运行
npx skills add qdrant/skills，会安装仓库内全部技能，包括 qdrant-version-upgrade - 仅安装本技能：
npx skills add qdrant/skills/skills/qdrant-version-upgrade - Claude Code 插件市场：依次执行
/plugin marketplace add qdrant/skills与/plugin install qdrant@qdrant - 手动安装：克隆仓库后，将
skills/qdrant-version-upgrade/目录复制到对应 Agent 的技能目录（Claude Code 为~/.claude/skills/，Codex 为~/.codex/skills/） - 安装后无需重启，Agent 会根据用户提问中的关键词（如“如何升级 Qdrant”“滚动升级”“跨版本迁移”）自动触发该技能
10. 注意事项
- 内容聚焦于版本兼容性规则与升级顺序本身，不含具体升级命令的完整脚本，实际操作仍需结合 Qdrant 官方文档
- 涉及副本因子、存储兼容窗口等前提条件，使用前需先确认自己集群的当前配置
- 仓库尚无正式的版本发布节奏，内容可能随 Qdrant 产品迭代而调整，建议关注仓库更新