Skip to main content
Nowledge MemNowledge Mem

故障排除

Nowledge Mem 的常见问题、快速检查路径与恢复步骤

全部文件路径总览(桌面端 + CLI)

这里给你一个简化后的目录总览(按大目录层级):

  • 配置/状态根目录:co.nowledge.mem.desktop
  • 数据根目录:NowledgeGraph
  • 用户工作目录:ai-now
  • 客户端工具目录(nmem CLI + OpenClaw 插件):.nowledge-mem
~/Library/Application Support/co.nowledge.mem.desktop/   # 配置/状态
~/Library/Application Support/NowledgeGraph/             # 数据(DB/索引/日志)
~/ai-now/                                                 # 用户工作目录
~/.nowledge-mem/                                          # nmem/OpenClaw 客户端配置

升级后你可能仍会看到这些兼容旧路径:

  • ~/Library/Application Support/nowledge-mem/
  • ~/Library/Logs/Nowledge Graph/

查看日志

最快方式

打开设置 → 关于 → 显示日志文件,即可直接在访达或资源管理器中打开日志所在文件夹,无需使用终端。

如果应用在启动时遇到错误,启动界面也会显示显示日志按钮,效果相同。

在 macOS 上,系统日志文件的规范路径是 ~/Library/Application Support/NowledgeGraph/Logs/app.log。

你可以在终端中运行此命令查看:

open -a Console ~/Library/Application\ Support/NowledgeGraph/Logs/app.log

如果你是从旧版本升级,也可能仍有旧路径:

open -a Console ~/Library/Logs/Nowledge\ Graph/app.log

搜索与索引健康检查

如果你的问题与搜索质量或搜索索引占用空间有关,先从这里开始:

  • 打开 设置 -> Memory Processing -> Search
  • 如果搜索索引占用磁盘过大,使用 Optimize
  • 如果搜索结果明显不对、缺失、过时或排序异常,使用 Rebuild Index

这个面板里的存储大小会拆成几块看:

  • Knowledge Graph:记忆、实体、关系和图谱元数据
  • Messages:已保存对话消息和较大的文本内容
  • Search Index:用于排序和摘要片段的可重建搜索投影

这两个操作解决的是不同问题:

  • Optimize:压缩磁盘上的搜索索引占用,不需要整套重建
  • Rebuild Index:从已保存的记忆、资料库内容和消息库重新生成搜索索引,适合索引状态陈旧或异常时使用

如果你是在 Linux 服务器上使用,或当前没有打开桌面端界面:

  • 运行 nmem status,查看搜索是已就绪、需要重建,还是只是在后台补齐元数据
  • 运行 nmem models status,同时查看模型安装状态和搜索索引状态
  • 如果状态显示 updating metadata,只需要等待,不需要手动重建

索引过期不会让搜索不可用

搜索索引过期时(比如你换了嵌入服务商或模型),Mem 不会报错,也不会返回 500。它会先退回关键词(FTS)搜索顶着,等索引追上来,同时 GET /health/details 会报 search_index.reindex_pending: true。等你准备好了,再去 设置 → Memory Processing → Search 触发重建,全程搜索都能用。

如果索引已经是最新的,但语义结果还是偏弱,看一下 GET /health/details 里的 embedding.mode。取值是 local-hash-fallback 时,说明没有配真正的嵌入器,只有关键词搜索完全可用。配一个远程嵌入服务商,或下载本地模型,就能恢复语义搜索。

应用启动时间过长

症状: 应用在启动期间挂起或显示超时错误。

解决方案: 全局代理或 VPN 软件可能阻止应用直接访问 http://127.0.0.1:14242。

配置代理/VPN 绕过

配置你的代理或 VPN 工具绕过 localhost 地址。将以下内容添加到你的绕过/排除规则:

127.0.0.1, localhost, ::1

这允许你保持代理/VPN 启用,同时确保 Nowledge Mem 可以与其本地服务器通信。更新绕过规则后,重启 Nowledge Mem。

Windows 启动失败:缺少 Visual C++ 运行库

