核心用法
clipboard-memory 是专为 macOS 设计的剪贴板历史管理技能，通过 clipmem 工具持续捕获 NSPasteboard 内容并存储于本地 SQLite 数据库。该技能提供分层检索能力：
- 智能召回 (
clipmem recall)：基于语义相关性排序返回最佳匹配项，附带备选建议 - 时间线浏览 (
clipmem timeline)：按时间顺序展示每次复制事件，支持重复内容追踪 - 精确搜索 (
clipmem search)：支持字面量匹配与全文检索，适合包含特殊字符的查询 - 原始导出 (
clipmem export)：针对二进制内容（图像、PDF）提取原始字节
所有命令默认支持 --format json 结构化输出，便于代理程序解析。支持按应用来源、时间窗口、内容类型等多维度过滤，并提供光标分页机制处理大规模结果集。
显著优点
- 隐私优先：数据完全本地存储，无需网络传输或云端同步
- 类型全面：覆盖纯文本、富文本、HTML、URL、文件路径、图像、PDF 等 macOS 剪贴板支持的所有类型
- 检索灵活：从模糊语义召回到精确子串匹配，适应不同记忆模糊度的查询场景
- 代理友好：JSON-first CLI 设计，输出格式稳定（
schema_version: 2），便于自动化集成 - OCR 扩展：内置图像文字识别候选队列，支持批量处理优化
潜在局限
- 平台锁定：仅支持 macOS（依赖
NSPasteboard），Windows/Linux 用户无法使用 - 前置依赖：需持续运行后台 watcher 进程，系统重启或进程终止期间的内容可能丢失
- 权限敏感：需保持对
~/Library/Application Support/clipmem/的读写权限，Sandbox 环境可能受限 - 置信度不确定性：
recall命令的best_match_confidence为"low"时需人工二次确认，不可完全自动化决策 - 无跨设备同步：纯本地架构意味着多台 Mac 间无法共享历史
适合人群
- 频繁在终端、浏览器、IDE 间复制代码片段、命令、URL 的开发者
- 需要追溯「刚才那个路径/链接是什么」的重度多任务用户
- 重视隐私、拒绝云端剪贴板同步的企业/安全敏感场景
- 构建本地知识管理自动化工作流的技术用户
常规风险
- 数据持久化风险：SQLite 文件未加密，物理设备丢失可能导致敏感剪贴板内容泄露
- 进程单点故障：watcher 崩溃或被杀软终止会导致静默丢失捕获，需定期检查
clipmem agents context健康状态 - 误依赖风险：用户可能过度依赖历史召回而忽视即时保存重要凭证，一旦数据库损坏无法恢复
- 版本兼容性：
schema_version升级可能导致下游解析脚本失效，需锁定版本或跟随更新 - 资源占用：长期运行可能积累大量图像/PDF 二进制数据，需配合
storage optimize-images主动清理