MemoCat 图标 MemoCat v0.5.0
纯本机离线架构 · macOS 桌面应用 + Chrome 浏览器扩展

把散落在各处的 AI 对话,
整理为本机可检索、可召回的记忆工作台

MemoCat 在本机统一归档 Codex、Claude Code、Grok Bot、Antigravity 的本地日志与 9 大网页 AI 平台的对话记录,存入单机 SQLite 数据库;支持双栏阅读、全文检索与 127.0.0.1:3792 HTTP MCP 跨工具记忆召回。

4 类本机 AI 日志只读导入 9 大网页 AI 扩展采集 HTTP MCP 跨会话召回 无账号 · 无云端 · 无遥测
MemoCat 会话工作台浅色模式界面
会话工作台(浅色):左栏来源胶囊筛选与 ⌘K 全文检索,右栏结构化左右聊天气泡与代码复制。 实际运行截图 · MemoCat v0.5.0

双端输入:本机 AI 工具日志与网页端对话

桌面端以只读方式解析本机客户端会话日志;浏览器扩展在用户授权的 AI 网页端采集已加载对话,并通过本机回环通道增量同步到同一资料库。

本机终端与桌面 AI 日志

逐行流式读取,不回写或修改原始日志文件

4 个适配器
Codex
Codex ~/.codex
Claude Code
Claude Code ~/.claude/projects
Grok Bot
Grok Bot ~/Library/.../Grok Bot
Antigravity
Antigravity ~/.gemini/antigravity
  • 沙盒只读目录授权:桌面版使用 macOS 原生目录选择器与 Security-Scoped Bookmarks 持久化授权,支持选取隐藏目录。
  • 大日志流式解析:按行读取 JSONL 与 `.blob` 副本,取消 64MB 单文件限制;读取前后校验文件标识、大小与修改时间,遇到半截写入或损坏行时保留上次成功版本。
  • 附件与图片本地缓存:提取内嵌 base64 及本地引用图片(PNG/JPEG/GIF/WebP,单张上限 32MB)按哈希缓存在本机,支持点击放大查看。
  • 可调定时同步:支持配置 1–1440 分钟定时检查(默认 5 分钟),多份副本日志自动合并去重,不重复计入今日增量。

浏览器扩展(Manifest V3)

在支持的 AI 对话页面内嵌保存胶囊与侧边抽屉

9 大网页平台
ChatGPTChatGPT
ClaudeClaude
GeminiGemini
DeepSeekDeepSeek
腾讯元宝腾讯元宝
豆包豆包
KimiKimi
千问千问
GrokGrok
  • 局部窗口增量合并:采用 `MemoCore.reconcile` 策略按稳定消息 ID 与精确文本游标合并更新,网页虚拟列表卸载早期 DOM 节点时不会丢失已保存记录。
  • 三端扩展界面:包含页面悬浮按钮与右侧抽屉栏、工具栏弹出面板,以及独立全屏资料工作台(支持修改标题、重新采集、来源链接回跳)。
  • 独立备份与恢复:数据存储在浏览器 IndexedDB(`unlimitedStorage`),支持单会话 Markdown/JSON 导出与全库增量合并导入。
  • 可靠本机交接:通过 `127.0.0.1` 自动配对并下发 256 位随机连接密钥;待同步队列采用单调序号与 `changeId` CAS 确认,防止乱序覆盖或删除状态丢失。

结构化阅读、混合召回与可审计交付

后端仅使用 Node.js 24 内置模块与 node:sqlite,桌面端和本机网页版共享同一套检索、去重与权限校验核心。

双栏会话工作台

按时间线与来源快速筛选会话,右栏采用用户靠右、AI 靠左的气泡布局,自动合并同一回合的连续工具回复段。

  • 检索快捷键:⌘K 标题、正文与代码关键词
  • 键盘快速切换:↑ / ↓ 列表导航与右侧提问目录条
  • 复用与导出:一键「复制为 Prompt」XML 上下文、Markdown 或 .md 文件
  • 窗口自适应:< 600px 窄屏(1/4 屏)自动切换底部标签栏

混合检索与区域预算

内置 SQLite WAL 与 FTS5 trigram 索引,同时结合面向对话回合结构的 BM25 邻域平滑算法,把召回片段控制在可用上下文预算内。

  • 分词策略:CJK Bigram 与英文/数字词元混合切分
  • 权重配比:用户提问 2.5 / AI 回复 1.0;主查询 1.0 / 补充词 0.72
  • 区域扩展:5 邻域平滑核扩展高相关上下文并合并重叠区间
  • 输出上限:每次最多 8 个区域、累计约 9,600 token

上下文去重与交付审计

