Download app/core/session/session_store.py from bg5/zai: direct link, hf CLI and curl.
- Browser
- Download file 3.12 kB
-
https://huggingface.co/spaces/bg5/zai/resolve/main/app/core/session/session_store.py
- Command line
-
hf download hf://spaces/bg5/zai/app/core/session/session_store.py
-
curl -L -o session_store.py https://huggingface.co/spaces/bg5/zai/resolve/main/app/core/session/session_store.py
3.12 kB
| #!/usr/bin/env python | |
| # -*- coding: utf-8 -*- | |
| """轻量级内存会话存储(支持 TTL 自动过期)。 | |
| 设计原则: | |
| - 无外部依赖(纯 Python,stdlib 仅需 dict + asyncio) | |
| - 惰性过期:访问时检查 TTL,周期性后台清理 | |
| - 线程安全:通过 asyncio.Lock 保护共享状态 | |
| """ | |
| import asyncio | |
| import time | |
| from typing import Any, Dict, List, Optional, Tuple | |
| from app.utils.logger import logger | |
| class SessionStore: | |
| """基于内存的 KV 存储,支持 TTL 过期。 | |
| 存储格式: | |
| - Key: 字符串(如 "session:{fp}:{chat_id}" 或 "fp_index:{fp}") | |
| - Value: 任意可序列化 dict | |
| - TTL: 过期秒数,0 表示永不过期 | |
| """ | |
| def __init__(self) -> None: | |
| # {key: (value, expire_at)} expire_at=0 表示永不过期 | |
| self._data: Dict[str, Tuple[Any, float]] = {} | |
| self._lock = asyncio.Lock() | |
| async def get(self, key: str) -> Optional[Dict[str, Any]]: | |
| """获取 key 对应值,已过期返回 None。""" | |
| async with self._lock: | |
| entry = self._data.get(key) | |
| if entry is None: | |
| return None | |
| value, expire_at = entry | |
| if expire_at and time.monotonic() > expire_at: | |
| del self._data[key] | |
| return None | |
| return value | |
| async def set(self, key: str, value: Dict[str, Any], ttl: int = 3600) -> None: | |
| """设置 key 的值,ttl 秒后过期(ttl=0 永不过期)。""" | |
| expire_at = (time.monotonic() + ttl) if ttl > 0 else 0.0 | |
| async with self._lock: | |
| self._data[key] = (value, expire_at) | |
| async def delete(self, key: str) -> None: | |
| """删除指定 key。""" | |
| async with self._lock: | |
| self._data.pop(key, None) | |
| async def exists(self, key: str) -> bool: | |
| """检查 key 是否存在且未过期。""" | |
| return await self.get(key) is not None | |
| async def keys(self, prefix: str = "") -> List[str]: | |
| """返回所有匹配前缀的未过期 key 列表。""" | |
| now = time.monotonic() | |
| async with self._lock: | |
| result = [] | |
| # 顺便清理已过期的 key | |
| expired = [] | |
| for k, (_, expire_at) in self._data.items(): | |
| if expire_at and now > expire_at: | |
| expired.append(k) | |
| elif not prefix or k.startswith(prefix): | |
| result.append(k) | |
| for k in expired: | |
| del self._data[k] | |
| return result | |
| async def cleanup_expired(self) -> int: | |
| """主动清理所有过期条目,返回清理数量。""" | |
| now = time.monotonic() | |
| async with self._lock: | |
| expired = [k for k, (_, exp) in self._data.items() if exp and now > exp] | |
| for k in expired: | |
| del self._data[k] | |
| return len(expired) | |
| def size(self) -> int: | |
| """返回当前存储条目数(含已过期但未清理的)。""" | |
| return len(self._data) | |