本指南介绍如何使用本地文件系统 键值存储。关于 LocalFileStore 的完整功能与配置，请参阅 API 参考。

​
Overview

LocalFileStore 是持久化的 ByteStore 实现，会将全部数据存放在指定文件夹下，适用于单机场景且可接受文件增删的需求。

​
Integration details

ClassPackageLocalJS supportDownloadsVersion
LocalFileStorelangchain✅✅PyPI - DownloadsPyPI - Version

​
安装

该集成位于 langchain 包： 
pip install -qU langchain-classic

​
实例化

实例化 ByteStore： 
from pathlib import Path

from langchain_classic.storage import LocalFileStore

root_path = Path.cwd() / "data"  # can also be a path set by a string

kv_store = LocalFileStore(root_path)

​
用法

使用 mset 写入： 
kv_store.mset(
    [
        ["key1", b"value1"],
        ["key2", b"value2"],
    ]
)

kv_store.mget(
    [
        "key1",
        "key2",
    ]
)

[b'value1', b'value2']
可在 data 目录中看到创建的文件： 
!ls {root_path}

key1 key2
使用 mdelete 删除： 
kv_store.mdelete(
    [
        "key1",
        "key2",
    ]
)

kv_store.mget(
    [
        "key1",
        "key2",
    ]
)

[None, None]

​
API 参考

更多 LocalFileStore 细节请参阅 API 参考。
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.