1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | qdrant-migration-tool-qdrant-skills |
| 作者/维护者 | Qdrant（官方） |
| 来源链接 | https://github.com/qdrant/skills/tree/main/skills/qdrant-migration-tool |
| 许可证 | Apache License 2.0（GitHub API 获取） |
| GitHub Stars | 234（所属合集仓库 qdrant/skills 整体星数，GitHub API 获取；不代表本技能个体热度） |
| Forks | 27（同仓库整体，GitHub API 获取） |
| 最新版本 | 仓库标签 v0.1.0；本技能文件最近一次更新提交于 2026-09-10（GitHub API 获取） |
| 安装方式 | npx skills add qdrant/skills 一键安装全部技能，或克隆仓库后手动复制到对应 agent 的 skills 目录 |
2. 功能介绍与亮点
该技能指导使用 Qdrant 官方迁移工具（Docker 容器 CLI）把向量、元数据与稀疏向量从其他向量数据库搬进 Qdrant。亮点：一份文档覆盖 Pinecone、Weaviate、Milvus 等 13 种来源，各配专属指南；进度记录在 _migration_offsets 集合，中断后重跑原命令即自动续传；批大小/并发/节流等调参各标明适用场景；要求迁移后跑官方验证框架（基线、完整性、搜索质量），而非抽查了事。
3. 适用场景
**所属分类：DevOps 与基础设施。**面向把生产向量数据库从 Pinecone/Weaviate/Milvus 等迁移到 Qdrant 的开发者与数据基础设施团队：评估迁移可行性时定位对应子命令与前置条件、中途因网络或配额中断后安全续传、迁移完成后按官方框架逐项校验数据完整性与搜索质量。
4. 跨 Agent 兼容性
- Claude Code：原生支持，官方给出专属路径
~/.claude/skills/与一键安装命令。 - Codex：原生支持，官方给出专属路径
~/.codex/skills/。 - OpenClaw / Hermes Agent：未验证，官方未列出，但技能本体是标准 Markdown + YAML front matter 格式，理论上可手动复制使用。
5. 推荐理由
向量数据库迁移一次性但风险高：数据量大、来源各异、易因网络或配额中断。本技能把“用哪个子命令、如何续传、卡顿调什么参数、完成后怎么验证”沉淀成结构化参考，配合官方持续维护的工具本体，能降低搬家过程中出错或返工的概率。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 Qdrant 即所服务向量数据库产品的所有者，属第一方官方出品；所属合集仓库整体 234 star，该数字属整个合集，不代表本技能自身热度，暂无本技能自身的独立第三方讨论证据 |
| 可用性 | 9 | 安装即用（Docker 容器，一行命令启动），13 种来源各有专属文档链接，断点续传与参数调优均给出明确触发条件，仓库最近一次更新提交为 2026-09-10，维护活跃 |
| 安全性 | 9 | 检查清单：①仅执行官方 docker run 命令，范围明确（数据迁移），无任意 shell 执行；②联网对象是用户指定的源/目标数据库，用途透明；③凭据处理依赖官方工具自身机制，正文对 TLS 自签名证书场景专门给出 SSL_CERT_FILE 挂载方式而非默认跳过校验；④正文未发现任何可疑指令；⑤作者为 Qdrant 官方，无造假迹象；⑥License 为 Apache-2.0，明确；⑦近日仍在持续维护 |
综合评分（三项均值）：8.33
7. 跟同类 Skills 相比的优势
| 同类项目 | 定位 | 与本技能的差异 |
|---|---|---|
| qdrant/migration（官方迁移工具本体的 GitHub 仓库） | CLI 工具本身的代码仓库 | 本技能是围绕该 CLI 编写的决策指南，回答“该用哪个参数、出问题怎么办”，工具仓库本身只有代码与基础 README |
| jkfran/QdrantSync（第三方开源迁移工具） | 面向 Qdrant 实例之间同步的第三方工具 | 仅覆盖 Qdrant 到 Qdrant 场景，不支持从 Pinecone/Weaviate 等异构向量库迁入，覆盖面窄于本技能所指导的官方工具 |
| Qdrant 官方迁移文档站（qdrant.tech/documentation） | 面向人类阅读的教程式文档 | 偏概念讲解与完整教程，本技能按“何时用、该做什么”的决策树组织，更适合 agent 在具体报错场景下直接定位对应处置方法 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
同仓库 qdrant-model-migration（切换嵌入模型）与本技能（切换向量数据库本身）是两类不同的迁移场景，可先后配合使用。
10. 安装使用方式
一键安装全部 Qdrant 技能：npx skills add qdrant/skills；Claude Code 插件市场：/plugin marketplace add qdrant/skills 后 /plugin install qdrant@qdrant；也可克隆仓库后手动把 skills/qdrant-migration-tool/ 目录复制到所用 agent 的 skills 目录。安装后无需重启，agent 遇到“如何迁移到 Qdrant”类问题会自动触发；实际执行迁移前需先在本机安装 Docker。
11. 注意事项
实际迁移依赖本机运行 Docker 容器，技能本身不代替对源/目标数据库的连通性与配额规划；Weaviate、Redis、MongoDB、Apache Solr 四种来源不会自动创建目标集合，需提前在 Qdrant 手动创建并匹配好向量维度与距离度量；技能与所属仓库均标注持续开发中，参数可能随版本演进变化，使用前建议对照最新文档。