SimpleMem Skill 用于跨会话持久保存和检索对话记忆。它适合在发现重要内容时主动保存,例如对话中做出的重要决定或承诺、后续可能引用的复杂信息、值得保留的长讨论上下文、以及花费较多精力才找到的问题解决方案;在回答关于过往对话的问题、从上次会话继续工作或基于先前讨论继续推进前,应先查询记忆。
主要操作通过命令行使的 Python 脚本完成。添加单条对话可执行:python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "Alice" --content "Meet Bob tomorrow at 2pm";也可加 --timestamp 使用 ISO 8601 时间,缺省时自动生成。语义查询并返回答案:query --question "...";需要更深入分析时可加 --enable-reflection;原始检索:retrieve --query "..." --top-k 5。维护方面可用 stats 查看统计,用 clear --yes 清空全部记忆(不可逆,需谨慎)。若需从 JSONL 文件批量导入对话历史,可参考 references/import-guide.md。用 --table-name 可指定自定义表名来组织不同会话上下文,例如在脚本后加 --table-name my_custom_table。
数据以 speaker、content、timestamp 三个字段保存。安装依赖:cd ~/.claude/skills/simplemem-skill 后执行 pip install -r requirements.txt;配置 OpenRouter API 需先 cp src/config.py.example src/config.py,再编辑 src/config.py 设置 OPENROUTER_API_KEY。记忆持久保存在 data/lancedb/(自动创建)。更多信息参见 references/openrouter-guide.md(API 密钥与模型选择)、references/import-guide.md(JSONL 导入与批量操作)、references/cli-reference.md(命令参考)、references/architecture.md(系统架构与配置)。