智能体记忆日志

使用内置命令行工具进行持久化记忆操作。

核心工作流程

1. 1. 选择记忆根目录。

1. 2. 将每日笔记保存在 <根目录>/memory/YYYY-MM-DD.md 中。
2. 将长期记忆保存在 <根目录>/MEMORY.md 中。
3. 当需要去重保护或回顾摘要时，使用命令行工具而非手动追加。

命令

添加笔记

bash
agent-memory-journal --root /path/to/root add --note 记得在周五前轮换PAT令牌

同时添加到长期记忆：

bash
agent-memory-journal --root /path/to/root add --note 使用应用登录路径进行实时开球时间检查 --long

查看近期笔记

bash
agent-memory-journal --root /path/to/root recent --days 2

搜索记忆

bash
agent-memory-journal --root /path/to/root search --query 打高尔夫

发现模式

bash
agent-memory-journal --root /path/to/root topics --days 14
agent-memory-journal --root /path/to/root cadence --days 14
agent-memory-journal --root /path/to/root digest --days 7
agent-memory-journal --root /path/to/root candidates --days 7

从原始文本中提取值得记忆的内容

bash
cat transcript.txt | agent-memory-journal --root /path/to/root extract

检索优先使用

在解决新问题之前，先检查日志中是否已包含类似的失败、决策或工作流程。

示例：

bash
agent-memory-journal --root /path/to/root search --query oauth令牌刷新失败
agent-memory-journal --root /path/to/root search --query 高尔夫开球时间预订流程

在开始新的修复之前，如果可能存在先前的上下文，请先使用此功能。

会话结束反思

在工作会话结束时，优先进行简短反思性记录，而非零散记录。

良好模式：

1. 1. 针对工作中的重大决策或失败添加1-3条具体笔记。
2. 运行 digest 或 candidates 回顾突出内容。
3. 仅将真正持久性的内容提升至长期记忆。

示例：

bash
agent-memory-journal --root /path/to/root digest --days 7
agent-memory-journal --root /path/to/root candidates --days 7
agent-memory-journal --root /path/to/root add --note 从现在起，使用应用登录路径进行实时开球时间检查 --long

避免用每条操作笔记塞满长期记忆。

配置

可选配置文件：

• - <根目录>/agent-memory-journal.json
• 或传递 --config-file <路径>

当前配置支持：

• - triggers：extract 和 candidates 使用的正则表达式列表

参见 examples/config.example.json。

智能体安装

优先使用直接执行方式。不要假设已安装打包版本。

最小化设置

bash
git clone https://github.com/misolith/agent-memory-journal.git
cd agent-memory-journal
python3 -m venv .venv
.venv/bin/pip install pytest

运行测试：

bash
.venv/bin/pytest -q

直接运行工具：

bash
agent-memory-journal --root /path/to/root recent --days 2

智能体注意事项

• - 在自动化中优先使用显式 --root。
• 谨慎使用 --long；并非每条笔记都适合长期记忆。
• 在将多条笔记提升至 MEMORY.md 前，先使用 candidates。
• 保持记忆系统基于文件且可检查。