As páginas sem tradução abrem em inglês e são identificadas como inglês.
Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.
Árvore de arquivos de memória da Claude API
O adaptador de memória da Claude API implementa as bases da ferramenta de memória do framework em Python e os handlers de memória em TypeScript por meio de documentos de conhecimento do Loom. Os SDKs do framework são dependências opcionais. As duas implementações usam o mesmo URI de documento e a mesma tag de store, de modo que cada linguagem lê os arquivos criados pela outra.
Um arquivo é loom-memory://<store>/memories/<path>. Diretórios são prefixos de URI, sem linhas de diretório separadas. Os caminhos são normalizados e recusados, a menos que permaneçam dentro de /memories. As leituras de diretório usam knowledge.list com uma tag de store, um prefixo de URI e campos de URI projetados; as leituras de arquivo usam knowledge.get. As edições usam knowledge.upsert, e a exclusão usa chamadas limitadas de knowledge.bulk_delete. A renomeação copia cada arquivo antes de excluir o URI antigo. Uma renomeação que falha pode deixar cópias, e edições simultâneas de leitura-modificação-escrita mantêm a gravação mais recente.
Pontos de entrada no código-fonte
sdk/python/loom/integrations/claude_memory.py:AsyncLoomMemoryTooleLoomMemoryTool.sdk/typescript/src/integrations/claude-memory.ts:loomMemoryTooleloomMemoryHandlers.
Invariantes
Um store agrupa arquivos; a autorização do namespace controla o acesso. Árvores privadas de usuário exigem namespaces separados. O adaptador nunca interpreta o nome de um store como uma concessão de acesso. Ator, proveniência da fonte, revisões de documentos, limpeza de blobs e eliminação seguem as operações de conhecimento existentes. Nenhum estado persistente local, banco de dados ou esquema é adicionado. As operações de diretório não são snapshots atômicos.