Llm Memory V9

🧠 公私分离的本地记忆框架

通过环境变量实现公私分离的LLM记忆框架,支持本地私有配置与FTS全文搜索,零网络访问设计保障数据安全。

收藏
4.8k
安装
1.5k
版本
9.0.0
CLS 安全性认证2026-08-03
点击查看完整报告 >

使用说明

核心用法

本技能采用公开框架 + 本地私有配置的分离架构,用户通过 CNB_PRIVATE_WORKSPACE 环境变量指定私有配置目录,安装后自动通过钩子完成文件链接。基础功能无需任何配置即可使用;高级功能需用户自建私有目录并放置 AGENTS.mdTOOLS.mdMEMORY.md 等自定义文件。

显著优点

  • 安全隔离:公开包零敏感信息,所有密钥与私有规则存放于用户本地
  • 零网络攻击面:无远程拉取、无API调用、无外部依赖下载
  • 灵活扩展:支持自定义Agent规则、工具配置和记忆存储
  • 架构通用:同时支持 x64 与 ARM64 平台

潜在局限

  • 需用户手动维护环境变量与目录结构,对新手有一定门槛
  • 依赖本地文件系统权限,多用户共享场景需额外配置
  • FTS全文搜索性能受本地硬件限制,大规模数据场景未经验证

适合人群

  • 注重数据隐私、希望完全掌控配置的安全敏感型用户
  • 需要隔离敏感业务规则与公开代码的企业开发者
  • 在离线或受限网络环境中部署LLM工具链的工程师

常规风险

  • 环境变量配置错误可能导致链接失败,需检查路径格式
  • 私有目录权限过宽可能造成敏感文件暴露,建议设置700权限
  • 钩子执行需Python3环境,未安装时安装流程会中断

安全解读

核心用法

本技能为 Agent 提供记忆检索与 FTS 全文搜索能力,采用创新的"公开框架 + 本地私有配置"分离架构。用户安装公开的框架包后,通过设置 CNB_PRIVATE_WORKSPACE 环境变量指向本地私有目录,即可自动链接自定义的 Agent 规则、工具配置和记忆文件。安装过程由 bootstrap-extra-files.py 钩子完成,仅执行本地符号链接或文件复制操作,全程无网络交互。

显著优点

安全设计领先:六维安全检测全部通过,无危险函数、无敏感信息硬编码、无外部依赖,网络流量分析得分 100 分。纯本地操作模式彻底杜绝供应链攻击和数据外泄风险。

架构灵活可控:公私分离设计让用户完全掌控敏感配置,公开包仅含框架模板,私有目录可自由定制 AGENTS.md、TOOLS.md、MEMORY.md 等规则文件,满足个性化需求。

零依赖轻量:仅依赖 Python 3 标准库,无额外 pip 包安装,部署极简,跨平台支持 x64 与 ARM64 架构。

潜在缺点与局限性

来源可信度受限:维护者 xkzs2007 为个人开发者,来源评级 T3,需用户自行评估信任度。虽代码审计通过,但缺乏组织级背书。

功能相对单一:专注本地配置文件链接,不涉及云端同步、多设备协作等高级场景,适合轻量级个人使用而非企业级部署。

权限管理依赖用户:钩子自动链接私有目录,若用户未正确设置目录权限(如 chmod 700),可能存在本地敏感配置被同系统其他用户访问的风险。

适合的目标群体

隐私敏感型开发者、追求数据本地化的 AI 应用构建者、需要自定义 Agent 记忆规则的技术用户,以及希望快速搭建私有记忆系统但不愿暴露配置到公网的个人或小型团队。

使用风险提示

  • 权限风险:需确保 CNB_PRIVATE_WORKSPACE 指向的目录具备适当访问限制
  • 版本更新审查:当前无网络访问,若未来版本变更架构,需重新验证安全性
  • T3 来源审慎:建议先在隔离环境测试,查看 Gitee 仓库历史与社区反馈后再投入生产使用

Llm Memory V9 内容

hooks文件夹
workspace_template文件夹
手动下载zip · 7.1 kB
bootstrap-extra-files.pytext/plain
请选择文件