SuperAPI AI 工具集

instance-storage-patterns

智能体与模型

查看项目

更新于 10-16 00:30

技能介绍

用途:该技能用于系统同时运行多个实例或会话、且每个实例需要独立存储、生命周期跟踪和独立目录树的场景,例如任务运行器、用户会话、构建作业;同时处理加载配置、连接 API 等昂贵初始化,使其只发生一次而非每实例一次。

主要能力:采用以实例为根的目录布局,将单个实例的全部数据放在一个目录下,便于查看、打包或整体删除;支持用一个环境变量覆盖所有数据路径,便于测试、Docker 挂载和多租户隔离;按实例加锁,避免全局锁串行化所有写入;实例元数据原子写入,防止并发或中断造成半写状态;用工厂模式把一次性准备与按需创建会话分离;对嵌套状态使用工厂函数返回独立副本,避免共享可变默认值。

使用方式:通过 InstanceStore 提供创建、更新、列出和删除实例的接口;写入时先用 tempfile.mkstemp 创建临时文件,再用 os.replace 原子替换,异常分支捕获 BaseException 并清理临时文件;JSON 序列化使用 ensure_ascii=False 保留非 ASCII 文本,用 default=str 处理 datetime、Path、枚举。

适用场景:Python CLI 工具和 Web 服务等已在生产验证的场景;需要把实例目录整体 tar、rm -rf 或 ls 的运维与测试流程。

限制:按实例锁对象不会清理,每个约 100 字节,实例数量极大时需要 LRU 等淘汰策略;default=str 以牺牲严格类型安全换取不崩溃,只适合内部存储;每次写入都创建目录以容忍清理或测试期间的删除,存在少量重复开销;资料未提供具体安装命令、价格、平台或效果数据。