Skip to content

0.2.0 — 检索、搜索轮设置与 Pipeline Trace 模块化

Choose a tag to compare

@Timisic Timisic released this 06 Sep 03:45
· 15 commits to main since this release

按架构评估报告的三个候选做模块化:把 Recall/Full 两个 Tier、插件与批量运行各自重复组装的逻辑,收拢进真正拥有它的 module。

行为变更

  • Recall Tier 现在真的会做图扩展。 之前它只跑 QMD,但自己的 summary(以及 CONTEXT.md 的 "Recall Tier" 定义)一直告诉用户图扩展已经运行过 —— 链接/反链邻居其实从未进入 Recall 轮次。现在 Recall 拿到和 Full Tier 相同的 metadataCache 邻居依赖。
  • 批量运行的配置语义与插件对齐。 批量运行器此前会用 "templates" 默认值覆盖被刻意清空的排除目录字段,并且完全没有转发 queryPromptOverride —— 也就是说批量轮次在静默地用内置 prompt 搜索另一份语料。
  • Full Tier 零候选的失败路径此前会丢掉 QMD 警告,现在会一并带上。

结构

  • core/memory-retrieval.ts 拥有检索顺序:QMD 执行 → 图扩展 → 边界过滤 → 池合并排序,Recall 与 Full 共用。
  • core/search-round-settings.ts 一处解释空值、默认值与 prompt 版本命名;sha256Hex 由调用方注入,core 保持无 node 依赖。
  • pipeline-trace.ts 新增 recordPipelineTrace,吸收两端重复的门控、构建、写入、引用回填与失败降级;fullPipelineTraceFields 收拢结果到 trace 的字段映射。

ADR-0003 的单一 trace schema 与 ADR-0004 的紧凑引用未变;ADR-0005 的 transport seam 不变。

验证

360 项测试全绿(新增 19 项)。新增覆盖:仅反链候选、排除目录同样作用于图邻居、图扩展失败降级为 warning、缺失依赖时静默跳过;一项 parity 测试用同一份设置对象分别走插件与批量两个 adapter 并断言二者一致;trace 的禁用形态、batch origin、写入失败保留成功轮次。

安装

下载 main.js、manifest.json、styles.css 放进
<vault>/.obsidian/plugins/aha-memory-surface/,然后重载 Obsidian。

回滚点见 0.1.0。