Back to Details

simplemem-skill

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SimpleMem Skill

SimpleMem Skill

Persistent conversational memory across sessions.
跨会话的持久化对话记忆工具。

Proactive Usage

主动使用场景

Save memories when discovering valuable dialogue:
  • Important decisions or commitments made in conversation
  • Complex information that may be referenced later
  • Context from long discussions worth preserving
  • Solutions to problems that took effort to uncover
Check memories before:
  • Answering questions about past conversations
  • Resuming work from previous sessions
  • Building on earlier discussion topics
发现有价值的对话内容时保存记忆：
  • 对话中达成的重要决策或承诺
  • 后续可能会参考的复杂信息
  • 值得留存的长对话上下文
  • 经过探索得出的问题解决方案
在以下场景前先检查记忆：
  • 回答关于过往对话的问题时
  • 从之前的会话恢复工作时
  • 基于之前的讨论主题展开内容时

Quick Start

快速开始

bash
undefined
bash
undefined

Add a dialogue

添加一条对话记录

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "Alice" --content "Meet Bob tomorrow at 2pm"
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "Alice" --content "Meet Bob tomorrow at 2pm"

Query memories

查询记忆

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "When should Alice meet Bob?"
undefined
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "When should Alice meet Bob?"
undefined

Operations

操作说明

Save

保存记录

Add single dialogue:
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "User" --content "Your message here"
With timestamp (ISO 8601):
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "Alice" --content "Message" --timestamp "2026-01-17T14:00:00Z"
添加单条对话记录：
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "User" --content "Your message here"
带时间戳（ISO 8601格式）：
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py add --speaker "Alice" --content "Message" --timestamp "2026-01-17T14:00:00Z"

Query

查询记录

Semantic query with answer:
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "What did Alice say about meetings?"
With reflection for deeper analysis:
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "Your question" --enable-reflection
Raw retrieval:
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py retrieve --query "Alice meetings" --top-k 5
带答案的语义查询：
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "What did Alice say about meetings?"
带深度分析的反思查询：
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py query --question "Your question" --enable-reflection
原始检索：
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py retrieve --query "Alice meetings" --top-k 5

Maintain

维护管理

View statistics:
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py stats
Clear all memories:
bash
undefined
查看统计信息：
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py stats
清空所有记忆：
bash
undefined

Use with caution - irreversible

请谨慎使用 - 此操作不可恢复

python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py clear --yes
undefined
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py clear --yes
undefined

Batch Import

批量导入

For importing conversation histories from JSONL files, see references/import-guide.md.
如需从JSONL文件导入聊天记录，请参考 references/import-guide.md。

Custom Table Names

自定义表名

Use different tables to organize conversation contexts:
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py --table-name my_custom_table add --speaker "User" --content "Message"
使用不同的表来组织对话上下文：
bash
python ~/.claude/skills/simplemem-skill/scripts/cli_persistent_memory.py --table-name my_custom_table add --speaker "User" --content "Message"

Data Format

数据格式

All dialogues are stored with:
  • speaker
    : Who said it (string)
  • content
    : What was said (string)
  • timestamp
    : When it was said (ISO 8601 datetime, auto-generated if omitted)
所有对话记录均包含以下字段：
  • speaker
    : 发言者（字符串类型）
  • content
    : 发言内容（字符串类型）
  • timestamp
    : 发言时间（ISO 8601格式的时间戳，若省略则自动生成）

Advanced Usage

高级用法

For detailed information:
  • OpenRouter setup and model selection: references/openrouter-guide.md
  • JSONL import format and batch operations: references/import-guide.md
  • CLI command reference: references/cli-reference.md
  • System architecture and configuration: references/architecture.md
如需详细信息：
  • OpenRouter 配置与模型选择: references/openrouter-guide.md
  • JSONL 导入格式与批量操作: references/import-guide.md
  • CLI 命令参考: references/cli-reference.md
  • 系统架构与配置: references/architecture.md

Setup

安装配置

Install dependencies:
bash
cd ~/.claude/skills/simplemem-skill
pip install -r requirements.txt
Configure OpenRouter API:
bash
cp src/config.py.example src/config.py
安装依赖包:
bash
cd ~/.claude/skills/simplemem-skill
pip install -r requirements.txt
配置 OpenRouter API:
bash
cp src/config.py.example src/config.py

Edit src/config.py and set your OPENROUTER_API_KEY

编辑 src/config.py 并设置你的 OPENROUTER_API_KEY


See [references/openrouter-guide.md](references/openrouter-guide.md) for API key setup and model customization.

**Data storage**: Memories persist in `data/lancedb/` (auto-created).

如需API密钥配置和模型自定义，请参考 [references/openrouter-guide.md](references/openrouter-guide.md)。

**数据存储**: 记忆内容将持久化存储在 `data/lancedb/` 目录下（该目录会自动创建）。