Memmy架构深度剖析：如何用TypeScript、Electron和SQLite打造Local-First的Agent Runtime-北京尧图网络

Memmy架构深度剖析如何用TypeScript、Electron和SQLite打造Local-First的Agent Runtime【免费下载链接】memmy-agent A personal AI agent local memory hub for all AI agents, gives every AI one shared, fully controlled memory and persistent context — all AI remember the same you. Now supports Claude Code, Codex, OpenClaw and Hermes Agent etc.项目地址: https://gitcode.com/gh_mirrors/me/memmy-agentMemmy 是一个 Local-First 的个人 AI Agent Runtime 与本地记忆中枢Memory Hub。它完全用 TypeScript 构建通过 Electron 提供桌面应用用 SQLite 作为本地持久化底座让 Claude Code、Codex、OpenClaw、Hermes 等所有 AI 共享同一份完全由你控制的持久记忆。本文将从 Monorepo 结构、Memory 服务、桌面壳到 Agent Runtime带你完整剖析这套架构的设计思路。总体架构一个本地记忆底座多个入口Memmy 的核心设计理念是所有 Agent 和入口桌面 App、CLI/TUI、外部 Agent 适配器都共享同一个本地 Memory 服务和 Agent Runtime数据不离开本机。整体分为四层层说明关键目录桌面端Electron 壳 React 前端App/shell/desktop、App/frontend/desktop本地后端Fastify 路由 SQLite 应用状态App/backend记忆底座Memory 服务默认:18960Memory/Agent Runtime消息循环、工具、MCP、渠道、技能App/memmy-agent核心概念速览可见官方文档 docs/cn/concepts/architecture.mdx。Monorepo 组织9 个 Workspace 各司其职项目根目录通过 npm workspaces 组织了整个工程结构如下定义在 package.jsonMemory/— 记忆服务本体memmy/memory含服务端、CLI、存储、检索、演化算法App/backend— 桌面端本地 API 后端Fastify SQLiteApp/shell/desktop— Electron 主进程壳App/frontend/*— React Vite 桌面渲染层App/memmy-agent— Agent Runtime模型调用、工具、MCP、渠道接入、TUIAgentSourceCore/、Knowledge/、Migrations/— Agent 来源扫描、知识库、运行时配置迁移这种分层让每个模块可以独立构建和测试构建顺序由脚本串联如memory:build→workspace:build版本则通过 scripts/sync-project-version.mjs 统一同步。Memory 服务SQLite 是 Local-First 的基石Memmy 的记忆底座是一个绑定127.0.0.1的本地 HTTP 服务入口在 Memory/src/server/index.ts默认监听:18960。存储层有两个亮点单一 SQLite 文件搞定全部持久化基于better-sqlite3开启 WAL 模式与 5 秒 busy_timeout见 Memory/src/storage/db.ts迁移前自动执行VACUUM INTO生成备份升级零数据丢失。FTS5 全文检索 sqlite-vec 原生向量检索双通道在 Memory/src/storage/backend.ts 中声明了fullText: fts5与vector: native关键词搜索和语义搜索跑在同一个数据库里无需额外向量库。可插拔后端同一套StorageBackend接口下同时实现了sqlite-local和openmem-cloud-rest两种后端本地优先但架构上为云端同步留好了扩展位。服务启动时还包含用户级锁acquireUserServiceLock与 SQLite 文件锁保证同一时刻只有一个服务实例运行这对 Local-First 场景的并发安全至关重要。桌面端Electron 壳 React 前端桌面应用由两部分组成Electron 主进程App/shell/desktop/package.json 中使用 Electron 38 与 electron-builder 打包主进程负责拉起 Memory 服务、管理本地 Runtime、处理屏幕采集等系统能力。React 渲染层App/frontend/desktop基于 Vite 构建页面、状态、i18n 按pages/、state/、i18n/组织通过api/目录调用本地后端。后端 App/backend/package.json 则使用 Fastify 暴露本地 API配合 SQLite 的 app-state-store含 30 余个 SQL 迁移文件持久化应用状态并内置权限管理permission/permission-manager.ts保证桌面端所有敏感操作都经过本地授权。Agent RuntimeMemmy 自己也是 AgentApp/memmy-agent是项目的大脑描述为 TypeScript refactor of memmys agent runtime。它具备完整的 Agent 能力多模型 ProviderOpenAI、Anthropic、AWS Bedrock、本地模型等支持 BYOKMCP 集成通过modelcontextprotocol/sdk接入工具生态多渠道接入Telegram、Slack、Discord、飞书、钉钉、微信等TUI 交互基于 Ink/React 的终端界面支持斜杠命令菜单运行入口 App/memmy-agent/src/main.ts 提供memmy agent、memmy serveOpenAI 兼容 API:18990等命令Linux 下通过 systemd 用户服务常驻memmy-memory.service/memmy-gateway.service。跨 Agent 记忆架构的最终形态Memmy 最有价值的架构产出是跨 Agent 任务连续性——用 AgentSourceCore/ 中的读取适配器解析 Codex、Claude Code、Cursor 等各 Agent 的本地会话文件把散落在各处的历史统一汇入同一份 SQLite 记忆库实现所有 AI 记住同一个你。数据始终留在本地关键源码路径速查模块路径Memory 服务入口Memory/src/server/index.ts存储后端抽象Memory/src/storage/backend.tsSQLite 连接与迁移备份Memory/src/storage/db.ts本地后端FastifyApp/backend/src/index.tsElectron 壳App/shell/desktop/Agent RuntimeApp/memmy-agent/src/架构文档docs/cn/concepts/architecture.mdx总结Memmy 的架构可以概括为三点TypeScript 全栈统一从 Memory 服务、Fastify 后端到 Electron 主进程与 React 前端同一语言贯穿所有层类型契约local-api-contracts跨层共享SQLite 即数据库、向量库、全文索引better-sqlite3 FTS5 sqlite-vec 让 Local-First 不需要任何额外基础设施Electron 只负责体验Memory 才是核心Memory 服务可脱离桌面端独立运行memmy-memoryCLI systemd 服务Agent、脚本、CLI 都能接入同一份本地记忆。这就是一个 Local-First Agent Runtime 的完整答案把记忆做成独立、可移植、本地可控的基础设施让所有 AI 工具围绕它协作。【免费下载链接】memmy-agent A personal AI agent local memory hub for all AI agents, gives every AI one shared, fully controlled memory and persistent context — all AI remember the same you. Now supports Claude Code, Codex, OpenClaw and Hermes Agent etc.项目地址: https://gitcode.com/gh_mirrors/me/memmy-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Memmy架构深度剖析：如何用TypeScript、Electron和SQLite打造Local-First的Agent Runtime

相关推荐

论文结构像一团乱麻？博导推荐这几个AI论文写作软件

闲置二手交易平台怎么分账才能合规稳定？技术实现与风控体系全解析

硬核盘点｜2026年最流行AI论文平台榜单，免费版也能写合规初稿

更多资讯

工业电源路径保护：eFuse与TVS阵列协同设计实战

银河麒麟离线安装QGis：依赖闭环与批量部署实战

Kettle实战：学生成绩导入清洗与排名自动化全流程解析

Grok Bot：轻量级数字员工的落地实践与架构设计

Hoppscotch自部署实战：Docker Compose与源码安装详解

华为云AgentArts实战：信贷预审智能体从搭建到调优全链路

今日更新

Agent Skills 完全指南：原理、写法、安装与实战避坑

Agent Skills 实战：从 Genkit 定义到 GKE 部署与排查

Agent Skills 实战：从设计到调试的完整指南

本周精选

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？