문제 해결
첫 번째 단계: engram entry를 실행하고 Runtime 탭을 확인하십시오. 확인된 프로필, 메모리 루트, 핵심 설정, 라우팅, 그래프 및 Git 감지 상태가 표시됩니다.
메모리가 로드되지 않는 경우
engram load --dry-run "<작업>"을 실행하여 후보 수와 좁히기 태그를 확인합니다.engram config view에서enabled,read및load.limit설정을 확인합니다..agents/.engram/아래에 작업 공간 메모리가 존재하는지 확인합니다.engram verify를 실행하여 해시를 검사합니다.
훅(Hooks)이 주입되지 않는 경우
engram set-read status가off나manual이 아닌지 확인합니다.- 호스트가 연결되어 있는지 확인합니다:
engram link <대상>. - 연결(link) 또는 연결 해제(unlink) 후 호스트를 재시작하거나 새로고침하십시오 (특히 OpenCode의 경우).
engram set-proof status를 실행하여 증명 줄(proof line) 표시 여부를 확인합니다.
저장에 실패한 경우
- 승인 미리보기를 확인하여 관련 메모리 관련 힌트가 있는지 읽어봅니다.
- 만약 전체 승인(accept-all)에서 관련 메모리가 보고되었다면 파일이 저장되지 않은 것입니다.
DEPENDS_ON또는UPDATE후보를 지정하여 다시 실행하십시오. - CLI 출력에서 스키마, 비밀 정보 및 인젝션 스캔 오류를 확인합니다.
프로필 혼동이 발생하는 경우
engram profile status를 실행합니다.- 작업 공간의
default_profile및 활성 사용자 프로필을 확인합니다. - 작업 공간 기본값과 다른 명시적 프로필을 지정하여 실행하면 해당 명령의 작업 공간 메모리가 비활성화됨을 인지하십시오.
손상된 메모리 파일인 경우
engram verify
engram repair
engram rebuild-index
engram graph --rebuild
패키지 업데이트 후 어댑터가 기한 만료된 경우
engram upgrade
engram upgrade --latest
engram link all
생성된 Engram 어댑터 파일을 의도적으로 대체할 때만 --force를 사용하십시오.
SQLite 설정 DB를 사용할 수 없는 경우
일반 읽기/쓰기 명령은 JSON 설정 스냅샷으로 폴백됩니다. DB 전용 명령은 일반 메모리 사용을 차단하는 대신 SQLite를 사용할 수 없음으로 보고합니다.
글로벌 Git 동기화 문제
global_git.enabled가true인지 확인합니다.global_git.remote_url이 유효한 Git 원격 저장소 URL인지 확인합니다.global_git.auto_resolve설정을 검토하십시오. 자동 충돌 해결 기능은 메모리 변경 사항(diff)을 가릴 수 있습니다.engram entry의 Runtime 탭을 점검하여global_git_detected를 확인합니다.
다음 단계
Git 작성자 정보
Engram은 글로벌 작성자와 선택적인 워크스페이스 재정의를 저장할 수 있습니다. 확인 순서는 워크스페이스, 글로벌, 그다음 읽기 전용 Git 대체값입니다. 설정은 앞으로 작성되는 메모리에만 적용되며, 워크스페이스 재정의는 글로벌 Git 설정을 바꾸지 않습니다. 글로벌 Git 동기화나 기존 메모리 마이그레이션에는 명시적인 계획 확인과 승인 절차를 사용하세요.
engram author show
engram author set --name "Jane Doe" --email "jane@example.com"
engram author unset --scope workspace
engram author sync-git-global --plan
engram author sync-git-global --confirm
engram author migrate-memories --plan
engram author migrate-memories --confirm
전체 내용은 Git 작성자 설정 가이드를 읽어 보세요.