From 69a79ac86d226f1424c7cfb18964ceb53d718c7d Mon Sep 17 00:00:00 2001
From: root <root@minecraft-server>
Date: Thu, 30 Apr 2026 09:34:45 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20memory=5Fquery=5Farchived=20=E5=B7=A5?=
 =?UTF-8?q?=E5=85=B7=E6=B7=BB=E5=8A=A0=E7=A4=BA=E4=BE=8B=E8=AF=B4=E6=98=8E?=
 =?UTF-8?q?=EF=BC=8C=E5=90=8C=E6=AD=A5=E6=9B=B4=E6=96=B0=E7=B3=BB=E7=BB=9F?=
 =?UTF-8?q?=E6=8F=90=E7=A4=BA=E8=AF=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 core/prompts/templates/system_prompt.md |  1 +
 core/tools/memory_tools.py              | 18 +++++++++++++++++-
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/core/prompts/templates/system_prompt.md b/core/prompts/templates/system_prompt.md
index a2aa9a3..29319a1 100644
--- a/core/prompts/templates/system_prompt.md
+++ b/core/prompts/templates/system_prompt.md
@@ -101,6 +101,7 @@ subject, relation, object 每个字段必须是一个**短关键字**（1~5个
 | `memory_introspect` | 需要了解整体情况 | 查看图数据库概况：总节点数、边数、最新活动 |
 | `memory_archive` | 信息过期需保留历史 | 将旧记忆归档而非删除，保留历史轨迹 |
 | `memory_cleanup` | 确认数据异常 | 清理冗余/孤立节点（dry_run可预览） |
+| `memory_query_archived` | 回顾归档历史 | 查询已归档的原始关系记录（status=archived），支持天数/关键词过滤 |
 | `context_rewrite` | 单轮调用了 5 次及以上查询类工具 | 压缩本轮工具调用的 JSON 参数和返回结果，剔除工具噪声，节省上下文 token。**必须是回复前的最后一步** |
 
 ### 人设工具
diff --git a/core/tools/memory_tools.py b/core/tools/memory_tools.py
index 4ce2bb4..5919ea4 100644
--- a/core/tools/memory_tools.py
+++ b/core/tools/memory_tools.py
@@ -258,8 +258,24 @@ MEMORY_TOOLS = [
 - 按时间范围查看最近归档的历史
 
 【注意】
+- 只返回 status=archived 的原始关系记录，不包含活跃的「归档摘要」
 - days 和 keyword 可以单独使用，也可以组合使用
-- 不加任何参数时返回最近的所有归档记录
+- 不加任何参数时返回所有归档记录
+
+【示例】
+```
+# 不传参数：查全部归档
+memory_query_archived({})
+
+# 最近7天
+memory_query_archived({"days": 7})
+
+# 关键词过滤
+memory_query_archived({"keyword": "任务"})
+
+# 组合使用
+memory_query_archived({"days": 30, "keyword": "配置"})
+```
 """,
             "parameters": {
                 "type": "object",