核心用法
clipboard-memory 依托 clipmem 工具构建本地剪贴板存档系统，持续捕获 macOS NSPasteboard 的每次变更并写入 SQLite 数据库。用户可通过自然语言查询（如"刚才复制的那个命令""昨天Safari里的URL"）快速定位历史内容，无需依赖网络搜索。
主要命令层级清晰：
- `clipmem recall` —— 智能排序的最佳匹配，适合绝大多数"找回某个内容"的场景
- `clipmem timeline` —— 按时间线展示全部捕获事件，含重复复制记录
- `clipmem search` —— 精确子串/FTS搜索，适合已知关键词的场景
- `clipmem get + export` —— 提取二进制内容（图片/PDF）的原始字节
支持多维度过滤：应用来源、内容类型、时间窗口、URL/文件路径检测等，并提供 --format json/toon/jsonl 三种机器可读输出格式。
显著优点
1. 完全本地隐私：数据仅存储于 ~/Library/Application Support/clipmem/，不上传云端
2. 跨内容类型统一检索：文本、代码、HTML、图片、PDF 均可追溯
3. Agent 原生设计：JSON-first CLI，支持光标分页、置信度标记、替代候选，便于自动化集成
4. 零配置持续捕获：后台 watcher 自动运行，重启后历史不丢失
5. 精准召回能力：支持"复制自Xcode的今天内容""重启前的那条命令"等复杂语境
潜在缺点与局限性
- 平台锁定：仅支持 macOS（依赖
NSPasteboard），Windows/Linux 用户无法使用 - 二进制内容需额外导出：图片/PDF 需执行
export子命令，不能直接内嵌文本输出 - 健康状态依赖后台服务：若 watcher 停滞或权限异常，可能返回空结果，需主动诊断
- 无跨设备同步：纯本地存档，多 Mac 间无法共享历史
- 存储增长：长期运行后 SQLite 文件可能膨胀，需配合
storage optimize-images管理
适合人群
- 频繁复制命令、代码片段、URL 后遗忘的开发者
- 需要追溯设计素材（图片/PDF）来源的设计师
- 重视隐私、不愿使用云端剪贴板服务的敏感行业用户
- 构建本地知识工作流的自动化/Agent 开发者
常规风险
- 单点故障：本地 SQLite 损坏或误删将导致历史丢失，建议配合 Time Machine 备份
- 敏感数据残留：剪贴板可能捕获密码、令牌等敏感内容，虽不上云但本地明文存储
- 权限漂移：macOS 升级或安全设置变更可能中断捕获服务，需定期运行
clipmem doctor验证
技术可信度
- 开源协议：MIT License
- 安装渠道：Homebrew 官方 Tap + Cargo 源码编译
- 数据格式：稳定的 JSON Schema v2，具备版本锁定机制