{"id":10021514,"date":"2026-10-29T11:49:04","date_gmt":"2026-10-29T03:49:04","guid":{"rendered":"https:\/\/itmax.cn\/?p=10021514"},"modified":"2026-10-29T22:26:58","modified_gmt":"2026-10-29T14:26:58","slug":"alibaba-zvec-20261029","status":"publish","type":"post","link":"https:\/\/itmax.cn\/?p=10021514","title":{"rendered":"\u522b\u518d\u4e3a\u51e0\u4e07\u6761\u7b14\u8bb0\u8d77\u4e00\u4e2a\u5411\u91cf\u5e93\u670d\u52a1\u4e86\uff5cZvec \u8fdb\u7a0b\u5185\u5b9e\u6d4b\uff0c3 \u4e2a\u5751\u6211\u66ff\u4f60\u8e29\u4e86"},"content":{"rendered":"
\"zvec
zvec \u5728 GitHub \u4e0a\u7684\u5f53\u524d\u72b6\u6001\uff1a16,160 star\u3001v0.8.0\u3001\u8fd1\u56db\u5468 23 \u6b21\u63d0\u4ea4<\/figcaption><\/figure>\n

\u53bb\u5e74\u505a\u90a3\u4e2a\u300c\u79c1\u4eba\u7b14\u8bb0\u8bed\u4e49\u641c\u7d22\u300d\u7684\u65f6\u5019\uff0c\u6211\u88ab\u4e00\u4ef6\u4e8b\u6298\u78e8\u4e86\u5f88\u4e45\uff1a\u4e3a\u4e86\u641c\u51e0\u4e07\u6761\u7b14\u8bb0\u91cc\u7684\u300c\u90a3\u4e9b\u5199\u8fc7 Redis \u6162\u67e5\u8be2\u7684\u6bb5\u843d\u300d\uff0c\u6211\u62c9\u8d77\u4e86\u4e00\u6574\u5957 Milvus \u96c6\u7fa4\u3002\u4e09\u53f0\u673a\u5668\uff0c\u4e00\u4e2a etcd\uff0c\u4e00\u5806 Python SDK \u7684\u7248\u672c\u5730\u72f1\uff0c\u6700\u540e\u68c0\u7d22\u5ef6\u8fdf 30 \u6beb\u79d2\uff0c\u5176\u4e2d 25 \u6beb\u79d2\u82b1\u5728\u4e86\u7f51\u7edc\u5f80\u8fd4\u548c\u5e8f\u5217\u5316\u4e0a\u3002<\/p>\n

\u66f4\u6c14\u4eba\u7684\u662f\uff0c\u8dd1\u8d77\u6765\u4e4b\u540e\u6211\u53d1\u73b0\uff0c\u5ba2\u6237\u7aef\u7b14\u8bb0\u672c\u4e0a\u90a3\u4efd SQLite \u6570\u636e\u5e93\uff0c\u68c0\u7d22\u7ed3\u679c\u5176\u5b9e\u548c Milvus \u4e00\u6837\u51c6\u3002<\/p>\n

\u90a3\u6b21\u4e4b\u540e\u6211\u5fc3\u91cc\u5c31\u5b58\u4e86\u4e00\u6839\u523a\uff1a\u5411\u91cf\u68c0\u7d22\u8fd9\u4e2a\u4e1c\u897f\uff0c\u7edd\u5927\u591a\u6570\u573a\u666f\u6839\u672c\u4e0d\u9700\u8981\u4e00\u4e2a\u300c\u670d\u52a1\u300d<\/strong>\u3002\u5b83\u5c31\u662f\u4e00\u6b21\u51fd\u6570\u8c03\u7528\u3002<\/p>\n

\u6240\u4ee5\u5f53\u6211\u5728 GitHub \u4e0a\u770b\u5230 alibaba\/zvec<\/code> \u8fd9\u4e2a\u9879\u76ee\u2014\u2014\u4e00\u4e2a\u76f4\u63a5\u5d4c\u8fdb\u4f60\u8fdb\u7a0b\u91cc\u7684 C++ \u5411\u91cf\u6570\u636e\u5e93\u2014\u2014\u6211\u7acb\u523b\u88c5\u4e0a\u8dd1\u4e86\u4e00\u904d\u3002\u8dd1\u5b8c\u4e4b\u540e\u6211\u6709\u8bdd\u8981\u8bf4\uff0c\u800c\u4e14\u6709\u51e0\u4ef6\u4e8b\u8ddf\u5ba3\u4f20\u6750\u6599\u91cc\u5199\u7684\u4e0d\u592a\u4e00\u6837\u3002<\/p>\n

\u6211\u4e3a\u4ec0\u4e48\u76ef\u4e0a\u5b83<\/h2>\n

\u5148\u8bf4\u6e05\u695a\u6211\u81ea\u5df1\u7684\u5904\u5883\uff0c\u8fd9\u6837\u540e\u9762\u7684\u53d6\u820d\u624d\u6709\u610f\u4e49\u3002<\/p>\n

\u6211\u624b\u4e0a\u6709\u4e09\u4e2a\u9700\u6c42\uff0c\u5f62\u72b6\u90fd\u5f88\u50cf\uff1a<\/p>\n

    \n
  1. \u684c\u9762\u7aef\u7684\u4ee3\u7801\u7247\u6bb5\u641c\u7d22\uff0c\u7d22\u5f15\u89c4\u6a21\u5728 5 \u4e07\u6761\u4ee5\u5185<\/li>\n
  2. \u670d\u52a1\u7aef\u4e00\u4e2a\u667a\u80fd\u4f53\u7684\u77ed\u671f\u8bb0\u5fc6\u5e93\uff0c\u9700\u8981\u9891\u7e41\u589e\u5220<\/li>\n
  3. \u5076\u5c14\u8981\u62ff\u4e00\u6279\u4e2d\u6587\u6587\u6863\u505a\u6df7\u5408\u68c0\u7d22\uff08\u5173\u952e\u8bcd + \u8bed\u4e49\uff09<\/li>\n<\/ol>\n

    \u8fd9\u4e09\u4e2a\u9700\u6c42\u8fc7\u53bb\u6211\u90fd\u4f1a\u585e\u8fdb Milvus \u6216\u8005 Qdrant\u3002\u4f46\u8bf4\u5b9e\u8bdd\uff0c\u4e3a 5 \u4e07\u6761\u6570\u636e\u7ef4\u62a4\u4e00\u5957\u5206\u5e03\u5f0f\u96c6\u7fa4\uff0c\u8fd9\u4ef6\u4e8b\u7684\u8fd0\u7ef4\u6210\u672c\u5df2\u7ecf\u5927\u8fc7\u6536\u76ca\u672c\u8eab\u4e86\u3002\u66f4\u522b\u63d0\u6211\u4eec\u7684\u670d\u52a1\u662f\u5355\u8fdb\u7a0b Python \u670d\u52a1\uff0c\u4e3a\u4e00\u4e2a\u68c0\u7d22\u529f\u80fd\u6a2a\u5411\u6269\u4e09\u53f0\u673a\u5668\uff0c\u600e\u4e48\u60f3\u90fd\u522b\u626d\u3002<\/p>\n

    zvec<\/code> \u7684\u601d\u8def\u5f88\u76f4\u63a5\uff1a\u522b\u5f53\u5b83\u662f\u6570\u636e\u5e93\uff0c\u5f53\u5b83\u662f\u4e2a\u5e93<\/strong>\u3002\u7528\u8d77\u6765\u662f\u8fd9\u6837\uff1a<\/p>\n

    import zvec\n\nschema = zvec.CollectionSchema(\n    name="notes",\n    vectors=zvec.VectorSchema("embedding", zvec.DataType.VECTOR_FP32, 768),\n)\ncollection = zvec.create_and_open(path=".\/notes_db", schema=schema)\n<\/code><\/pre>\n
    \u6ca1\u6709 server\uff0c\u6ca1\u6709\u7aef\u53e3\uff0c\u6ca1\u6709\u8fde\u63a5\u4e32\u3002create_and_open<\/code> \u4f20\u4e00\u4e2a\u76ee\u5f55\u8def\u5f84\uff0c\u8fd4\u56de\u4e00\u4e2a\u5bf9\u8c61\u3002\u6570\u636e\u5c31\u8eba\u5728\u90a3\u4e2a\u76ee\u5f55\u91cc\uff0c\u8fdb\u7a0b\u9000\u51fa\u4e86\u5b83\u8fd8\u5728\u3002<\/p>\n
    \u8fd9\u5c31\u662f\u6211\u76ef\u4e0a\u5b83\u7684\u539f\u56e0\u2014\u2014\u5b83\u628a\u300c\u90e8\u7f72\u4e00\u4e2a\u670d\u52a1\u300d\u8fd9\u4ef6\u4e8b\u6574\u4e2a\u5220\u6389\u4e86<\/strong>\u3002\u5220\u5f97\u5e72\u51c0\uff0c\u4e0d\u662f\u6211\u81ea\u5df1\u62fc\u7684\u3002<\/p>\n
    \u5b83\u5b9e\u9645\u80fd\u5e72\u4ec0\u4e48<\/h2>\n
    \u6211\u628a\u5b83\u5206\u6210\u51e0\u7ec4\u8bf4\uff0c\u6bcf\u7ec4\u90fd\u5199\u6e05\u695a\u54ea\u4e9b\u662f\u6211\u771f\u8dd1\u901a\u7684\uff0c\u54ea\u4e9b\u662f README \u4e0a\u5199\u7740\u4f46\u6211\u6ca1\u9a8c\u7684\u3002<\/p>\n
    \u7b2c\u4e00\u7ec4\uff1a\u7a20\u5bc6\u5411\u91cf\u68c0\u7d22\uff0c\u8fd9\u662f\u5b83\u7684\u770b\u5bb6\u672c\u9886<\/h3>\n
    \u5b98\u65b9 README \u7684\u6700\u5c0f\u4f8b\u5b50\u6211\u539f\u6837\u8dd1\u4e86\u4e00\u904d\uff0c\u8f93\u51fa\u786e\u5b9e\u662f\u8fd9\u6837\uff1a<\/p>\n
    collection.insert([\n    zvec.Doc(id="doc_1", vectors={"embedding": [0.1, 0.2, 0.3, 0.4]}),\n    zvec.Doc(id="doc_2", vectors={"embedding": [0.2, 0.3, 0.4, 0.1]}),\n])\n\nresults = collection.query(\n    zvec.Query(field_name="embedding", vector=[0.4, 0.3, 0.3, 0.1]),\n    topk=10\n)\n# [{'id': 'doc_2', 'score': 0.30...}, {'id': 'doc_1', 'score': 0.23...}]\n<\/code><\/pre>\n
    \u6211\u62ff\u8fd9\u4e2a API \u8dd1\u4e86\u4e00\u4e2a\u7a0d\u5fae\u50cf\u6837\u7684\u538b\u6d4b\uff1a5 \u4e07\u6761 768 \u7ef4\u968f\u673a\u5411\u91cf\uff0cHNSW \u7d22\u5f15\uff0cm=16<\/code>\u3001ef_construction=200<\/code>\u3001L2 \u8ddd\u79bb\u3002\u6211\u7684\u673a\u5668\u662f M2 MacBook Pro\uff0c64GB \u5185\u5b58\u3002<\/p>\n
    \u7ed3\u679c\u662f\u8fd9\u6837\uff1a<\/p>\n\n\n\n\n\n\n\n\n\n\n\n
    \u9636\u6bb5<\/th>\n\u5b9e\u6d4b\u8017\u65f6<\/th>\n<\/tr>\n<\/thead>\n
    \u63d2\u5165 5 \u4e07\u6761<\/td>\n6.12 \u79d2\uff08\u7ea6 8173 docs\/s\uff09<\/td>\n<\/tr>\n
    HNSW \u5efa\u7d22\u5f15<\/td>\n37.28 \u79d2<\/td>\n<\/tr>\n
    \u67e5\u8be2 topk=10<\/td>\np50 = 1.881ms\uff0cp95 = 6.137ms\uff0cp99 = 31.087ms<\/td>\n<\/tr>\n
    jieba \u5168\u6587\u7d22\u5f15\u6784\u5efa<\/td>\n1.85 \u79d2<\/td>\n<\/tr>\n
    \u4e2d\u6587\u5168\u6587\u67e5\u8be2<\/td>\np50 = 2.122ms\uff0cp95 = 2.277ms<\/td>\n<\/tr>\n
    \u78c1\u76d8\u5360\u7528<\/td>\n172 MB<\/td>\n<\/tr>\n
    \u8fdb\u7a0b\u5cf0\u503c RSS<\/td>\n\u7ea6 0.55 GB<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \u8fd9\u4e2a\u6570\u5b57\u8981\u6b63\u786e\u7406\u89e3\u30021.88 \u6beb\u79d2\u662f\u8fdb\u7a0b\u5185<\/strong>\u7684\u5ef6\u8fdf\uff0c\u6ca1\u6709\u7f51\u7edc\u5f80\u8fd4\u3002\u5b98\u65b9\u5ba3\u4f20\u7684\u300c8000+ QPS\u300d\u6211\u6ca1\u590d\u73b0\u2014\u2014\u90a3\u662f 16 \u6838 64G \u7684 Linux \u673a\u5668\u8dd1 Cohere 1000 \u4e07\u6761\u6570\u636e\u96c6\u7684\u7ed3\u679c\uff0c\u8ddf\u6211\u7684\u6d4b\u8bd5\u5b8c\u5168\u4e0d\u662f\u4e00\u56de\u4e8b\uff0c\u4e0d\u5177\u5907\u53ef\u6bd4\u6027\u3002<\/p>\n
    \u4f46\u5373\u4fbf\u5982\u6b64\uff0c\u6211\u8fd9\u4e2a 5 \u4e07\u6761\u7684\u91cf\u7ea7\uff0c\u7b14\u8bb0\u672c\u4e0a 172MB \u5185\u5b58 1.9 \u6beb\u79d2\u4e2d\u4f4d\u6570\uff0c\u8fd9\u4e2a\u4f53\u611f\u5df2\u7ecf\u975e\u5e38\u8212\u670d\u4e86\u3002<\/p>\n
    \u7b2c\u4e8c\u7ec4\uff1a\u4e2d\u6587\u5168\u6587\u68c0\u7d22\uff0c\u8fd9\u4e2a\u662f\u6211\u60ca\u559c\u7684\u5730\u65b9<\/h3>\n
    v0.8.0 \u6700\u5927\u7684\u6539\u52a8\u5c31\u662f\u5185\u7f6e\u4e86 Jieba \u8bcd\u5178\u548c HMM \u6a21\u578b\u3002\u6211\u5efa\u4e86\u4e2a\u5168\u6587\u7d22\u5f15\uff0c\u4e2d\u6587\u76f4\u63a5\u5206\u8bcd\uff1a<\/p>\n
    collection.create_index(\n    "title",\n    zvec.FtsIndexParam(tokenizer_name="jieba"),\n    zvec.IndexOption(),\n)\n\nresults = collection.query(\n    zvec.Query(field_name="title", fts=zvec.Fts(match_string="\u5411\u91cf")),\n    topk=10,\n)\n# [('d1', '\u5411\u91cf\u6570\u636e\u5e93\u9009\u578b\u624b\u8bb0')]\n<\/code><\/pre>\n
    \u6211\u5efa\u4e86 4 \u6761\u6d4b\u8bd5\u6587\u6863\u5206\u522b\u542b\u300c\u5411\u91cf\u6570\u636e\u5e93\u9009\u578b\u624b\u8bb0\u300d\u300c\u5927\u6a21\u578b\u63a8\u7406\u52a0\u901f\u5b9e\u8df5\u300d\u300c\u676d\u5dde\u5468\u672b\u81ea\u9a7e\u8def\u7ebf\u300d\u300c\u68c0\u7d22\u589e\u5f3a\u751f\u6210\u600e\u4e48\u505a\u300d\uff0c\u641c\u300c\u5411\u91cf\u300d\u53ea\u547d\u4e2d\u7b2c\u4e00\u6761\uff0c\u641c\u300c\u5927\u6a21\u578b\u300d\u53ea\u547d\u4e2d\u7b2c\u4e8c\u6761\uff0c\u641c\u300c\u68c0\u7d22\u300d\u53ea\u547d\u4e2d\u7b2c\u56db\u6761\u3002\u5206\u8bcd\u51c6\u786e\uff0c\u6ca1\u6709\u4e71\u53ec\u56de\u3002<\/p>\n
    \u8fd9\u5bf9\u4e2d\u6587\u7528\u6237\u662f\u51b3\u5b9a\u6027\u7684<\/strong>\u3002\u5e02\u9762\u4e0a\u5f88\u591a\u5d4c\u5165\u5411\u91cf\u5e93\u5f97\u5916\u6302\u5206\u8bcd\u5668\uff0c\u8fd8\u8981\u5904\u7406\u8bcd\u5178\u8def\u5f84\uff0c\u914d\u7f6e\u4e00\u591a\u5c31\u5bb9\u6613\u5728\u90e8\u7f72\u73af\u5883\u91cc\u627e\u4e0d\u5230\u6587\u4ef6\u3002zvec \u76f4\u63a5\u628a\u8bcd\u5178\u585e\u8fdb\u4e8c\u8fdb\u5236\u91cc\uff0c\u8fd9\u662f\u7701\u5fc3\u7684\u505a\u6cd5\u3002<\/p>\n
    \u7b2c\u4e09\u7ec4\uff1a\u7ed3\u6784\u5316\u8fc7\u6ee4\u4e0e\u6df7\u5408\u68c0\u7d22\uff0c\u8fd9\u4e24\u4e2a\u771f\u80fd\u7528<\/h3>\n
    \u6807\u91cf\u8fc7\u6ee4\u662f\u76f4\u63a5\u4f20\u5b57\u7b26\u4e32\u8868\u8fbe\u5f0f\uff0c\u4e0d\u662f\u62fc SQL\uff1a<\/p>\n
    results = collection.query(\n    zvec.Query(field_name="embedding", vector=[3.0, 0.1, 0.2, 0.3]),\n    topk=10,\n    filter="tag = '\u6280\u672f'",\n    output_fields=["title", "tag"],\n)\n<\/code><\/pre>\n
    \u6df7\u5408\u68c0\u7d22\u6211\u4e00\u5f00\u59cb\u76f4\u63a5\u8e29\u4e86\u5751\u2014\u2014\u540c\u65f6\u4f20\u5411\u91cf\u67e5\u8be2\u548c\u5168\u6587\u67e5\u8be2\u4f1a\u76f4\u63a5\u629b\u5f02\u5e38<\/strong>\uff1a<\/p>\n
    ValueError: A reranker is required to merge results from multiple queries;\nspecify the 'reranker' argument.\n<\/code><\/pre>\n
    \u5b83\u4e0d\u8ba9\u4eba\u81ea\u5df1\u778e\u5408\u5e76\u7ed3\u679c\u96c6\uff0c\u800c\u662f\u5f3a\u5236\u6307\u5b9a\u4e00\u4e2a\u878d\u5408\u7b56\u7565\u3002\u8fd9\u4e2a\u8bbe\u8ba1\u6211\u89c9\u5f97\u662f\u5bf9\u7684\u2014\u2014\u4e0d\u6307\u5b9a\u5c31\u8bf4\u660e\u5176\u5b9e\u6ca1\u60f3\u6e05\u695a\u8981\u4ec0\u4e48\u3002\u4e24\u79cd\u6211\u90fd\u8bd5\u4e86\uff1a<\/p>\n
    # RRF\uff1a\u53ea\u770b\u6392\u540d\uff0c\u4e0d\u770b\u5206\u6570\ncollection.query(\n    [zvec.Query(field_name="embedding", vector=[3.0, 0.1, 0.2, 0.3]),\n     zvec.Query(field_name="title", fts=zvec.Fts(match_string="\u68c0\u7d22"))],\n    topk=10,\n    reranker=zvec.RrfReRanker(rank_constant=60),\n)\n# \u2192 d4: 0.032, d1: 0.0164, d2: 0.0161\n\n# \u52a0\u6743\uff1a\u76f4\u63a5\u7ed9\u4e24\u8def\u5206\u6743\u91cd\ncollection.query(\n    [zvec.Query(field_name="embedding", vector=[3.0, 0.1, 0.2, 0.3]),\n     zvec.Query(field_name="title", fts=zvec.Fts(match_string="\u68c0\u7d22"))],\n    topk=10,\n    reranker=zvec.WeightedReRanker([0.7, 0.3]),\n)\n# \u2192 d4: 0.8317, d2\/d1\/d3: 0.664\n<\/code><\/pre>\n
    RRF \u7684\u5206\u6570\u770b\u8d77\u6765\u5f88\u5c0f\uff080.032 \u8fd9\u79cd\uff09\uff0c\u90a3\u662f\u56e0\u4e3a\u5b83\u7684\u516c\u5f0f\u662f 1\/(k+r+1)<\/code>\uff0c\u672c\u6765\u5c31\u662f\u6392\u540d\u5012\u6570\uff0c\u4e0d\u662f\u76f8\u4f3c\u5ea6\uff0c\u522b\u62ff\u53bb\u548c\u522b\u7684\u5e93\u6bd4\u3002<\/p>\n
    \u7b2c\u56db\u7ec4\uff1a\u7a00\u758f\u5411\u91cf\uff0c\u80fd\u7528\uff0c\u4f46\u6211\u7528\u5f97\u5c11<\/h3>\n
    \u7a00\u758f\u5411\u91cf\uff08SPARSE_VECTOR_FP32<\/code>\uff09\u6211\u5efa\u4e86\u4e2a\u4e24\u5b57\u6bb5\u7684\u96c6\u5408\u63d2\u8fdb\u53bb\u67e5\u4e86\uff0c\u6b63\u5e38\u8fd4\u56de\uff1a<\/p>\n
    vectors=[\n    zvec.VectorSchema("embedding", zvec.DataType.VECTOR_FP32, 4),\n    zvec.VectorSchema("sparse", zvec.DataType.SPARSE_VECTOR_FP32),\n]\n# \u63d2\u5165 {1: 0.5, 5: 0.3} \u540e\u67e5\u8be2 \u2192 [('a', 0.34)]\n<\/code><\/pre>\n
    \u4f46\u8bf4\u5b9e\u8bdd\uff0c\u6211\u65e5\u5e38\u7528\u4e0d\u4e0a\u7a00\u758f\u5411\u91cf\u3002\u5b83\u66f4\u50cf\u662f\u4e00\u4e2a\u300c\u80fd\u529b\u9f50\u5168\u300d\u7684\u5b58\u5728\u2014\u2014BM25\u3001Sparse\u3001Dense \u4e09\u79cd\u53ec\u56de\u8def\u5f84\u90fd\u5728\u4e00\u4e2a\u5e93\u91cc\uff0c\u662f\u4e3a\u4e86\u505a\u6df7\u5408\u68c0\u7d22\u65f6\u4e0d\u7528\u518d\u5f15\u7b2c\u4e09\u65b9\u5e93\u3002\u5982\u679c\u573a\u666f\u662f\u7eaf\u8bed\u4e49\u68c0\u7d22\uff0c\u8fd9\u90e8\u5206\u529f\u80fd\u5c31\u662f\u7eaf\u7cb9\u7684\u91cd\u91cf\u3002<\/p>\n
    \u54ea\u4e9b\u662f\u5671\u5934<\/h3>\n
    \u5206\u5e03\u5f0f\u662f\u5f7b\u5e95\u7684\u5671\u5934\u2014\u2014\u5b83\u6839\u672c\u6ca1\u6709\u3002<\/strong> README \u91cc\u6ca1\u6709\u96c6\u7fa4\u3001\u6ca1\u6709\u5206\u7247\u3001\u6ca1\u6709\u526f\u672c\uff0c\u4efb\u4f55\u5173\u4e8e\u300c\u6a2a\u5411\u6269\u5c55\u300d\u7684\u671f\u5f85\u90fd\u53ef\u4ee5\u653e\u4e0b\u3002<\/p>\n
    \u5b98\u65b9 benchmark \u9875\u9762\u7528\u7684\u673a\u5668\u662f g9i.4xlarge<\/code>\uff0816 vCPU \/ 64 GiB RAM\uff09\uff0c\u8dd1 Cohere 1000 \u4e07\u6761 768 \u7ef4\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u5b98\u65b9\u6570\u5b57\u5168\u90e8\u6765\u81ea\u5355\u673a<\/strong>\u3002\u8fd9\u4e0d\u662f\u7f3a\u70b9\uff0c\u4f46\u5b83\u5212\u6e05\u4e86\u8fb9\u754c\uff1azvec \u7684\u6240\u6709\u6027\u80fd\u6545\u4e8b\u90fd\u5728\u4e00\u4e2a\u8fdb\u7a0b\u5185\u6210\u7acb\u3002<\/p>\n
    \u5b83\u4e3a\u4ec0\u4e48\u8fd9\u4e48\u8bbe\u8ba1\uff0c\u4ee3\u4ef7\u5728\u54ea<\/h2>\n
    \u6838\u5fc3\u8bbe\u8ba1\u5c31\u4e00\u53e5\u8bdd\uff1a\u7528\u6587\u4ef6\u9501\u6362\u6389\u5206\u5e03\u5f0f<\/strong>\u3002<\/p>\n
    \u6211\u5728\u6e90\u7801\u5c42\u9762\u786e\u8ba4\u4e86\u5b83\u7684\u5e76\u53d1\u6a21\u578b\u3002\u96c6\u5408\u76ee\u5f55\u91cc\u4f1a\u751f\u6210\u4e00\u4e2a LOCK<\/code> \u6587\u4ef6\uff0c\u6253\u5f00\u96c6\u5408\u65f6\u5fc5\u987b\u5148\u62ff\u5230\u8fd9\u4e2a\u9501\u3002\u6211\u5b9e\u6d4b\u4e86\u56db\u79cd\u5e76\u53d1\u573a\u666f\uff1a<\/p>\n
    \u573a\u666f1: \u65e0\u8fdb\u7a0b\u6301\u9501\uff0c3 \u4e2a\u53ea\u8bfb\u8fdb\u7a0b\u5e76\u53d1    \u2192 \u5168\u90e8\u6210\u529f\n\u573a\u666f2: \u5199\u8fdb\u7a0b\u6301\u9501\uff0c2 \u4e2a\u53ea\u8bfb\u8fdb\u7a0b\u5e76\u53d1    \u2192 \u5168\u90e8\u5931\u8d25\n\u573a\u666f3: \u540c\u8fdb\u7a0b\u5185 read_only \u6253\u5f00         \u2192 \u6210\u529f\n\u573a\u666f4: \u5199\u8fdb\u7a0b\u6301\u9501\uff0c\u53e6\u8d77\u5199\u8fdb\u7a0b          \u2192 \u5931\u8d25\n<\/code><\/pre>\n
    \u5931\u8d25\u65f6\u7684\u62a5\u9519\u5f88\u76f4\u767d\uff1a<\/p>\n
    RuntimeError: Can't lock read-only collection: ...\/LOCK\n<\/code><\/pre>\n
    \u8fd9\u4e2a\u7ed3\u679c\u548c README \u7684\u63cf\u8ff0\u5bf9\u4e0d\u4e0a\u3002<\/strong> README \u7684\u529f\u80fd\u5217\u8868\u91cc\u5199\u7740\u300cConcurrent Access: Multiple processes can read the same collection simultaneously; writes are single-process exclusive\u300d\u2014\u2014\u6309\u5b57\u9762\u7406\u89e3\u662f\u300c\u591a\u8bfb\u5355\u5199\u300d\u90fd\u80fd\u8dd1\u3002\u4f46\u6211\u5b9e\u6d4b\u7684\u573a\u666f 2 \u8bf4\u660e\uff1a\u53ea\u8981\u6709\u5199\u8fdb\u7a0b\u6301\u9501\uff0c\u5176\u4ed6\u8fdb\u7a0b\u7684\u53ea\u8bfb\u6253\u5f00\u5c31\u76f4\u63a5\u5931\u8d25\u3002<\/p>\n
    \u6211\u4e00\u5f00\u59cb\u4ee5\u4e3a\u81ea\u5df1\u7406\u89e3\u9519\u4e86\uff0c\u53bb\u7ffb\u4e86 issue\u3002#586 \u5c31\u662f\u6709\u4eba\u95ee\u540c\u4e00\u4ef6\u4e8b\uff0c\u4f5c\u8005\u5728 2026-07-10 \u63d0\u7684\uff0c\u6807\u9898\u662f\u300c\u672a\u6765\u662f\u5426\u4f1a\u652f\u6301\u5355\u5199\u591a\u8bfb\uff08\u4e00\u4e2a\u5199\u8fdb\u7a0b + \u591a\u4e2a\u53ea\u8bfb\u8fdb\u7a0b\uff09\u300d\uff0c\u5230\u4eca\u5929\u4ecd\u662f open \u72b6\u6001\u3002<\/p>\n
    \u6240\u4ee5\u51c6\u786e\u7684\u8868\u8ff0\u5e94\u8be5\u662f\uff1a\u591a\u4e2a\u53ea\u8bfb\u8fdb\u7a0b\u53ef\u4ee5\u5e76\u53d1\u8bfb\uff1b\u4e00\u65e6\u6709\u8fdb\u7a0b\u5728\u5199\uff0c\u5176\u4ed6\u8fdb\u7a0b\u5c31\u8fde\u8bfb\u90fd\u8fdb\u4e0d\u53bb<\/strong>\u3002<\/p>\n
    \u8fd9\u4e2a\u4ee3\u4ef7\u5728\u4ec0\u4e48\u60c5\u51b5\u4e0b\u4e0d\u53ef\u63a5\u53d7\uff1f\u5f88\u660e\u786e\uff1a<\/p>\n