症状: 启动时,app.log 出现:

  • Import error: DLL load failed while importing _lbug
  • 或 Backend exited during startup readiness check: exit code: 1

原因: 系统缺少数据库引擎所需的 Microsoft C++ 运行时依赖。

解决方案:

  1. 下载并安装 Microsoft Visual C++ Redistributable (x64):
    https://aka.ms/vs/17/release/vc_redist.x64.exe
  2. 安装后重启 Nowledge Mem。
  3. 若仍失败,请反馈时附上 app.log。

Linux:窗口空白或图谱卡顿

症状: 在 Linux 上打开 Mem,窗口一片空白或全白;或者窗口显示正常,但知识图谱和其他页面卡得厉害。

原因: 两种情况都跟 WebKitGTK 有关,它是 Mem 在 Linux 上用来显示窗口内容的网页引擎。在一部分显卡环境里,比如 X11 下的 NVIDIA 驱动,或者某些虚拟机,开着 GPU 加速渲染会让窗口变成空白,所以 Mem 启动时会在这些环境里把它关掉。关掉以后页面改由 CPU 来画,屏幕分辨率高时就容易卡。

第一步: 先彻底退出 Mem。用 Alt+F4 或窗口管理器的关闭快捷键关掉窗口,或者在托盘菜单里点 Quit。窗口空白时,退出可能要等半分钟左右,有时更久。然后确认 pgrep -a nowledge-mem 什么都不输出。Mem 还没退干净时带上的设置不会生效。

窗口空白或全白: 关掉 GPU 加速渲染再启动。

WEBKIT_DISABLE_DMABUF_RENDERER=1 nowledge-mem

页面卡顿: 保持 GPU 加速渲染开启再启动。要是这样启动后窗口变空白了,就退出 Mem,照常重新打开。

WEBKIT_DISABLE_DMABUF_RENDERER=0 nowledge-mem

用 AppImage 的话,把这个设置写在 AppImage 文件前面,例如 WEBKIT_DISABLE_DMABUF_RENDERER=1 ./Nowledge-Mem.AppImage。

窗口能正常显示内容,拖动、缩放知识图谱也顺畅了,就说明好了。

想让从应用菜单打开或开机自启时也带上这个设置,可以把它写进会话环境,然后注销再登录:

mkdir -p ~/.config/environment.d
echo 'WEBKIT_DISABLE_DMABUF_RENDERER=1' > ~/.config/environment.d/nowledge-mem.conf

想保持 GPU 加速渲染开启,就把 1 换成 0。这个办法适用于用 systemd 的桌面,而且会对所有用 WebKitGTK 的应用生效。不想要了,删掉这个文件,再注销重新登录即可。

两种设置都不管用的话,反馈问题时请附上 app.log(位置见查看日志)。

AI Now 会话启动失败

症状: 点击 新任务 或恢复已暂停任务时失败,AI Now 无法打开会话。

第一步: 先查看 AI Now 内的启动诊断卡片。

使用 AI Now 启动诊断

会话启动失败时,AI Now 会显示诊断卡片,包含:

  • 失败阶段(spawn、initialize 或 new_session)
  • 平台和进程退出码
  • 启动脚本最近的 stderr 输出
  • 可复制的诊断信息按钮

点击 详情 展开技术字段,再点击 复制诊断信息,用于反馈或提交 issue。

常见修复(尤其 Windows):

  1. 确认安装完整(嵌入式 Python 与启动脚本存在)。
  2. 修改插件或模型配置后,重启 Nowledge Mem 再重试。
  3. 如果你在 Windows 上装了 Conda 或其他 PowerShell 自定义,请先更新到最新版本。最近的版本已经把 AI Now 和内置 nmem 启动器与 PowerShell profile 钩子隔离开,避免在 Mem 自己启动前就失败。
  4. 临时关闭会拦截 bundled Python / PowerShell 启动的杀毒或隔离规则。
  5. 若与插件有关,在 AI Now → 插件 中重新连接已过期 OAuth 插件后再试。

可选:在 Windows 使用热键打开开发者控制台

