Skip to content

SGME v1.0.0b1(beta)— 拾光记忆引擎

Latest

Choose a tag to compare

@freehul freehul released this 14 Aug 08:20
· 4 commits to main since this release

SGME v1.0.0b1(beta)— 拾光记忆引擎

给 AI 装上长期记忆——它记得你们聊过的每一件事,还会主动关心你。

首个公开测试版。单用户 Agent 记忆引擎 Server:把 Agent 会话提炼为标签化记忆,按场景注入画像,让 AI 不再失忆。

一句话

你的 AI,从此记得你——跨设备、跨 AI,一个不丢的记忆中枢,还会主动关心你。

核心能力

  • 主动关怀(Care Engine):情绪洞察、待办提醒、过劳预警、每日问候——Dream 定时扫描产生信号 → SSE 实时推送 → agent 原子认领(谁消费谁标记)→ 关怀用户 → 回执。信号总线 + 三层消费模型 + TTL 归档闭环。
  • 三库记忆引擎:L0 原始文件 → L1 标签化记忆(memory.db)→ L1.5 冲突提炼 → L2 场景(wiki.db),单向数据流,全程可溯源。
  • 角色模板:管家 / 伴侣 / 朋友 / 导师四张预置角色卡(Character Card V2 兼容),换皮不换芯——换角色只改「怎么说话」,记忆池不动。
  • 记忆可溯源:AI 说出的每一句话都能追回原始对话。
  • 多智能体共享记忆:Hermes、Trae、Reasonix、DSH 等所有 AI 共享同一个记忆大脑。
  • 按场景注入:日常闲聊带身份近况,编程带技术栈踩坑,工作带计划进度——零 LLM 成本(纯结构化 SQL 查询)。
  • 多源统一检索:BM25 关键词 + 向量语义 + 标签过滤三重融合,记忆池 + 知识库一站式召回。
  • 中文原生:针对中文检索调优,jieba 分词 + FTS5 + LIKE 兜底。
  • 自托管轻量:单机 Python + SQLite,无 GPU、无外部数据库,数据永远在你手里。

部署形态

  • Windows 服务:NSSM 注册,开机自启 + 崩溃自动重启。
  • Dockerdocker compose up -d --build(Dockerfile + docker-compose.yml + healthcheck)。
  • NAS(群晖):bind mount 数据卷 + env_file 密钥注入,已实测验收。

接入方式

  • HTTP API(:9910)+ MCP(:9913)双协议入口,鉴权同规则(X-API-Key)。
  • 连接即发现:agent 连上后调 agent_onboarding() 自助接入,无需人工配置。
  • 五条接入铁律 + 事件对接(SSE/pull/signal_pull 三接法)+ 通信渠道兜底。

技术栈

Python 3.11 · FastAPI · SQLite(FTS5 + sqlite-vec)· LLM 降级链(deepseek-v4-flash 主链)

测试

  • pytest 全量 1644 passed / 0 failed
  • vitest 65 passed(dsh 适配器)

说明

  • 版本1.0.0b1 beta——公开测试版,接口契约可能调整。
  • 许可证:MIT(© 2026 freehul)
  • 合规:Python 自研实现,仅借鉴 TencentDB-Agent-Memory(MIT)设计思想,未直接引用其代码或提示词。

快速开始

python -m venv .venv
# Windows: .venv\Scripts\activate  /  macOS/Linux: source .venv/bin/activate
pip install -e .[dev]
python -m sgme

详见 README.mddocs/runbook.md