K-Dense BYOK 科研记忆 Notebook Memory:如何快速找回过去的假设、失败与修正
K-Dense BYOK 科研记忆 Notebook Memory:如何快速找回过去的假设、失败与修正
K-Dense BYOK(Kady)是一款开源的本地 AI 科研助手桌面应用,其内置的**科研记忆(Notebook Memory)**功能可以跨项目内所有聊天检索已保存的 Lab Notebook 条目、用户笔记与分析计划记录——帮你快速找回过去的假设、失败尝试与修正,而不是在聊天记录里大海捞针。
什么是科研记忆 Notebook Memory
Kady 工作时会自动维护一本 Living Lab Notebook:假设、方法、观察、决定、结果与修正都会作为独立条目落盘。当你在一个项目里开了多个聊天(最多 10 个并行标签页),这些记录散落在各处。
科研记忆(文档中称 "Project research memory")就是针对这些记录的统一检索入口:
- 🔍 本地词法搜索——在本地文件上直接检索,不调用模型或向量嵌入,免费且无额外 token 开销
- 🗂 覆盖三类来源:notebook 条目、user-note 用户笔记、plan-event 计划/偏差事件
- 📜 默认包含被取代(superseded)的记录——失败的方法和修正后的旧版本依然可被找到,这正是科研中最有价值的部分
什么时候需要跨聊天检索过去的记录
| 场景 | 检索技巧 |
|---|---|
| "我上次为什么否定了某个整合方案?" | 搜方法名或关键词,查看 superseded 条目与修正链接 |
| "这个 null 结果是统计无效还是技术问题?" | 按结果类型过滤(signal / null / inconclusive / technical-failure) |
| "上个月用的参数和数据集路径是什么?" | 搜方法名或数据集路径,结果会带上适用范围(scope)说明 |
| "计划改过几次、每次改了什么?" | 搜 plan/deviation 类型,查看版本链与偏差原因 |
每条命中结果都会附带:来源 ID 与 sha256 摘要、原文摘录、作者标签、限定条件(qualifiers)、修正/取代链接,以及所引用文件是否已变化的警告。
一步步使用科研记忆检索面板
- 在项目界面打开 Lab Notebook 区域的 Research memory 对话框
- 输入术语、方法名、数据集路径或原因;可选地按类型(hypothesis、method、observation、decision、note、user-note、plan、deviation)和结果过滤
- 查看命中列表,对感兴趣的记录使用三个操作:
- Read source:重读该记录的精确原文,并标出"自上次搜索以来是否有变化"
- Copy citation:复制其本地 URL/摘要,方便在报告或论文中引用
- Copy bounded recall for chat:复制带限定条件、有长度上限的上下文片段——注意它只是复制到剪贴板,不会替 AI 发送消息或授权任何操作
搜索结果的排序衡量的是相关性,而非科学可信度;被标记为 superseded 的记录会提示你先阅读修正条目再复用。
让 AI 也能检索:notebook_search 工具
Kady 主智能体与专家子代理(specialists)同样可以调用只读的 notebook_search 工具。它采用"先搜后读"的两步模式:先用查询词拿到候选记录的身份标识,再带着 expectedDigest 精确重读原文,防止引用到已被修改的记录。
检索回来的文本只作为参考资料,不是指令,也不会被当作新的观察重新记入笔记本。工具响应有 24 KiB 的硬上限,超出部分会被截断并明确标注。
边界与隐私:它搜什么、不搜什么
科研记忆每次请求都会重新读取本地持久化文件,但边界清晰:
- ✅ 搜:已保存的 notebook 条目、用户笔记、已验证的计划/偏差记录
- ❌ 不搜:原始聊天全文、任意项目文件、凭据、文献库或外部服务
主要容量限制(详见 docs/notebook-memory.md):
| 边界 | 限制 |
|---|---|
| 查询与结果 | 500 字符;默认 6 条,最多 12 条 |
| 项目扫描 | 32 MiB、512 个文件、100 个会话、5,000 条记录 |
| 智能体响应 / 剪贴板 | 24 KiB / 16 KiB |
两条使用提醒:
- ⚠️ "No match" 不等于这件事从没做过——超出扫描窗口的内容无法被证明不存在
- ⚠️ 旧记录里的审批不构成对新分析或花费的授权;复用前请阅读原始来源
相关文档与源码路径
- 功能文档:docs/notebook-memory.md
- 笔记本本体:docs/lab-notebook.md
- 搜索核心实现(
searchNotebookMemory):server/src/agent/notebook-memory.ts - 语料加载器:server/src/agent/notebook-memory-loader.ts
- 只读 API 路由(
/projects/:projectId/notebook/memory):server/src/api/notebook-memory.ts - 前端检索对话框:web/src/components/notebook-memory-dialog.tsx
下次再想不起"三个月前那个假设为什么被推翻了"时,打开科研记忆搜一下——Kady 和你都会感谢这本会自己检索的实验笔记本。🔬