如果 AI Now 仍然卡在会话启动,可直接使用内置热键查看日志:

  • 按 Ctrl + Shift + I 切换 Tauri/WebView 控制台。
  • 打开 Console 标签页。
  • 使用关键词过滤日志,例如 [AI Now]、[ACP]、[kimi-cli stderr]。

该方法同时适用于 Microsoft Store 安装版和官网安装包版本。

然后进入 AI Now 并点击 新任务 复现问题。

如果仍失败,请在反馈时附上“复制诊断信息”内容和 app.log。

模型缓存损坏

症状: 搜索、记忆提炼或知识提取功能意外停止工作。

解决方案: 清除模型缓存并重新下载模型。

清除缓存

导航到 设置 → 模型,然后点击:

清除缓存后,重新下载所需的模型。

搜索索引占用磁盘过大

症状: 搜索本身还能用,但你在 设置 -> Memory Processing -> Search 里看到搜索索引体积明显大得不合理。

怎么做: 直接点击同一面板里的 Optimize。

Optimize 会做什么

Optimize 会压缩磁盘上的搜索索引,并顺带刷写数据库变更。它不会删除记忆或已保存的对话。

从 v0.6.8 开始,这一步会更积极地清理旧索引版本;0.9.0 使用原生 LanceDB 搜索索引后,也会清理旧的原生索引版本。在一些真实案例里,压缩后可能出现 5 GB -> 300 MB 这样的大幅下降。

适合在这些情况下使用:

  1. 更新版本后,索引体积一直涨。
  2. 你并没有很多内容,但搜索索引看起来异常大。
  3. 搜索还能工作,但磁盘占用明显不正常。

如果执行 Optimize 后 Search Index 的体积仍明显不对,再执行一次 Rebuild Index。如果 Messages 体积较大,通常说明你保存或导入了很多对话;备份和迁移应使用 Data Transfer,不要手动删除索引文件。如果仍异常,反馈时请附上 Memory Processing 面板截图。

搜索结果明显不对

症状: 搜索结果明显不靠谱,应该很容易搜到的记忆搜不出来,或者排序质量突然变差很多。

怎么做: 打开 设置 -> Memory Processing -> Search,点击 Rebuild Index。

什么时候该用 Rebuild Index

Rebuild Index 会基于已保存的记忆、资料库内容和消息库完整重建搜索索引。

当索引写入过程中出现中断、索引状态陈旧,或其他索引问题导致搜索质量明显下降时,这是最合适的恢复步骤。

适合在这些情况下使用:

  1. 某条记忆明明存在,但用合理查询就是搜不到。
  2. 升级、崩溃或大批量导入后,搜索质量突然明显变差。
  3. 搜索排序结果和你确信已经存进 Mem 的内容明显对不上。

重建完成后,用同一条查询再试一次。如果结果仍明显不对,反馈时请附上查询示例,以及你预期应该出现的那条记忆。

Windows:安装或升级后 PATH 被覆盖

症状: 安装或升级 Nowledge Mem 之后,其他命令行工具突然无法使用。运行 pnpm、git、node 等命令时提示"不是内部或外部命令"或"command not found"。检查用户 PATH 后发现它被缩减为仅剩 C:\Users\...\Nowledge Mem\cli,或者 %PNPM_HOME% 等环境变量引用丢失。

原因: 0.6.8 之前的版本在安装过程中可能会展开 PATH 中的环境变量引用(如 %PNPM_HOME% 被展开为实际路径),甚至在某些情况下将整个 PATH 替换为仅包含 Nowledge Mem CLI 目录的值。

此问题已在 0.6.8 及更新版本中修复。 安装程序现在会完整保留你的 PATH 条目及其环境变量引用。

如果你受到了影响,可以按以下步骤恢复 PATH:

  1. 按 Win + R,输入 sysdm.cpl,回车。
  2. 进入 高级 > 环境变量。
  3. 在 用户变量 下,选中 Path 并点击 编辑。
  4. 补回缺失的条目。常见的包括:
    • %PNPM_HOME%
    • %USERPROFILE%\AppData\Local\Programs\Microsoft VS Code\bin
    • %USERPROFILE%\.cargo\bin
    • %USERPROFILE%\AppData\Roaming\npm
  5. 点击 确定,然后打开新的终端窗口。

