Question 1

如何修复因 mine 操作中断导致 palace 损坏而出现的 'mempalace status' 段错误？

Accepted Answer

如果在执行 `mempalace mine` 期间发生崩溃或强制重启，导致持久化的 Chroma 向量索引损坏（症状：`mempalace status`、`count()` 或 `get()` 在 `chromadb/api/rust.py` 内部发生段错误，而 `chroma.sqlite3` 仍可读取），请运行 `mempalace repair`（在 PR #119 中新增）。它会先自动备份已损坏的 palace，然后从 SQLite 中存储的 drawer 数据重建向量索引。注意：对于大型 palace，修复可能需要很长时间（例如 40k+ 条嵌入向量）。手动恢复替代方案：保持位于 `~/.mempalace/palace` 的已损坏 palace 原样不动，然后直接从 `chroma.sqlite3` 中读取 drawer 行——原始文本连同 `embedding_id`、`wing`、`room`、`source_file` 和 `chunk_index` 一起保存在 `chroma:document` 元数据字段中——再将其重新索引到一个全新的 palace 中。为防止问题再次发生，请在挖掘大型项目之前确保有足够的 RAM/磁盘余量。

Question 2

运行 mempalace repair rebuild-index 后如何修复 'EmbedderIdentityUnknownWarning'？

Accepted Answer

这是 MemPalace 3.11.0 中的一个已知缺陷：`mempalace repair rebuild-index` 会将整个 palace 目录（包括 `mempalace_embedder.json` 身份边车文件）归档到 `.pre-rebuild-/` 中，但不会为重建后的 palace 写入新的边车文件。此后每次打开都会警告 "palace collection has no recorded embedder identity; assuming the current model"。解决方法：(1) 对重建后的 palace 运行 `mempalace palace set-embedder --model `（例如 `--model minilm`）重新记录身份；这会重新生成 `mempalace_embedder.json` 并消除警告。(2) 如果您没有更换嵌入模型，可以从归档中将边车文件复制回来：`cp .pre-rebuild-*/mempalace_embedder.json /`。像 `mempalace search` 这样的只读命令不会自行重建该文件，因此在重新记录身份之前，警告会反复出现。永久修复计划在 3.11 之后的版本中推出。

Question 3

如何修复加载 MemPalace config.json 时出现的 "AttributeError: 'NoneType' object has no attribute 'get'"？

Accepted Answer

当 config.json 包含语法有效但不是对象的 JSON 时（例如 `null`、`[]`、`"oops"`、`42` 或 `true`），就会发生此崩溃。`MempalaceConfig` 在未检查其类型的情况下存储了 `json.load()` 的结果，之后每个设置属性都会对其调用 `.get()`，从而导致 CLI、MCP server、mining 和 hooks 全部崩溃。

**临时解决方案（立即生效）：** 打开 `config.json`，确保顶层值是一个 JSON 对象，例如将其内容替换为 `{}`，或者删除该文件以使用默认值。

**永久修复：** 在 `MempalaceConfig.__init__` 中，在存储解析后的 JSON 之前先对其进行验证，对非 dict 类型的值回退到默认值：
```python
try:
    data = json.loads(config_path.read_text(encoding="utf-8"))
    self._file_config = data if isinstance(data, dict) else {}
except (OSError, UnicodeDecodeError, json.JSONDecodeError):
    self._file_config = {}
```
不要隐式重写无效文件——只需忽略它并使用默认值，与现有的针对格式错误 JSON 的 fail-soft 行为保持一致。

mempalace

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