Files
NebulaShell/store/@{FutureOSS}/plugin-storage/README.md
Falck 76147bae94 初始提交 - FutureOSS v1.0 插件化运行时框架
一切皆为插件的开发者工具运行时框架

🧩 核心特性:
  - 插件热插拔 (importlib 动态加载)
  - 依赖自动解析 (拓扑排序 + 循环检测)
  - 企业级稳定 (熔断/降级/重试/隔离)
  - 事件驱动 (发布/订阅事件总线)
  - 完整配置 (YAML 配置 + 热重载)
2026-04-06 09:57:10 +08:00

1.4 KiB

plugin-storage 插件存储

为所有插件提供隔离的键值存储服务。

功能

  • 隔离存储:每个插件有独立的命名空间
  • 持久化:数据自动保存到 JSON 文件
  • 线程安全:支持并发访问
  • 共享访问:通过 plugin-bridge 可跨插件访问

基本使用

storage_plugin = plugin_mgr.get("plugin-storage")

# 获取插件的隔离存储
storage = storage_plugin.get_storage("my-plugin")

# 设置值
storage.set("key", "value")
storage.set("config", {"theme": "dark", "lang": "zh"})

# 获取值
value = storage.get("key")
config = storage.get("config", default={})

# 检查键
if storage.has("key"):
    print("存在")

# 删除
storage.delete("key")

# 批量设置
storage.set_many({"a": 1, "b": 2, "c": 3})

# 获取所有数据
all_data = storage.get_all()

# 清空
storage.clear()

通过 plugin-bridge 访问

bridge = plugin_mgr.get("plugin-bridge")
shared_storage = bridge.storage  # 假设 bridge 集成了 storage

# 获取其他插件的存储(需要权限)
other_storage = shared_storage.get_plugin_storage("other-plugin")
data = other_storage.get("some_key")

存储位置

./data/storage/
├── plugin-a/
│   └── data.json
├── plugin-b/
│   └── data.json
└── ...

元信息

meta = storage.get_meta()
# {"plugin": "my-plugin", "keys": 5, "path": "./data/storage/my-plugin"}