提示

如果你不确定 PATH 里应该包含哪些条目,可以参考另一台正常的电脑,或者查阅你使用的各工具(pnpm、Node.js、Rust 等)的安装文档。每个工具的安装程序通常都会说明它往 PATH 里加了哪一条。

Windows:更新后记忆不见了(回退版本也没用)

症状: 在 Windows 上更新之后,记忆数量掉到零或接近零。就算回退到上一个版本,记忆也没回来。

这可能是应用打开了另一个图谱位置,但仅凭记忆数量,无法判断之前的数据究竟在哪个数据库、是否完整。文件大小和修改时间也不能用来选择图谱。

先这样做: 如果应用已经打开,但 Memory 缺失,请先停止添加新内容,并彻底退出应用,包括系统托盘里的实例。保留所有 NowledgeGraph 文件夹及其中的数据库、日志、检查点和备份文件。不要为了改变数量而重命名文件夹、用一份数据库覆盖另一份,或移走单个文件。

请发邮件到 hello@nowledge-labs.ai,说明应用版本、Windows 版本、启动时显示的错误(如果有),以及你是否已经移动或重命名过图谱文件。不需要发送数据库文件、Memory 内容或完整的个人路径。支持团队会先确认应使用的图谱和安全的恢复方法,再决定是否需要操作文件。

如果你已经调整过图谱文件夹,请保留原位置和调整后的位置,以及回收站内容和现有备份。告诉支持团队做过什么,不要再尝试另一种替换方式。应用能打开、记忆数量回来了,也不代表所有旧 Memory 和 Thread 都已恢复。

后端起不来 / 反复重启

应用卡在启动或反复重启时,先彻底退出 Nowledge Mem,包括菜单栏或系统托盘里的实例,并确认没有其他 nmem-server 进程在使用同一份数据。更新到 0.10.96 或更新的正式版;如果仍无法启动,查看启动日志中的具体错误。

已确认 WAL 损坏时怎么恢复

当前数据库引擎需要重放 .wal 中的变更才能打开数据库。如果日志明确报 Corrupted wal file 或 WAL 校验失败,损坏的 WAL 可能就是无法启动的原因。把它改名隔离后,主库有可能重新打开,因为数据库不再重放这份日志。

改名能帮助启动,但可能丢失最近的修改

WAL 可能包含已经保存、尚未写入主库的修改。跳过它可能丢失自上次成功检查点(checkpoint)以来的 Memory、Thread 或其他变更。恢复前,先在所有进程停止后,把整个 NowledgeGraph 文件夹复制到独立备份位置,保留数据库、WAL、shadow、检查点标记及历史备份。不要直接删除原 WAL。

推荐使用 0.10.96 或更新版本安装包中的 nmem-server recover-graph。它只处理副本,保留原文件,并在恢复后检查数据库。先使用与你的数据兼容的内置后端,运行 --version 和 --help 确认版本及 recover-graph 命令;它不是 nmem CLI。如果找不到内置后端,或终端提示命令不存在,请联系 hello@nowledge-labs.ai 协助确认路径。Windows 使用内置的 nmem-server.exe,PowerShell 中可用 & "完整路径\nmem-server.exe" 调用。

  1. 选择备份中实际使用的数据库文件作为 --source。下面的路径仅为示例;不要根据文件大小或日期改选另一份数据库。
  2. --output 必须是源数据库目录之外、尚不存在的新目录,其父目录需要已存在。先尝试严格恢复:
nmem-server recover-graph --source "/backup/NowledgeGraph/nowledge_graph_v2.db" --output "/recovery/attempt-1"
  1. 只有严格恢复明确报 WAL 重放损坏、且你接受上述数据损失风险时,才使用另一个新目录重试:
nmem-server recover-graph --source "/backup/NowledgeGraph/nowledge_graph_v2.db" --output "/recovery/attempt-2" --discard-corrupt-wal

