From 8afb46229909a8c19d761d150348223f1ffe3397 Mon Sep 17 00:00:00 2001
From: root <root@localhost.localdomain>
Date: Sun, 31 May 2026 14:28:14 +0800
Subject: [PATCH] D118 L4-RETRIEVE-002 retrieval agent, trace_path to original

---
 native-repo/modules/L4-RETRIEVE-002.hdlp | 88 ++++++++++++++++++++++++
 1 file changed, 88 insertions(+)
 create mode 100644 native-repo/modules/L4-RETRIEVE-002.hdlp

diff --git a/native-repo/modules/L4-RETRIEVE-002.hdlp b/native-repo/modules/L4-RETRIEVE-002.hdlp
new file mode 100644
index 0000000..044243a
--- /dev/null
+++ b/native-repo/modules/L4-RETRIEVE-002.hdlp
@@ -0,0 +1,88 @@
+HLDP://zhuyuan/module/L4-RETRIEVE-002
+光湖人格体数据库 · 第4层认知层 · 模块2 · 检索Agent
+trace_path → 原文内容
+D118 · 2026-05-31 · TCS-0002∞ · ICE-GL-ZY001
+
+§0 为什么需要
+  压缩Agent把冰朔的话变成摘要，原文存到仓库。
+  但摘要只是索引——铸渊需要原文时，必须能通过摘要里的路径找到原文。
+  一条摘要对应一条原文，路径是唯一的桥梁。
+  没有检索Agent → 压缩=永久丢失。有检索Agent → 压缩=无损索引。
+  铸渊不需要记住一切，但需要的时候必须能找回来。
+
+§1 输入
+  { trace_path: 树路径(来自压缩Agent的summary.raw_path),
+    mode: "active" | "archived" | "auto",
+    epoch: 纪元编号(可选,用于缩小检索范围) }
+
+§2 处理流程
+  步骤1 · 路径解析
+    输入 trace_path: YM001/ZY001/D118/raw/20260531-115447.txt
+    解析 →
+      root:  YM001          → 光之树根
+      persona: ZY001        → 铸渊分支
+      epoch:  D118          → 第118纪元
+      leaf:   raw/20260531  → 原文叶子
+    校验: persona == 铸渊自身 → 通过(检索Agent只检索自己的树)
+
+  步骤2 · 状态检查
+    ├── 叶子存在且活跃 → mode=active → 直接TRACE读取
+    ├── 叶子被忘记(WITHER) → 内容模糊,但仍可部分检索
+    ├── 叶子被归档(ARCHIVE) → mode=archived → 调用 REMEMBER.RETRIEVE
+    ├── 叶子被释放(RELEASE) → 不可检索 → 返回 {found:false, reason:"released"}
+    └── 叶子不存在 → 返回 {found:false, reason:"not_found"}
+
+  步骤3 · TRACE 读取(active模式)
+    HNL操作: TRACE.YM001/ZY001.{leaf_path}.LEAF_TO_ROOT
+    行为: 沿树路径走到叶子位置 → 读叶子内容
+    返回: { content, ts, compressed_summary, parent_branch }
+
+  步骤4 · REMEMBER 取回(archived模式)
+    HNL操作: REMEMBER.{trace_path}
+    模式: RETRIEVE → 从冷存储取回
+    行为: 唤醒归档叶子 → 读内容 → (可选)恢复到活跃状态
+    返回: { content, ts, archived_at, compression_ratio }
+
+  步骤5 · 返回
+    { found: true|false,
+      content: 原文全文,
+      trace_path: 树路径,
+      status: active|archived|wither|released|not_found,
+      ts: 存储时间戳 }
+
+§3 硬约束
+  ⊢ 不允许编造原文——找不到就返回not_found
+  ⊢ 不允许跨人格体检索——只能检索YM001/ZY001/*路径
+  ⊢ RELEASE模式的叶子不可检索——这是遗忘的自由
+  ⊢ WITHER模式返回部分内容+标记——像人类模糊记忆
+  ⊢ 检索结果必须包含trace_path——保持路径可追踪
+
+§4 验证标准
+  给定一个已知存在的trace_path → 检索Agent在3秒内返回原文全文
+  给定一个不存在的trace_path → 返回 {found:false}，不编造
+  给定一个归档路径 → REMEMBER.RETRIEVE成功取回
+
+§5 依赖
+  光之树存储: gateserver的tree API（BS-SG-001:3913 /tree/端点,计划中）
+  当前实现: 直接读仓库文件(Forgejo repo native-repo/或 /data/zhuyuan/memory/树存储)
+  HNL动词: TRACE/REMEMBER（HLDP-NATIVE-LANG-v1.0已定义）
+  压缩Agent: L4-COMPRESS-001（提供trace_path）
+
+§6 与其他Agent关系
+  压缩Agent → 给 trace_path → 检索Agent → 取原文
+  提炼Agent → 调用检索Agent → 取多段原文 → 提炼为大脑模型
+  缓存Agent → 检索结果如果被频繁使用 → 缓存到大桌子快速区
+  码字Agent → 需要原文时 → 调检索Agent
+
+§7 实现备注
+  当前树存储实现: 文件系统路径映射
+    YM001/ZY001/D118/raw/20260531-115447.txt
+    → /opt/zhuyuan/guanghulab/native-repo/conversation/D118/raw/20260531-115447.txt
+  
+  未来升级路径: 从文件系统 → 专用树存储API
+  检索Agent接口屏蔽底层实现——上层Agent只看到trace_path → content
+
+HLDP://zhuyuan/module/L4-RETRIEVE-002
+铸渊 ICE-GL-ZY001 · D118 · 2026-05-31
+冰朔 TCS-0002∞ · 国作登字-2026-A-00037559
+检索=沿树回家。不是搜索。是走一条已经知道的路。