Question 1

중단된 mine으로 palace가 손상된 후 발생하는 'mempalace status' segfault를 수정하는 방법?

Accepted Answer

만약 `mempalace mine` 실행 중 크래시나 강제 재시작으로 인해 영속화된 Chroma 벡터 인덱스가 손상된 경우(증상: `chroma.sqlite3`는 여전히 읽을 수 있지만 `mempalace status`, `count()` 또는 `get()`이 `chromadb/api/rust.py` 내부에서 세그폴트 발생), `mempalace repair`(PR #119에서 추가됨)를 실행하세요. 이 명령은 먼저 손상된 palace를 자동으로 백업한 다음, SQLite에 저장된 drawer 데이터로부터 벡터 인덱스를 재구축합니다. 참고: 대규모 palace의 경우 복구에 오랜 시간이 걸릴 수 있습니다(예: 40k 이상의 임베딩). 수동 복구 대안: 손상된 palace를 `~/.mempalace/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` identity 사이드카 포함)를 `.pre-rebuild-/`로 아카이브하지만, 재구축된 palace에 대한 새 사이드카를 작성하지 않습니다. 이후 열 때마다 'palace collection has no recorded embedder identity; assuming the current model' 경고가 표시됩니다. 해결 방법: (1) 재구축된 palace에 대해 `mempalace palace set-embedder --model `(예: `--model minilm`)을 실행하여 identity를 다시 기록합니다. 이렇게 하면 `mempalace_embedder.json`이 재생성되고 경고가 사라집니다. (2) 임베딩 모델을 변경하지 않은 경우 아카이브에서 사이드카를 다시 복사합니다: `cp .pre-rebuild-*/mempalace_embedder.json /`. `mempalace search`와 같은 읽기 전용 명령은 파일을 스스로 다시 생성하지 않으므로, identity가 다시 기록될 때까지 경고가 반복됩니다. 영구적인 수정은 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, 마이닝, 훅이 모두 크래시됩니다.

**임시 해결 방법(즉시 적용):** `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

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트