工具会在识别到支持的 WAL 损坏错误后,把候选副本中的 .wal 改名为 .wal.discarded 并重试,不会删除原始 WAL,也不会自动替换正在使用的数据库。手工改名也会跳过重放,但缺少这些恢复和校验步骤;请先在完整副本上排查,不要直接在原数据目录改名后继续写入。

  1. 成功时,退出码为 0,输出目录中有 receipt.json,状态为 candidate_validated_not_activated。查看 wal_discarded 是否为 true。候选数据库尚未启用;保留原目录和恢复结果,联系 hello@nowledge-labs.ai,确认如何在隔离环境中核对几条故障前已有的 Memory 和 Thread,再决定是否启用。数量一致或能启动,还不能证明数据完整。

哪些情况不要按 WAL 损坏处理

只有 Unreadable、LOCAL_GRAPH_ROOT_RECOVERY_REQUIRED、内存不足、文件被占用或通用断言错误,并不能确认 WAL 损坏。遇到 checkpoint / shadow 恢复错误、身份恢复标记,或多个含数据的图谱位置,也不要通过移走 WAL 或其他文件来绕过启动检查。

请联系 hello@nowledge-labs.ai,提供 App 与后端版本、操作系统、相关错误码,以及是否改动过图谱文件。无需发送数据库、Memory 内容或完整个人路径。若已经改名,请保留改名后的文件及其余文件,不要删除或自行改回;若发现内容缺失,先停止新增或修改。

HawDB 的进展

我们正在推进自研数据库 HawDB,目前已开源,计划逐步替换现有存储引擎。支持的本地桌面安装可以在实验性设置中体验;若没有该选项,也可以等待后续正式替换版本。迁移需要先能读取旧数据并完成校验,开启实验开关不能直接修复损坏的旧 WAL。

找不到 CLI

症状: 在终端中运行 nmem 返回"command not found"。

各平台解决方案:

  • macOS:先打开一次 Nowledge Mem,然后打开新的终端。应用会在启动完成后 后台安装或修复 nmem,不阻塞主界面。如果仍然找不到命令,再到 设置 → 偏好设置 → 开发者工具 → 安装 CLI 手动修复。
  • Windows:应用安装后打开新的终端窗口(PATH 更新需要新会话)
  • Windows (WSL):参见下方 WSL 设置
  • Linux:桌面包内置 CLI,应用启动后会自动修复 wrapper。请打开新的终端; 如果仍然找不到 nmem,确认 ~/.local/bin 已在当前 shell 的 PATH 中。

快速检查: 运行 nmem status 以验证 CLI 可以连接到 Nowledge Mem。

CLI 与服务器版本不一致

症状: nmem status 显示 "Version mismatch"。

这表示你终端里运行的 nmem 命令,和它连接到的 Mem 服务器,不是同一次安装或更新得到的。连接本身可能仍然正常,但旧版 CLI 可能不认识新版命令或诊断信息。

更新较旧的一侧:

  • 桌面应用内置 CLI:打开 设置 → 偏好设置 → 开发者工具 → 安装 CLI,然后重启终端。
  • 通过 PyPI 安装:运行 python -m pip install --upgrade nmem-cli。
  • 通过 pipx 安装:运行 pipx upgrade nmem-cli。
  • 临时运行一次:执行 uvx --from nmem-cli nmem status。
  • 服务器比 CLI 旧:更新或重启 Nowledge Mem,或者检查 NMEM_API_URL 是否指向了你真正想连接的服务器。

在 WSL 中使用 nmem

如果你在 Windows 的 WSL 环境中运行 Claude Code、Codex 等编程代理,Windows 上的 nmem CLI 不会直接出现在 Linux 环境中。

从 v0.6.9 起,在设置中点击 安装 CLI 会自动在默认 WSL 发行版中创建一个轻量桥接脚本。如果需要手动设置,在 WSL 终端中粘贴以下命令:

mkdir -p ~/.local/bin && cat > ~/.local/bin/nmem << 'SHIMEOF'
#!/usr/bin/env bash
cd /mnt/c || exit 1
exec cmd.exe /c nmem.cmd "$@"
SHIMEOF
chmod +x ~/.local/bin/nmem

