关于 qdrant
面向 Qdrant 用户的入门技能，按任务引导至数据建模、检索、部署和运维等参考资料，并提示近期版本变化与升级注意事项。
主要功能
- 01按主题导航参考资料
- 02数据建模与 points 指引
- 03搜索和检索参考
- 04索引与性能说明
- 05部署、安全与运维资料
- 06版本更新与升级要点
适用场景
- 01查找 Qdrant 数据建模指引
- 02选择检索和索引参考资料
- 03准备 Qdrant 部署或升级
- 04检查安全与备份注意事项
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/qdrant确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/api-clients.mdcollections.mdconcepts.mdconfiguration.mddeployment.mdindexing.mdmodeling.mdops-checklist.mdoptimizer.mdpayload.mdpoints.mdquickstart.mdretrieval.mdsecurity.mdsnapshots.mdstorage.md详细介绍
Qdrant（Skill Router）
本文件仅作入门介绍。
它充当路由器：根据你的情况，打开 references/ 下对应的说明。
版本亮点（1.19.0 → 1.19.1）
- TurboQuant 4-bit 作为主要存储方式：
"turbo4"数据类型仅存储 4-bit 量化向量，节省原始向量所需的磁盘空间。 - 按组件设置内存策略： 现在可以为集合组件设置
"memory": "cold" / "cached" / "pinned"，从而更精细地控制内存与性能。严格模式下的max_resident_memory_percent已弃用，改用新的全局配额 API。 - 关键字前缀匹配： 过滤器中的
{"match": {"prefix": "..."}}可按前缀匹配关键字；必须在关键字索引中启用此功能。 - 稀疏搜索： 按查询使用 IDF 语料库，改善不同租户的稀疏排序效果。
- 切片过滤： 通过切片过滤条件进行切片滚动或确定性采样。
- 全局配额 API： 集中限制集群资源使用量（取代严格模式下的内存上限）。
- 路由令牌： 使用读取亲和性选项时，可实现确定性读取路由。
- 1.19.1： 重新设计了 4-bit TurboQuant SIMD，并支持批量 HNSW 搜索（评分更快）和量化评分预取，同时加强了输入校验——拒绝空的稠密向量、长度超过 65536 的向量，以及集合名称中的
./..（安全性）。
版本亮点（1.16.3 → 1.18.0）
- 监控与运维： 新增优化进度／阶段和集群级遥测 API，并增加用于
/metrics的专用 HTTP 端口选项。 - 安全性： 支持审计访问日志和辅助 API 密钥（用于轮换）。
- 检索： 支持相关性反馈和用于混合排序的加权 RRF。
- 写入语义： 为 upsert 提供
update_mode（upsert/update/insert）。 - 1.18.0： TurboQuant 增加了高强度向量压缩路径；集合现在可以原地添加／删除命名向量；运维人员可使用低内存／严格内存控制项，并查看更详细的内存报告。
补丁说明（1.18.1 → 1.18.2）
- 1.18.2 安全性： 修复了特制路径绕过 REST 身份验证白名单的问题，以及恶意快照导致的堆读取漏洞。如果 Qdrant 启用了身份验证／白名单对外开放，或接受上传的快照，请尽快升级。
- 1.18.2： 在分片 WAL 恢复期间记录慢速操作，并在构建分段后清除 ID 跟踪器缓存。
- 修正了对接收浮点值的索引整数范围过滤器，以及对基于负载索引字段使用
{match: {except: []}}时的过滤行为。 - 空向量请求不再触发崩溃路径；应将其视为无效输入，并在发送给 Qdrant 前在调用方进行校验。
- TurboQuant 堆内存报告现在更准确；检查压缩影响时，运维人员应以当前指标为准，而非较早的基准数据。
- 快照上传授权现已收紧；不要假设恢复／上传端点是安全的，必须像审查主 API 一样审查其身份验证。
破坏性变更／升级说明（1.17.0）
- gRPC 客户端： gRPC 中向量字段的响应格式已更改。请升级官方 Qdrant 客户端库，并验证任何自定义 gRPC 集成。
- 存储升级： RocksDB 已移除，改用 gridstore。如果你使用 v1.15.x，请勿直接升级到 v1.17.x——请一次升级一个次要版本。
其他升级说明（1.18.0）
- 启用身份验证后，内部 gRPC 端点现在会强制执行 API 密钥／JWT 身份验证；如果你此前仅依赖私有网络信任，请在升级前验证内部服务到服务的流量。
- 现在可以通过配置禁用从 URL 恢复快照；这与经过安全加固／可自托管的环境有关。
从这里开始（快速入门）
- 刚接触 Qdrant？阅读：
references/concepts.md。 - 想要最快地在本地验证？阅读：
references/quickstart.md+references/deployment.md。 - 要与 Python 集成？阅读：
references/api-clients.md。
按情况选择
数据建模
- 向量、载荷和主数据库中分别应存放哪些内容？请阅读：
references/modeling.md。 - 需要了解 ID、upsert 和写入语义？请阅读：
references/points.md。 - 需要了解载荷类型和更新模式？请阅读：
references/payload.md。
检索（搜索）
- 统一的入口（搜索 + 筛选 + 探索 + 混合检索）：
references/retrieval.md。
性能与索引
- 索引类型及其权衡：
references/indexing.md。 - 对运维有影响的存储和优化器内部机制：
references/storage.md+references/optimizer.md。 - 实用的调优、监控和故障排查：
references/ops-checklist.md。
部署与运维
- 安装/Docker/Kubernetes：
references/deployment.md。 - 配置分层：
references/configuration.md。 - 安全/身份验证/TLS 边界：
references/security.md。 - 备份/恢复：
references/snapshots.md。
API 接口选择
- REST 与 gRPC、Python SDK：
references/api-clients.md。
如何维护此技能
- 保持
SKILL.md简短（路由 + 使用指南）。 - 将详细内容放入
references/*.md。 - 如果能提升内容的可发现性，请合并或重新组织参考文档。
严格禁止事项
- 不要大量照搬或引用供应商文档原文；请用自己的话概述。
- 不要编造文档中没有明确依据的默认值；不确定之处请记录为 TODO。
- 未测试恢复流程前，不要设计备份/恢复方案。
- 不要将 NFS 用作主要持久化后端（安装文档明确警告不要这样做）。
- 不要将内部集群通信端口暴露到公网；应使用私有网络。
- 不要在不可信网络中不使用 TLS 传输 API 密钥/JWT。
- 不要依赖隐式的运行时默认值用于生产；请记录实际生效的配置。
链接
评论
支持 Markdown