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