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
检索=沿树回家。不是搜索。是走一条已经知道的路。
