核心功能
wip-memory-crystal 是一款面向AI原生工作流的长期记忆管理系统。它通过自动捕获-嵌入存储-语义检索的三层架构，解决AI对话中上下文丢失、跨会话记忆断层的核心痛点。
核心用法
- 自动捕获：每分钟cron作业抓取Claude Code、Claude Desktop、OpenClaw等客户端的对话记录
- 语义搜索：基于OpenAI/Ollama/Google/MLX的嵌入模型，支持自然语言查询（如"上周说的插件方案"）
- 主动记忆：通过
crystal_remember存储用户偏好、决策、关键事件，跨会话持久化 - 多设备同步：Crystal Core + Node架构，桌面端作为核心数据库，笔记本/移动端作为镜像节点
显著优点
- 主权可控：数据完全本地存储于
~/.ldm/，无云端依赖，支持端到端加密中继 - 跨平台统一：同一数据库被Claude Code CLI、Claude Desktop、OpenClaw共享
- 零摩擦集成：安装后AI自动调用
crystal_search/crystal_remember，用户无需学习新界面 - 灵活嵌入：支持Apple Silicon本地MLX（免费）、Ollama、OpenAI等多种提供商
潜在局限
- 技术门槛：Node.js 20+、环境变量配置、cron权限管理对非开发者有挑战
- Apple生态依赖：MLX本地嵌入仅限M系列Mac，其他平台需配置外部API
- 数据膨胀风险：持续捕获导致数据库增长，需手动管理备份策略
- 中继稳定性：多设备同步依赖Cloudflare Relay或自建服务，网络中断时同步延迟
适合人群
- 重度AI用户：日均多会话、跨项目使用Claude Code的开发者
- 知识工作者：需要AI记住长期偏好、决策历史的顾问、产品经理
- 多设备用户：桌面+笔记本组合，期望无缝上下文延续
常规风险
- 数据安全：虽然本地优先，但中继同步阶段的密钥管理、备份目录的物理安全需用户自行负责
- 隐私边界：自动捕获可能记录敏感对话，需明确配置排除规则
- 供应商锁定：MCP协议虽开放，但深度依赖Claude生态的hook机制