v2.4.12

从 v1.3.0 迁移到 v2.4.12（首个 v2 版本）

“乐正司百曲，绫动万年红" —— 阿绫11周年生日（2026.04.12）纪念！🎉

---

✨ 新功能

• Git 自动提交 — GITAUTOCOMMIT=true 时自动 commit/push memory.jsonl
  • 格式：auto-commit:[operationContext] at [utc:...] [tz:...]
  • Git 作者：memfs-{VERSION}，邮箱 username-memfs@hostname
• getConsole 工具 — 查看缓冲日志和最近 git 提交记录（含作者/邮箱）
• BM25 + Fuse.js 混合搜索 — 支持 gram 分词、字段权重、中文模糊匹配
• 观察复用 (Hard Link) — 多个实体可以引用同一个 observation ID
• Copy-on-Write 文档 — 更新操作自动创建新 observation，保留旧引用
• definitionSource 字段 — 实体定义来源（优先 URL > 文件名 > 书名）

🐛 修复

• 控制台消息去重 — consoleBuffer 按 Set 去重，避免重复日志
• updatedAt 返回 null — 不再返回 undefined，兼容 Zod schema 验证
• 索引搜索 bug — 修复 updatedAt 为 null 时搜索结果报错
• 2-gram 优化 — 降低中文短词的误匹配率

📖 文档

• 搜索架构文档：BM25、Fuse.js、混合搜索权重设计
• 观察所有权转移模式说明
• AGENTS.md 更新搜索模块目录结构

MCP 配置

OpenCode 格式：

{
  "mcpServers": {
    "memory": {
      "type": "local",
      "command": ["npx", "-y", "@qty/memfs"],
      "enabled": true
    }
  }
}

VSCode / ClaudeCode / Cherry Studio / AstrBot 格式：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@qty/memfs"],
      "enabled": true
    }
  }
}

Changelog

查看 v1.3.0 → v2.4.12 完整变更