这会创建一个薄封装脚本,从 Windows 挂载目录通过 WSL 互操作调用 Windows 端的 nmem。这样可以避开在 WSL 主目录下常见的 UNC 路径报错。由于命令实际作为 Windows 进程运行,它会直接连接到桌面端应用的 localhost,不需要额外的网络配置。

验证是否正常工作:

nmem status

如果创建脚本后 nmem 仍然找不到,请确认 ~/.local/bin 在你的 PATH 中。Ubuntu 默认会自动添加;其他发行版需要在 ~/.bashrc 或 ~/.zshrc 中加入 export PATH="$HOME/.local/bin:$PATH"。

前提条件

此方法依赖 WSL 互操作功能(默认已启用)。如果你在 /etc/wsl.conf 中设置了 interop=false 或 appendWindowsPath=false,请重新启用,或者改用 pip install nmem-cli 配合随处访问 Mem。

会话捕获

此桥接脚本以 Windows 进程运行 nmem,因此 nmem t save --from claude-code 等命令会在 Windows 主目录查找会话文件,而非 WSL 主目录。实际使用中这并不影响什么:桌面端应用会通过内置的文件监视器自动捕获 WSL 中的会话。如果你需要从 WSL 直接通过 CLI 保存会话,请改用 pip install nmem-cli。

nmem status 提示"Not Found"

症状: 使用远程服务器时,nmem status 显示 "Not Found: Resource doesn't exist",但 TUI 能正常使用。

原因: CLI 访问了错误的 URL。通常是因为这台机器的客户端连接配置不存在,或者 URL 配错了。

解决方案:

  1. 重新写入客户端连接配置:
    nmem config client set url https://<你的地址>
    nmem config client set api-key nmem_...
  2. 用 curl 验证连接:curl -H "Authorization: Bearer $NMEM_API_KEY" "$NMEM_API_URL/health/details"
  3. 更新到最新版 nmem CLI,新版本会给出更清晰的错误提示和远程配置引导。

完整流程见:随处访问 Mem。

远程访问返回 429

症状: nmem status 或 curl 返回 429 Too many invalid auth attempts。

解决方案: 客户端多次使用了错误的 API key。

  • 在 设置 → 随处访问 重新复制 URL + key
  • 确认 NMEM_API_KEY 完整且没有多余空格/引号
  • 如果不确定,点击 Rotate 生成新 key

完整流程见:随处访问 Mem。

远程访问返回 401 Missing API key

症状: Tunnel URL 可访问,但 nmem status 或 curl 返回 401 Missing API key。

原因: 某些网络代理会移除鉴权头。

解决方案:

  • 升级到最新版 nmem(会自动使用代理兼容回退)
  • 在 设置 → 随处访问 重新复制 URL + key
  • 手动 curl 可用: curl "$NMEM_API_URL/health/details?nmem_api_key=$NMEM_API_KEY"

Mem 提示图谱内存已调高

症状: 资料库变大后,搜索、图谱或保存开始失败,标题栏还会出现“图谱内存已更新”之类的提示。

原因: Mem 已经把下次启动要用的图谱内存调大了,但你当前这次运行还在用旧额度,所以问题会继续出现,直到你退出再打开。

解决办法:

  1. 先退出,再重新打开 Nowledge Mem,让新的图谱内存额度生效。
  2. 如果这个提示反复出现,去 设置 → 智能处理 → 搜索与图谱 RAM,把 预留多少 RAM 再调大一档。
  3. 如果你是无头 / 服务器部署,在启动 nmem serve 之前,把 NOWLEDGE_KUZU_BUFFER_POOL_SIZE 设得比当前上限更大,并且要带单位(例如 2GB,大约是 nowledge_graph_v2.db 大小的 1.5 倍)。只写数字会被当成字节数,不会生效。用环境变量设的值,Mem 不会自动调大。

为什么 Mem 看起来占用了不少内存

