Claude API 메모리 파일 트리
Claude API 메모리 파일 트리
이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.
Claude API 메모리 어댑터는 프레임워크의 Python 메모리 도구 베이스와 TypeScript 메모리 핸들러를 Loom 지식 문서를 통해 구현합니다. 프레임워크 SDK는 선택적 의존성입니다. 두 구현은 동일한 문서 URI와 스토어 태그를 사용하므로, 한 언어로 만든 파일을 다른 언어에서도 읽을 수 있습니다.
파일은 loom-memory://<store>/memories/<path> 형식입니다. 디렉터리는 URI 접두사이며, 별도의 디렉터리 행은 없습니다. 경로는 정규화되며, /memories 아래에 남지 않는 경로는 거부됩니다. 디렉터리 읽기는 스토어 태그, URI 접두사, 투영된 URI 필드와 함께 knowledge.list를 사용하고, 파일 읽기는 knowledge.get을 사용합니다. 편집에는 knowledge.upsert를, 삭제에는 크기가 제한된 knowledge.bulk_delete 호출을 사용합니다. 이름 변경은 각 파일을 복사한 뒤 이전 URI를 삭제합니다. 이름 변경이 실패하면 복사본이 남을 수 있으며, 동시에 수행되는 읽기-수정-쓰기 편집에서는 나중의 쓰기가 유지됩니다.
소스 진입점
sdk/python/loom/integrations/claude_memory.py:AsyncLoomMemoryTool및LoomMemoryTool.sdk/typescript/src/integrations/claude-memory.ts:loomMemoryTool및loomMemoryHandlers.
불변 조건
스토어는 파일을 그룹화하며, 접근은 네임스페이스 권한 부여로 제어됩니다. 비공개 사용자 트리에는 별도의 네임스페이스가 필요합니다. 어댑터는 스토어 이름을 접근 권한 부여로 해석하지 않습니다. 행위자, 소스 출처, 문서 리비전, blob 정리 및 삭제는 기존 지식 작업을 따릅니다. 로컬 영구 상태, 데이터베이스 또는 스키마는 추가되지 않습니다. 디렉터리 작업은 원자적 스냅샷이 아닙니다.