Memory Brain
Memory Brain 把会话里的事实存在 本机,并在之后的轮次注入相关条目。用标题栏的大脑图标打开,或 Knox: View Memory。
标签页:Overview、Memories、Sessions、Graph、Recipes、Settings。


全部在 ~/.knoxcoder 下的 sqlite(可用 KNOX_GLOBAL_DIR 覆盖)。没有云记忆、没有 embeddings、没有向量数据库、也 没有对记忆做神经 / LLM 重排。Docs 标签里的 Knox-MS 是 另一个产品。
回忆怎么工作
检索是 本地词法:
- sqlite FTS(BM25)
- Trigram 模糊重叠
- 基于规则的同义词组(最长匹配短语胜出)— 例如 invoice/tax → money,icon-only → a11y
- 知识图谱 游走相关实体
- 中文:FTS 里重叠的 CJK 双字,让中文查询打到 sqlite,而不是向量索引
Memories 行和 Overview 会显示某行 上一轮为何被注入,例如 injected last turn · lexical: jwt。
这是普通打分,不是一次模型调用。
存了什么
- 你 Remember、Create,或对话抽取的事实、偏好和决定(说出偏好/决定即可,不必说 “we decided”)
- 会话摘要(给 Use as context 用)
- 图谱实体和边
- 可选的 recipes(实验性,默认关)
写入前会 脱敏(API 密钥、PEM、KEY=value 等)。闲聊仍然 什么都不存。
Agent 工具 builtin_memory 只能 store / recall / search / delete / build_context / pin / unpin。管理动作(heal、export、run_pipeline 等)会 报错且不执行。导出 / 清空仍在命令面板。
上限
| 上限 | 默认 | 覆盖 |
|---|---|---|
| 每轮注入记忆 | 8000 token | KNOX_MEMORY_INJECT_CAP |
brain.sqlite(+ WAL) | 256 MB(268435456 字节) | knoxchat.memoryBrain.maxBytes 或 KNOX_BRAIN_MAX_BYTES(0 = 关闭该上限) |
超出大小上限时,最旧的 情节 轮次会被修剪;整理过的事实会保留。打开时和每次整理周期都会执行。
关闭开关
| 开关 | 范围 |
|---|---|
knoxchat.memoryBrain.enabled | 全局。关闭后跳过检索、自动整理和新写入。文件留在磁盘。 |
knoxchat.memoryBrain.workspaceEnabled | 本文件夹(工作区设置) |
KNOX_BRAIN_ENABLED=0 | 覆盖全局开关的进程环境变量 |
命令面板:Knox: Export Memory Brain / Knox: Wipe Memory Brain。
Settings 标签
产品旋钮(开关、范围、自动抽取、recipes、增强语义、注入上限)在 Memory 的 Settings 标签。λ / fusion / budget / compression / 模式乘数收在折叠的 Expert retrieval 里,可重置为默认。
Recipe 开关 不在 对话齿轮(Agent Settings)上。请用 Memory → Settings。
Memory Brain 与 Knox-MS
两者都遵循有界上下文,无界记忆:单次提示注入的内容有上限,存储的内容没有上限(下文的磁盘上限除外),检索是词法加图谱,绝不使用 embeddings。托管的 Knox-MS 2.0 还会随历史增长度量召回。见 Knox-MS 2.0 开发者文档。
| Memory Brain(本页) | Knox-MS 2.0(托管的 knox/knox-ms) | |
|---|---|---|
| 位置 | 本机 sqlite | 您的 Knox 账户 |
| 检索 | FTS / BM25、trigram、同义词、图谱遍历 | BM25、ripgrep、图谱(个性化 PageRank)、摘要树,按排名融合 |
| 单轮注入上限 | 8000 令牌(KNOX_MEMORY_INJECT_CAP) | 记忆预算 W_mem:无路由模型时默认 4,000 令牌,否则由模型窗口推导 |
| 遗忘 | 删除记忆,或在命令面板中清空 | 带墓碑的传播式擦除(见 Knox-MS 文档) |
Memory Brain(暂)不使用 Knox-MS 的参数集;两个存储相互独立,从不同步。
下一步
Memories 标签 · 会话作上下文 · 隐私