0.4.2 完整原文摘录与快速双链体验修正

使用体验

• 快速双链先显示可选候选，再补齐相关原文，保留勾选、高亮和滚动位置。
• 原文摘录保留完整句子、链接、行内代码、引号和括号内容。长句用子句评分，再展示完整原句。无匹配时显示“暂无匹配原文”。
• 长摘录支持换行和滚动，PageUp / PageDown 用于阅读。弹窗适应可见区域和裁剪边界。
• 精简设置页，使用原生折叠分组。修正保存想法的快捷键。

验证

432 项单元与集成测试通过，类型检查、Lint 和生产构建通过。隔离 Obsidian 的基础流程，以及真实 QMD、既有 embedding 和重排服务的快速双链验收通过。测试使用合成笔记，不代表个人笔记库的相关性或延迟评估。

安装

下载 main.js、manifest.json、styles.css，放入笔记库的 .obsidian/plugins/aha-memory-surface/ 后重载插件。保留原有 data.json。

QMD 仍需单独安装和建立索引。远程推理的数据去向见仓库 docs/data-flow.md。

0.4.1 修正相关原句与悬浮提示

修正快速双链的原文摘录

不再把检索片段的第一行当成相关句子。快速双链会读取经过路径校验的候选正文，排除元数据、隐藏批注、代码和规划段落，再按查询选择原文片段。配置了 QMD 远程重排服务时，使用该服务对原句评分，不生成改写摘要。

README 和路径／标题中明确的计划、规划等笔记不会进入快速双链候选。候选池适度扩大用于排除后补位，界面仍最多显示四条。

移除冗余悬浮提示

鼠标停留时不再显示“相关笔记”和“取消插入双链”的浮动提示。键盘高亮、无障碍名称和读屏播报保留。

边界与验证

选句最多两轮，共享 2.5 秒时限。超出预算或服务不可用时，只使用查询词命中的正文，无法匹配则仅显示标题。该过程不承诺任意长度笔记的全篇语义最优。

选句会将查询和候选原文片段发送到现有 QMD 远程重排端点。未增加新的服务提供方；数据去向已更新到 docs/data-flow.md。

403 项单元／集成测试通过，两个外部服务 E2E 未启用。真实 Obsidian、QMD 和重排服务验收通过，覆盖中文改述、原文摘录、候选排除、悬浮提示和原有保存流程。

修复共享核心构建产物的并发写入问题，避免并行测试或工具读到未完成的文件。

0.4.0 — 快速双链与自动索引

写作时快速插入双链

新增 Aha: Insert related links 命令，可在 Obsidian 快捷键设置中绑定。使用选中文字，或当前／上一段作为输入，通过一次 QMD 语义检索提供最多四条候选。光标旁的小列表支持多选、Enter 插入、Esc 取消和一次撤销。

按新增笔记自动更新索引

新增可选的自动索引设置，默认关闭，默认阈值为十篇新增 Markdown 笔记。达到阈值后依次执行 update 和 embed。重启保留待处理记录，失败保留计数，手动与自动共用同一任务，运行期间新增的笔记不会丢失。

可靠性与验证

修正 QMD 特殊文件名解析和原生双链格式，补充键盘无障碍播报。提供项目内 Obsidian 验收技能，覆盖真实 QMD、双链插入和索引维护。

常规校验通过 386 项测试，两个外部服务 E2E 未启用。发布前使用独立 Obsidian、临时笔记和真实 QMD 完成界面验收。

数据去向

QMD 全文与向量索引位于本机。配置远程 embedding 时，笔记原文分块会发送到该服务；服务器能够读取请求文本。自动索引默认关闭，候选排除文件夹不等于索引隐私过滤。详见仓库 docs/data-flow.md。

附件包含 Obsidian 插件所需的 main.js、manifest.json、styles.css 和 versions.json。

0.3.1 — 精简已保存面板

精简「已保存」列表，让笔记链接和用户写下的想法更容易阅读。

• 移除「复制 Markdown」按钮。
• 笔记链接沿用当前主题的蓝色，并提高深色背景下的对比度。
• 首次标记 Surprise 的日期移至操作行右侧，以小号灰字显示「标记于 8月30日」；悬停可查看完整时间。

已通过类型检查、构建和真实 Obsidian 界面验证。

0.3.0 — 将 Surprise 想法保存到当前笔记

点击 Surprise 后，可以直接写下自己的想法，再点「保存」。Aha 会在本次检索对应的当前笔记末尾写入历史笔记双链和用户文字；再次保存会更新同一段。

使用体验

• 笔记正文只增加双链和用户写下的想法，不增加标题、标签、AI 解释或隐藏标记。
• Surprise 本身只做标记，点击「保存」才写入笔记。
• 顶部「已保存」支持查找、补写和复制；此前保存在插件中的想法不会自动批量写入笔记，可逐条点击「保存」。
• 保留原笔记其他内容。切换标签页不会改变写入目标；遇到正文手动改动或定位歧义时保留输入并提示，避免覆盖。
• 写入失败可重试；即使笔记已经写入而插件状态保存失败，重载后也能恢复最新输入，避免重复追加。

验证

• npm run verify：369 项测试通过，包括类型检查、Lint 和构建。
• 真实 Obsidian：追加格式、原段修改、重复保存、切换笔记、双链解析、写入失败、重载重试与手动编辑冲突。

安装

下载 main.js、manifest.json、styles.css，放入笔记库的 .obsidian/plugins/aha-memory-surface/ 后重载插件。保留原有 data.json。

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

按架构评估报告的三个候选做模块化：把 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。

0.1.0 — 基线

Aha 记忆界面插件的基线发布，对应 internalize-pipeline 分支的 944e054。

这一版把检索编排完全内化进插件 TypeScript（ADR-0005 的共享 core），可作为 0.2.0 之前的回滚点。

本版包含

• Capability Tier：Neighborhood / Recall / Full 三层，以及 Full Tier 的 Runtime Tier Fallback
• Relation Judge 的 weak 候选回填与更自然的关系说明
• Review Panel 恢复已保存的高亮与可点击控件
• 单一结构化 Pipeline Trace（ADR-0003），插件与批量运行共用
• 批量 vault 运行器转发 Obsidian 命令以支持链接/反链扩展

安装

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