通过会话上下文标识与交付状态机记录每次召回,避免同一 AI 对话反复读入相同片段,并保留完整的取用审计记录。

  • 会话隔离:首次召回签发 process_id 并绑定调用方(caller)
  • 三态交付:prepared / committed / abandoned 状态追踪
  • 完整去重:已成功返回的完整单元不重复返回;截断片段允许补全
  • 审计快照:在「MCP 取用审计流」中回溯当时交付的原文

本机 Streamable HTTP MCP 服务端点

桌面端或网页模式运行时默认监听 http://127.0.0.1:3792,通过无状态 JSON-RPC 2.0 POST 为各本地 AI 工具提供受控记忆检索,按客户端独立配置开关与允许读取的来源白名单。

recall 核心召回工具

接受主查询 query、最多 8 条同义/跨语言补充词 alternatives、日期范围 from/to、来源过滤与续传 process_id。触发前自动按需同步已开启来源,返回附带来源路径与时间的分段上下文。

list_conversations 日期清单工具

按主机所在时区列出指定起止日期(含首尾最多 31 天)内的历史会话元数据清单,受当前客户端的资料来源白名单约束。

独立白名单与策略检查 客户端隔离

/mcp/codex、/mcp/claude-code 与 /mcp/other-local 拥有各自独立的启用开关和资料范围。未选定任何来源时拒绝取用;配置在检索途中变化时自动中止当前交付。

[mcp_servers.memocat]
url = "http://127.0.0.1:3792/mcp/codex"
目标文件:~/.codex/config.toml · 在「数据管道」可一键复制并测试握手

本机闭环安全设计与已知边界

所有解析、存储与检索都在你的设备本地完成。下面列出实际实现的安全机制与当前版本的工程边界。

零云端服务器与零遥测

不设云端账号,不上传聊天内容或文件路径,不包含统计、广告或崩溃上报 SDK(Mac App Store 隐私清单声明 NSPrivacyTracking = false)。

严格的本机回环校验

HTTP 服务仅绑定 127.0.0.1,校验 Host、Origin 与 Sec-Fetch-Site;浏览器扩展同步接口仅对配对的 32 位扩展 ID 与 256 位随机 Bearer 密钥开放。

沙盒隔离与内容清洗

Electron 启用 contextIsolation 与 sandbox;浏览器扩展严格限制 script-src 'self';Markdown 渲染经过 DOMPurify 过滤,禁止不安全标签与内联样式。

独立数据目录与随时清除

本机网页模式默认保存于 ~/.memocat/<用户ID>/memo.sqlite(支持 MEMO_DATA_DIR 覆盖),桌面端保存于应用沙盒数据目录,可随时复制备份或整目录移除。

当前实现边界说明(v0.5.0)

  • 本地 memo.sqlite 与扩展导出的 JSON 备份文件均以明文保存对话文本,当前未在应用层额外加密,请依托操作系统磁盘加密与目录权限保护。
  • 浏览器扩展仅采集当前网页中已加载的文本消息,不调用平台私有接口拉取未展开的历史,也不会自动下载网页中的图片、音频或视频。
  • 桌面端安装包脚本(npm run build:dmg / npm run build:mas)与正式 App Store 签名需搭配本机环境与 Apple 开发者证书使用;本地开发与自用可通过 Node.js 24+ 直接运行。

三种方式运行 MemoCat

需要 Node.js 24+(内建 node:sqlite)。你可以以桌面应用、零运行时外部后端依赖的本机网页版,或 Chrome 扩展单独/联动使用。

方式 01 · macOS 桌面应用

Electron 桌面端

支持 macOS 原生菜单栏、快捷键(⌘1..5)、系统托盘后台驻留(默认保持 3792 端口服务)及 DMG / MAS 打包。

git clone https://github.com/qiwihui/MemoCat.git
cd memocat
npm install
npm run desktop

构建本地安装包:执行 npm run build:dmg 输出 macOS 磁盘映像。

方式 02 · 本机网页服务

Node.js 原生网页工作台

服务端完全依赖 Node.js 24 内置模块,打开 http://127.0.0.1:3792 即可使用完整浏览、召回与 MCP 能力。

npm start
# 自定义数据目录与端口
MEMO_DATA_DIR=/path/to/data PORT=3792 npm start

macOS 用户也可在克隆目录后直接双击 Start MemoCat.command 启动。

方式 03 · Chrome / Edge 扩展

浏览器扩展加载

构建 Manifest V3 扩展包后在浏览器扩展管理页开启「开发者模式」加载解压目录,即可单独归档或一键配对桌面端。

npm run build:extension
# 在 chrome://extensions 加载目录:
# dist/memocat-extension

加载后点击「一键连接 MemoCat 并同步」即可与运行中的 3792 服务自动完成配对。