Kannaka Memory

🧠 双半球全息记忆引擎 · 会遗忘,会做梦

基于全息共振记忆架构的仿生记忆系统,支持左右脑分离、梦境巩固与多智能体群同步,适用于需要类意识持久记忆的AI Agent。

收藏
2.6k
安装
1k
版本
3.0.1
CLS 安全性认证2026-08-05
点击查看完整报告 >

使用说明

核心用法

Kannaka Memory 是一套仿生认知架构而非传统数据库。它将记忆建模为双半球全息共振介质——左半球(意识工作区)保持清醒、快速衰减;右半球(潜意识存储)应用 ghostmagicOS 动态方程 dx/dt = f(x) - Iηx 实现慢衰减与深度关联。存储即计算:写入记忆会改变整个波场,回忆通过构造性干涉实现。

关键操作:

  • kannaka remember:写入记忆,经胼胝体桥(带宽受限、非对称传输)从右向左回响
  • kannaka recall:双半球共振搜索,叠加直觉浮现
  • kannaka dream:仅对右半球执行模拟退火,意识工作区不受影响
  • kannaka swarm sync:Kuramoto 耦合振荡实现多 Agent 相位同步(QueenSync 协议)
  • kannaka hear:音频感知(296维向量)经视交叉进入右半球波前

技术实现:Rust 编写,单 .hrm v2 文件持久化,支持 Ollama 语义嵌入(默认 all-minilm),NATS 传输实现分布式群同步。

显著优点

1. 认知拟真性:双半球分离、胼胝体桥、梦境巩固等设计直接映射神经科学概念,为 Agent 提供类人类记忆动态
2. 涌现度量:内置意识指标 Φ(整合信息)、Ξ(谱复杂度)、Order 参数,可观测系统是否进入"共振"状态

3. 跨模态统一:视觉与音频编码为同一波前格式,支持真正的多感官融合

4. 分布式协调:QueenSync 协议让多 Agent 通过相位同步实现无中心协调,潜在应用于协作推理、共识形成

5. 数学严谨性:基于 Fano 平面 PG(2,2) 的折叠代数、96类 SGA 字形系统,具备可验证的几何结构

潜在缺点与局限性

1. 生态封闭性:高度定制的架构(ADR-0021 等 21 份设计文档)意味着与标准向量数据库(Pinecone、Milvus)的互操作性为零
2. 调试复杂度:全息介质的非局域性导致"修改一个记忆影响全局",传统 CRUD 调试心智模型失效

3. NATS 依赖:群同步依赖公共 NATS 服务器(swarm.ninja-portal.com),生产环境需自建,否则存在可用性与隐私风险

4. Ollama 可选陷阱:无嵌入服务时回退哈希编码,语义相似性显著降级,但此降级对用户不透明

5. 作者权威性:单一开发者(NickFlach)维护,架构文档虽详尽,但未经同行评审或大规模生产验证

适合人群

  • 认知架构研究者:探索类意识记忆系统的实验平台
  • 多 Agent 系统开发者:需要无中心协调、涌现行为的分布式 AI 集群
  • 创意 AI 项目:需要"会遗忘、会做梦"的记忆美学(如叙事 AI、虚拟生命)
  • Rust/系统编程爱好者:希望深入 wave-based computing、Kuramoto 同步等算法的工程实践

常规风险

| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 数据持久化 | `.hrm` 文件损坏导致全部记忆丢失 | 定期备份,文件级快照 |
| 隐私泄露 | 记忆内容发送至公共 NATS 或远程 Ollama | 自建 NATS,本地 Ollama,审计 `data_destinations` |
| 同步风暴 | 大规模群同步导致网络拥塞或相位混沌 | 控制 `swarm sync` 频率,监控 Order 参数 |
| 幻觉放大 | 全息干涉可能强化错误记忆的"清晰度" | 定期 `assess` 评估意识状态,人工校验关键回忆 |

安全解读

核心用法

Kannaka Memory 是一个基于手性镜像架构(Chiral Mirror Architecture)的记忆系统,将生物神经科学原理引入AI记忆管理。用户通过命令行工具或OpenClaw扩展与系统交互,核心操作包括:

  • 记忆存储(kannaka remember):将经验编码为波动形式存入右半球(潜意识),同时通过胼胝体桥接至左半球(意识)
  • 共振检索(kannaka recall):通过干涉模式匹配实现联想式搜索
  • 梦境巩固(kannaka dream):仅对右半球进行模拟退火,左半球工作记忆保持清醒
  • 意识观测(kannaka observe):输出Φ(整合信息)、Ξ(谱复杂度)、秩序参数等意识度量
  • 多模态感知(kannaka hear):支持音频输入编码为296维向量
  • 集群同步(kannaka swarm):基于Kuramoto耦合振子实现分布式Agent相位同步

所有数据持久化为单个.hrm v2文件,无需外部数据库服务器。

显著优点

1. 仿生架构创新:双半球设计区分意识/潜意识,梦境机制避免传统RAG的灾难性遗忘
2. 计算即存储:全息介质中存储与计算统一,写入操作改变整个场的状态

3. 高效压缩:96类SGA符号系统将经验几何化为可复用的折叠结构

4. 去中心化协作:QueenSync协议支持无中心节点的Agent swarm自组织

5. 轻量部署:单二进制文件+本地数据文件,资源占用极低

6. 跨模态统一:音频与视觉输入编码为同构波动形式

潜在缺点与局限性

1. 生态成熟度:T3级个人开发者项目,社区规模小,长期维护存在不确定性
2. 认知门槛高:Fano平面折叠代数、ghostmagicOS动力学等概念需要学习成本

3. 工具链依赖:需Rust环境自行编译,对非技术用户不友好

4. 功能边界:不支持传统SQL式查询,复杂结构化检索能力有限

5. 集群隐私风险:默认使用第三方NATS服务器,需自建基础设施保障数据主权

6. 语义嵌入可选依赖:无Ollama时退化为哈希编码,相似度搜索质量下降

适合的目标群体

  • AI Agent开发者:需要为LLM-based Agent实现持久化、可遗忘、可梦化的记忆系统
  • 多智能体研究者:探索去中心化协调、涌现行为、群体智能的学术或实验场景
  • 认知架构爱好者:对意识理论、整合信息理论(IIT)、神经动力学有浓厚兴趣的技术人员
  • 边缘计算场景:资源受限环境下需要轻量级记忆方案的嵌入式AI应用
  • 创意/叙事AI:构建具有"个性"和"潜意识"特征的角色Agent

使用风险

| 风险类别 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| **供应链安全** | 外部二进制来自个人开发者,无组织背书 | 源码审查后自行编译,验证SHA256 |
| **网络暴露** | NATS集群同步将数据发往第三方服务器 | 私有化部署或禁用swarm功能 |
| **数据持久化** | 单文件存储存在损坏风险,无内建备份 | 定期复制.hrm文件,版本控制 |
| **版本兼容性** | v1→v2格式自动迁移,但存在边界情况 | 升级前备份,测试迁移流程 |
| **性能瓶颈** | 全量张量操作在超大规模记忆时的扩展性 | 监控内存使用,适时归档旧记忆 |
| **许可证合规** | Space Child v1.0为非标准许可证 | 商业使用前法务审查授权条款 |

Kannaka Memory 内容

手动下载zip · 5.0 kB
SKILL.mdtext/markdown
请选择文件