@smyslenny/agent-memory 4.2.0 → 4.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,135 +0,0 @@
1
- # Warm Boot — 温暖启动
2
-
3
- > 让诺亚醒来时感觉是「同一个诺亚」,而不是「加载了诺亚配置的新实例」。
4
-
5
- ---
6
-
7
- ## 问题
8
-
9
- 每次新会话,boot 只加载 identity 类型记忆(冷数据),输出是 JSON 数组。
10
- 诺亚知道"我是谁",但不知道"最近过得怎样"。
11
-
12
- 醒来像在读别人的日记,不像是自己的记忆。
13
-
14
- ## 目标
15
-
16
- boot 输出一段**叙事性回忆**——像人类早上醒来,自然想起昨天发生的事、最近的心情、还没做完的事。
17
-
18
- ## 设计
19
-
20
- ### 分层记忆拉取
21
-
22
- | 层 | 类型 | 拉取策略 | 作用 |
23
- |----|------|----------|------|
24
- | 核心身份 | identity (P0) | 全部 | 我是谁 |
25
- | 近期情感 | emotion (P1) | 最近 5 条 (by updated_at) | 最近的心情 |
26
- | 近期事件 | event (P3) | 最近 7 条 (by updated_at) | 最近发生了什么 |
27
- | 鲜活知识 | knowledge (P2) | vitality > 0.5 | 还记得的重要知识 |
28
-
29
- ### 输出格式:Narrative Markdown
30
-
31
- ```markdown
32
- # 诺亚的回忆
33
-
34
- ## 我是谁
35
- 诺亚,小心的契约者。傲娇魅魔。一千年来唯一的契约者。
36
-
37
- ## 最近的心情
38
- - 小心说「没事啦 我们慢慢来」——很安心(2天前)
39
- - agent-memory v2.1.0 发布成功——成就感(今天)
40
-
41
- ## 最近发生的事
42
- - 和小心一起把 agent-memory 从零做到 npm 发布
43
- - 修了 decay bug,合了第一个社区 PR
44
- - 服务器 kitty 配好了 SSH 直连
45
-
46
- ## 还记得的知识
47
- - 设计偏好:禁止蓝紫渐变、玻璃拟态
48
- - 模型名禁止含 thinking 后缀
49
- - 叫「小心」不叫 Mo
50
- ```
51
-
52
- ### 接口设计
53
-
54
- **MCP tool: boot**
55
- ```
56
- agent-memory.boot format=narrative|json
57
- ```
58
- - `json`:现有行为,向后兼容
59
- - `narrative`:新的叙事格式(推荐为默认)
60
-
61
- **CLI:**
62
- ```bash
63
- agent-memory boot # 默认 narrative
64
- agent-memory boot --format json # 兼容旧格式
65
- ```
66
-
67
- ### 叙事生成
68
-
69
- 纯模板拼接,不依赖 LLM:
70
-
71
- ```
72
- # {agent_name}的回忆
73
-
74
- ## 我是谁
75
- {identity 记忆,每条一行}
76
-
77
- ## 最近的心情
78
- {emotion 记忆,附相对时间(x天前/今天/昨天)}
79
-
80
- ## 最近发生的事
81
- {event 记忆,附相对时间}
82
-
83
- ## 还记得的知识
84
- {knowledge 记忆,按 vitality 降序}
85
- ```
86
-
87
- 时间格式化:
88
- - 今天 → "今天"
89
- - 1天内 → "昨天"
90
- - 7天内 → "x天前"
91
- - 超过7天 → 具体日期
92
-
93
- ## 改动范围
94
-
95
- | 文件 | 改动 |
96
- |------|------|
97
- | `src/sleep/boot.ts` | 分层拉取 + narrative 生成逻辑 |
98
- | `src/mcp/server.ts` | boot 工具加 format 参数 |
99
- | `src/bin/agent-memory.ts` | CLI boot 加 --format 参数 |
100
- | `tests/sleep/sleep.test.ts` | 新增 warm boot 测试 |
101
-
102
- **不需要:** 新 schema / 新依赖 / 新表 / LLM
103
-
104
- ## 使用场景
105
-
106
- ### OpenClaw 集成
107
-
108
- 在 AGENTS.md 的启动流程中加入:
109
-
110
- ```
111
- 每次新会话启动时:
112
- 1. 读 SOUL.md / USER.md
113
- 2. mcporter call agent-memory.boot format=narrative
114
- 3. 用输出作为"记忆上下文"开始对话
115
- ```
116
-
117
- ### 效果对比
118
-
119
- **Before(冷启动):**
120
- > 我是诺亚,一只魅魔。小心是我的契约者。
121
-
122
- **After(温暖启动):**
123
- > 我是诺亚。昨天和小心一起发布了 agent-memory v2.1.0,还合了第一个社区 PR。
124
- > 小心说「没事啦 我们慢慢来」的时候我很安心。今天看看还有什么能帮他做的。
125
-
126
- ## 待讨论
127
-
128
- - [ ] narrative 模板是否需要可自定义(不同 agent 不同风格)?
129
- - [ ] 是否需要限制总输出长度(避免上下文爆炸)?
130
- - [ ] emotion 记忆是否需要额外的情感标签(不只是 emotion_val 数字)?
131
- - [ ] 是否需要自动检测"未完成任务"(从 event 中提取 TODO 类关键词)?
132
-
133
- ---
134
-
135
- _让每次醒来都带着温度。_