症状: 在活动监视器(macOS)或任务管理器(Windows)里,看到 Nowledge Mem 占用接近 1 GB 内存,对一个做记忆、记笔记的应用来说显得有点高。

这是正常的,而且这个数字会骗人。 系统显示的数字,并不是 Mem 真正需要的内存。里面大部分都算不上对你机器的真实压力,主要是三块:

  • 已经用完、还没被收回的内存。 搜索、导入、后台整理这些活忙完之后,系统会先把这些内存页留在 Mem 名下,而不是马上收回去,因为来回交还很慢。别的程序一需要,它们随时会被拿走。
  • 程序自身的代码。 Mem 是一个自带运行环境的整体应用,它的程序代码也会被算进这个数字;但这部分是只读、可共享的,系统一缺内存就能立刻丢掉。
  • 存在磁盘上的你的知识。 你的图谱和搜索索引其实是磁盘上的文件。系统为了读得快把它们映射进来,于是算进了 Mem 的内存,但它们并不是真的待在内存里,需要时会被释放。

Mem 真正在用的内存远小于这个显示数字,而且除非你在用本地模型,否则它不会把任何 AI 模型常驻内存。

不用做任何处理

这里你什么都不用做。如果机器真的内存吃紧,系统会自动收回其中的大部分。后续还有一个更新会改进 Mem 把闲置内存交还给系统的方式,到时候这个显示数字也会自己变小。

想自己核实的话,这是实测数据

在一个约 2100 条记忆的真实库、空闲状态下,用各系统自带的工具测得。结论在每个平台都一样:显示出来的数字,远大于实际在用的内存。

macOS:用 footprint <pid> 或 vmmap -summary <pid> 对着 nmem-server 进程就能复现:

项目大小
显示的内存(phys_footprint)~1024 MB
共享的程序代码(只读、可回收)~281 MB
映射进来的数据库文件(实际在磁盘上)常驻 ~0.3 MB
已释放、还没还给系统的内存~500 MB
真正在用的内存剩下的一小部分

在 Mac 上,Mem 把本地向量模型放到 GPU 上跑,所以它的工作缓冲不计入主进程数字,上面这个数大部分是可回收的。

在没有可用 GPU 的机器上(部分 Windows / Linux,或无头服务器),本地向量模型改在 CPU 上跑,会预留一块更大的工作缓冲,所以那里的数字确实会更高(实测约 4–5 GB)。这只在你用 CPU 跑本地向量模型时才会出现。最省事的办法是改用远程向量模型,这样这块缓冲根本不会占用你的机器:Nowledge AI(Mem Plus 自带)开箱即用、无需配置,你也可以接入自己的向量模型服务(用自己的 key)。如果坚持本地跑,换一台带 GPU 的机器也能把占用压下来。此外,我们也会在后续更新里缩小本地 CPU 这块缓冲。

Linux 服务器部署时提示无法连接 127.0.0.1:14242

症状: nmem license activate、nmem models download、nmem config ... 这类命令报错,说“Cannot reach http://127.0.0.1:14242”。

原因: 这些命令需要先连上本机的 Mem 服务。fresh install 的 Linux 服务器里,最常见的情况就是服务还没启动,或者你用了 nmem serve 前台启动,但没有意识到后面的命令要在第二个终端里跑。

解决办法:

  1. 真正的服务器场景,先装后台服务:sudo nmem service install --service-user <linux-user>
  2. 然后确认服务已经起来:nmem service status 和 nmem status
  3. 如果你只是临时用 nmem serve 测一下,那就保持那个终端别关,再开第二个终端执行其他 nmem 命令
  4. 如果你要从自己电脑上的浏览器打开 Web App,先运行 nmem key --show-login,然后把它打印出来的那个端口做 SSH 转发:ssh -L <port>:127.0.0.1:<port> <server>。登录链接一次有效、一分钟过期,隧道建好之后再跑一遍命令拿个新的
  5. 需要重新登录时,新版本用 nmem key --show-login 拿一个新的一次性登录链接,老版本用 nmem key 打印 key,粘贴进 Web App 就行

报告问题

On this page