triple-memory-baidu-embedding

🧠 隐私优先的三重记忆架构

基于 Clawdbot 架构的三重记忆系统,利用百度 Embedding 实现隐私优先的跨会话上下文保持与中文语义检索,支持自动降级运行。

收藏
9.9k
安装
2.9k
版本
v1.0.0
CLS 安全性认证2026-05-05
点击查看完整报告 >

使用说明

Triple Memory Baidu Embedding 是一个面向 AI Agent 的综合记忆架构,通过三层互补系统实现跨会话的上下文持久化。该系统核心用法围绕"百度 Embedding 自动召回"、"Git-Notes 结构化记忆"和"文件系统工作区搜索"三个维度展开。用户通过配置百度 API 环境变量启用语义搜索层,利用 Git-Notes 进行分支隔离的结构化决策记录,并通过脚本搜索本地 Markdown 文件实现工作区知识检索。系统支持自动降级模式,在未配置 API 凭据时仍可通过 Git-Notes 和文件层提供基础记忆功能。

显著优点包括:首先是隐私保护机制完善,向量数据本地存储仅通过百度 API 进行 Embedding 计算,避免敏感数据外流;其次针对中文语境优化,百度 Embedding-V1 相比 OpenAI 模型对中文语义理解更准确;三是架构健壮性高,三层设计确保即使单点故障(如 API 不可用)系统仍能降级运行;四是与 Git 工作流深度集成,支持分支隔离的记忆管理,适合代码开发场景;最后采用静默操作设计,记忆存储与召回过程无干扰,用户体验流畅。

潜在缺点主要体现在:系统配置复杂度较高,需要手动安装两个前置技能并配置 API 凭据;来源可信度为 T3 级(社区个人开发者),虽基于 Clawdbot 官方架构修改但非官方维护;功能依赖外部服务,完整语义搜索需稳定的百度 API 访问;此外记忆管理采用文件系统和 SQLite,在超大规模数据场景下可能面临性能瓶颈。

适合的目标群体包括:需要长期上下文保持的 AI 应用开发者、注重数据隐私的中文用户、使用 Clawdbot 进行复杂项目管理的团队,以及需要在离线/在线混合环境下工作的用户。该系统特别适合处理需要持续积累领域知识的对话场景,如编程辅助、学术研究或长期项目管理。

使用风险方面,主要需关注 API 凭据的安全管理,虽然系统要求通过环境变量配置而非硬编码,但仍需确保 BAIDU_API_STRINGBAIDU_SECRET_KEY 的存储安全。性能风险包括百度 API 的响应延迟可能影响实时性,以及本地 SQLite 向量库在万级记忆条目后的检索性能下降。依赖风险体现在对 git-notes-memorymemory-baidu-embedding-db 两个外部技能的版本兼容性要求,建议定期备份 $WORKSPACE/memory/ 目录以防数据丢失。

安全解读

核心用法

Triple Memory Baidu Embedding 是一套三层互补的记忆架构,专为 AI Agent 的长期上下文保持设计:

1. 百度嵌入层(会话记忆)

  • 基于 Baidu Embedding-V1 的自动召回与捕获
  • 本地向量存储,隐私优先
  • 针对中文语义优化
  • 触发词:"remember"、"prefer"、"my X is" 等
  • 支持手动工具:baidu_memory_recallbaidu_memory_storebaidu_memory_forget

2. Git-Notes 层(结构化决策)

  • 分支隔离,支持实体提取
  • 四级重要性分级(critical/high/normal/low)
  • 纯本地,无外部 API

3. 文件搜索层(工作空间)

  • 搜索 MEMORY.md、memory/*.md 及任意工作区文件

显著优点

  • 隐私增强:所有向量数据本地存储,仅调用百度 API 进行嵌入计算
  • 中文优化:Baidu Embedding 对中文语义理解优于通用模型
  • 成本可控:相比 OpenAI 嵌入 API 可能降低费用
  • 架构成熟:继承 Clawdbot Team 验证的三层设计
  • GDPR 合规:支持数据删除权(baidu_memory_forget

潜在缺点与局限性

  • 依赖外部凭证:百度 API 未配置时进入降级模式,仅保留 Git-Notes + 文件层
  • 版本约束缺失:依赖的 git-notes-memory 和 memory-baidu-embedding-db 未声明版本,存在兼容性风险
  • 配置门槛:需要手动设置 BAIDU_API_STRING 和 BAIDU_SECRET_KEY
  • 路径格式问题:脚本文件名使用反斜杠,不符合 Unix 惯例

适合人群

  • 需要长期跨会话记忆的中文用户
  • 隐私敏感、偏好本地数据存储的场景
  • 使用 Clawdbot/类 Claude Code 框架的开发者
  • 希望降低嵌入 API 成本的企业用户

常规风险

  • 供应链风险:依赖技能版本未锁定
  • 凭证配置错误导致功能降级
  • 降级模式下自动记忆能力丧失,需手动管理

安全认证摘要

  • 安全等级:A(87分)
  • 来源可信:T2(基于 Clawdbot Team 知名开源项目)
  • 无恶意代码、危险函数或敏感信息泄露
  • 网络行为仅指向百度千帆官方 API(HTTPS)

triple-memory-baidu-embedding 内容

scripts文件夹
手动下载zip · 20.1 kB
baidu-memory-tools.shtext/x-shellscript
请选择文件