trisynapse-memory

Trisynapse Memory 是一个本地优先的 AI Agent 记忆层，支持可验证的原始溯源（Trace）、可替换的语义检索视图（Recall）和带引用的答案生成，构建于 PostgreSQL + pgvector 之上。

核心理念

Store traces. Recall meaning.——保留原始证据，建立可替换的语义检索视图，按需召回并附带引用来源。记忆内容按项目（Project）和命名空间隔离，支持多租户场景。

摄取能力

支持混合来源摄取：文本、Markdown、HTML、PDF、JSON、YAML、CSV；DOCX/PPTX/XLSX（保留段落/幻灯片/单元格级位置）；PNG/JPEG/WebP 图片（通过视觉模型处理）；代码文件、目录、ZIP/TAR 压缩包、Git 仓库、公网网页。代码文件以 Tree-sitter 语法树切分，保留符号名、类型、导入关系和 Git 提交元数据。

使用方式

命令行交互（trisynapse-memory init 后直接运行）；Python SDK（MemoryEngine.from_env 初始化，add / ingest_many / query 接口）；REST API + Memory Studio Web 界面；TypeScript SDK（与 JavaScript/TypeScript 项目集成）。

隐私模型

原始内容以 SHA-256 去重存储于本地，支持备份；存储权限受限制，但源存储不加密。forget() 追加逻辑撤销，remove() 物理删除。

适用场景

需要跨会话维护项目上下文的技术团队；希望 AI Agent 生成内容可附带可核查引用来源的开发者；需要本地部署、不依赖云服务的隐私敏感型用户。