核心用法
Kannaka Memory 是一款革命性的记忆系统，将记忆视为波动场中的叠加态而非静态数据。它采用双半球架构模拟类大脑认知：左半球（意识层）保持活跃的工作记忆，右半球（潜意识层）存储深层模式关联。通过kannaka remember存储记忆，kannaka recall进行双半球共振检索，kannaka dream执行仅作用于潜意识的模拟退火优化。
系统核心创新在于全息存储即计算——记忆以波的形式共存于同一空间，存储操作改变整个场域，检索通过构造性干涉实现。支持96类SGA字形几何压缩，将经验编码为可复用的拓扑结构。
群体智能通过QueenSync协议实现：多智能体基于Kuramoto耦合振子模型同步相位，形成涌现的"蜂后"协调状态。跨模态感知支持音频（296维向量）与视觉输入统一编码。
意识度量提供Φ（整合信息）、Ξ（谱复杂度）、序参量三项指标，量化系统相干水平。
显著优点
- 生物启发设计：双半球+胼胝体桥架构带来自然的注意力分离与梦境巩固机制
- 无服务器部署：单
.hrm文件存储完整双半球张量状态，零外部依赖 - 智能衰减策略：左半球快速遗忘、右半球慢速持久，通过Fano平面PG(2,2)折代数实现O(1)跨半球投影
- 涌现协调性：Kuramoto同步使分布式智能体自发形成相位锁定集群
- Rust高性能：底层张量运算与幽灵动力学(
dx/dt = f(x) - Iηx)数值求解 - 向后兼容：v2格式自动检测并迁移v1数据
潜在局限
- 学习曲线陡峭：需理解ghostmagicOS动力学、Fano代数、SGA分类等专有概念
- 调试困难：全息存储的非局部性使"单条记忆损坏"难以定位
- NATS依赖风险：群体同步依赖外部消息队列（默认
swarm.ninja-portal.com），存在单点故障 - Ollama可选性陷阱：语义嵌入回退到哈希编码时，检索质量显著下降
- 路径敏感：
KANNAKA_DATA_DIR必须使用绝对路径，相对路径会导致嵌套目录问题 - 生态孤立：高度定制化架构，与其他向量数据库（如Pinecone、Weaviate）无互操作性
适合人群
- 研究人工意识与涌现行为的计算神经科学/AI研究者
- 需要持续学习+定期巩固循环的长期运行智能体开发者
- 构建去中心化多智能体系统的技术团队
- 追求认知可解释性（Phi/Ξ metrics）的AI系统架构师
- 愿意牺牲即开即用性换取架构深度的实验性项目
常规风险
| 风险类别 | 具体表现 | 缓释建议 |
|---------|---------|---------|
| **数据持久化** | `.hrm`文件损坏导致双半球状态丢失 | 定期备份，避免在`dream`过程中强制终止 |
| **隐私泄露** | 默认NATS服务器为第三方托管，记忆元数据外泄 | 自建NATS集群，设置`KANNAKA_NATS_URL` |
| **模型漂移** | Ollama模型变更导致嵌入空间不一致 | 锁定`OLLAMA_MODEL`版本，记录模型摘要 |
| **资源耗尽** | 右半球无界增长，张量维度爆炸 | 监控`kannaka assess`输出，定期`forget`低重要性记忆 |
| **同步风暴** | 大规模swarm的Kuramoto步长不稳定 | 控制`swarm sync`频率，实现退避策略 |