CLI

命令行入口:moon run src/cli --target native -- <command> ...,或先 moon build src/cli --target native 后调用二进制。

子命令

命令用途
add写入(--db / --user / --text;可选 --llm、--llm-judge、--model、--base-url)
recall混合召回(--query,可选 --top-k)
list列出条目(可选 --all)
stats库统计
export / importJSONL 备份 / 恢复
help用法

常用默认值:--db ./moomem-data、--user default、--top-k 5(最大 50)。

示例

moon run src/cli --target native -- add \
  --db ./mem --user user-42 --text "我对花生过敏"

moon build src/cli --target native
BIN=_build/native/debug/build/src/cli/cli.exe

$BIN recall --db ./mem --user user-42 --query "花生过敏"
$BIN list   --db ./mem --user user-42
$BIN stats  --db ./mem
$BIN export --db ./mem > backup.jsonl
$BIN import --db ./mem --file backup.jsonl

LLM 相关环境变量

变量说明
MOOMEM_LLM_API_KEY必填(启用 --llm / --llm-judge 时)
MOOMEM_LLM_BASE_URL可选,OpenAI 兼容端点
MOOMEM_LLM_MODEL可选,缺省如 gpt-4o-mini

CLI 旗标 --model / --base-url 优先于环境变量。密钥只从环境变量读,无 --api-key 明文参数。--llm / --llm-judge 仅 native 门控。

export MOOMEM_LLM_API_KEY=...
# export MOOMEM_LLM_BASE_URL=https://api.deepseek.com
# export MOOMEM_LLM_MODEL=deepseek-chat

moon run src/cli --target native -- add \
  --db ./mem --user user-42 --text "你好!我对花生过敏" --llm

# 同时启用 LLM 冲突判定:加 --llm-judge(隐含 --llm)

库内注入写法见 LLM 注入。