故障排除
Nowledge Mem 的常见问题和解决方案
查看日志
在 macOS 上，系统日志文件位于 ~/Library/Logs/Nowledge\ Graph/app.log。
你可以在终端中运行此命令查看：
open -a Console ~/Library/Logs/Nowledge\ Graph/app.log在 Windows 上，系统日志文件位于两个可能的位置，取决于安装方法：
%LOCALAPPDATA%\Packages\NowledgeLabsLLC.NowledgeMem_1070t6ne485wp\logs\app.log（从 Microsoft Store 安装）%LOCALAPPDATA%\NowledgeGraph\logs\app.log（从 Nowledge Mem 网站下载的安装包安装）
你可以将此粘贴到文件资源管理器的地址栏中查看：
%LOCALAPPDATA%\Packages\NowledgeLabsLLC.NowledgeMem_1070t6ne485wp\logs\app.log或者：
%LOCALAPPDATA%\NowledgeGraph\logs\app.log应用启动时间过长
症状： 应用在启动期间挂起或显示超时错误。
解决方案： 全局代理或 VPN 软件可能阻止应用直接访问 http://127.0.0.1:14242。
配置代理/VPN 绕过
配置你的代理或 VPN 工具绕过 localhost 地址。将以下内容添加到你的绕过/排除规则：
127.0.0.1, localhost, ::1这允许你保持代理/VPN 启用，同时确保 Nowledge Mem 可以与其本地服务器通信。更新绕过规则后，重启 Nowledge Mem。
AI Now 会话启动失败
症状： 点击 新任务 或恢复已暂停任务时失败，AI Now 无法打开会话。
第一步： 先查看 AI Now 内的启动诊断卡片。
使用 AI Now 启动诊断
会话启动失败时，AI Now 会显示诊断卡片，包含：
- 失败阶段（
spawn、initialize或new_session） - 平台和进程退出码
- 启动脚本最近的
stderr输出 - 可复制的诊断信息按钮
点击 详情 展开技术字段，再点击 复制诊断信息，用于反馈或提交 issue。
常见修复（尤其 Windows）：
- 确认安装完整（嵌入式 Python 与启动脚本存在）。
- 修改插件或模型配置后，重启 Nowledge Mem 再重试。
- 临时关闭会拦截 bundled Python / PowerShell 启动的杀毒或隔离规则。
- 若与插件有关，在 AI Now → 插件 中重新连接已过期 OAuth 插件后再试。
如果仍失败，请在反馈时附上“复制诊断信息”内容和 app.log。
模型缓存损坏
症状： 搜索、记忆提炼或知识提取功能意外停止工作。
解决方案： 清除模型缓存并重新下载模型。
清除缓存
导航到 设置 → 模型，然后点击：
清除缓存后，重新下载所需的模型。
找不到 CLI
症状： 在终端中运行 nmem 返回"command not found"。
各平台解决方案：
- macOS：从 设置 → 偏好设置 → 开发者工具 安装 CLI
- Windows：应用安装后打开新的终端窗口（PATH 更新需要新会话）
- Linux：CLI 包含在 deb/rpm 包中。如果手动安装，确保
/usr/local/bin在你的 PATH 中
快速检查： 运行 nmem status 以验证 CLI 可以连接到 Nowledge Mem。
远程访问返回 429
症状： nmem status 或 curl 返回 429 Too many invalid auth attempts。
解决方案： 客户端多次使用了错误的 API key。
- 在 设置 → 随处访问 Mem 重新复制 URL + key
- 确认
NMEM_API_KEY完整且没有多余空格/引号 - 如果不确定，点击 Rotate 生成新 key
完整流程见：随处访问 Mem。
远程访问返回 401 Missing API key
症状： Tunnel URL 可访问，但 nmem status 或 curl 返回 401 Missing API key。
原因： 某些网络代理会移除鉴权头。
解决方案：
- 升级到最新版
nmem（会自动使用代理兼容回退） - 在 设置 → 随处访问 Mem 重新复制 URL + key
- 手动
curl可用：curl "$NMEM_API_URL/health?nmem_api_key=$NMEM_API_KEY"