Skip to content

README.pt.md

Latest commit

 

History

History
433 lines (317 loc) · 18.5 KB

README.pt.md

File metadata and controls

433 lines (317 loc) · 18.5 KB
Raw

🌐 Esta é uma tradução automática. Correções da comunidade são bem-vindas!


Claude-Mem
Vercel OSS Program

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français • 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tagalog • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk

Sistema de compressão de memória persistente construído para o Claude Code.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

Início Rápido • Como Funciona • Ferramentas de Pesquisa • Documentação • Configuração • Resolução de Problemas • Licença

O Claude-Mem preserva o contexto entre sessões de forma transparente, capturando automaticamente observações de utilização de ferramentas, gerando resumos semânticos e disponibilizando-os para sessões futuras. Isto permite ao Claude manter continuidade de conhecimento sobre projetos mesmo depois de as sessões terminarem ou de haver reconexão.

Início Rápido

Instale com um único comando:

npx claude-mem install

Ou instale para o OpenCode:

npx claude-mem install --ide opencode

Ou instale para o Antigravity CLI (guia de configuração):

npx claude-mem install --ide antigravity

Ou instale a partir do marketplace de plugins dentro do Claude Code:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

Reinicie o Claude Code. O contexto de sessões anteriores irá aparecer automaticamente em novas sessões.

Nota: O Claude-Mem também está publicado no npm, mas npm install -g claude-mem instala apenas o SDK/biblioteca — não regista os hooks do plugin nem configura o serviço worker. Instale sempre através de npx claude-mem install ou dos comandos /plugin acima.

🦞 OpenClaw Gateway

Instale o claude-mem como um plugin de memória persistente em gateways OpenClaw com um único comando:

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

O instalador trata das dependências, da configuração do plugin, da configuração do fornecedor de IA, do arranque do worker e de feeds opcionais de observação em tempo real para Telegram, Discord, Slack, entre outros. Consulte o Guia de Integração com o OpenClaw para mais detalhes.

Principais Funcionalidades:

  • 🧠 Memória Persistente - O contexto sobrevive entre sessões
  • 📊 Divulgação Progressiva - Recuperação de memória em camadas com visibilidade do custo em tokens
  • 🔍 Pesquisa Baseada em Skill - Consulte o histórico do seu projeto com a skill mem-search
  • 🖥️ Interface Web Viewer - Fluxo de memória em tempo real no URL do worker apresentado no arranque
  • 💻 Skill do Claude Desktop - Pesquise a memória a partir de conversas no Claude Desktop
  • 🔒 Controlo de Privacidade - Use tags <private> para excluir conteúdo sensível do armazenamento
  • ⚙️ Configuração de Contexto - Controlo detalhado sobre que contexto é injetado
  • 🤖 Funcionamento Automático - Não é necessária intervenção manual
  • 🔗 Citações - Referencie observações anteriores com IDs através da API do worker ou visualize todas no web viewer

Documentação

📚 Ver Documentação Completa - Navegue no site oficial

Introdução

Boas Práticas

Arquitetura

Configuração e Desenvolvimento

Como Funciona

Componentes Principais:

  1. 5 Hooks de Ciclo de Vida - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripts de hook)
  2. Instalação Inteligente - Verificador de dependências em cache (script pré-hook, não um hook de ciclo de vida)
  3. Serviço Worker - API HTTP local com interface web viewer e endpoints de pesquisa, gerida pelo Bun
  4. Base de Dados SQLite - Armazena sessões, observações e resumos
  5. Skill mem-search - Consultas em linguagem natural com divulgação progressiva
  6. Base de Dados Vetorial Chroma - Pesquisa híbrida semântica + por palavras-chave para recuperação inteligente de contexto

Consulte a Visão Geral da Arquitetura para mais detalhes.

Ferramentas de Pesquisa MCP

O Claude-Mem disponibiliza pesquisa de memória inteligente através de 4 ferramentas MCP, seguindo um padrão de fluxo de trabalho em 3 camadas eficiente em termos de tokens:

O Fluxo de Trabalho em 3 Camadas:

  1. search - Obtém um índice compacto com IDs (~50-100 tokens/resultado)
  2. timeline - Obtém o contexto cronológico em torno de resultados interessantes
  3. get_observations - Obtém detalhes completos APENAS para os IDs filtrados (~500-1.000 tokens/resultado)

Como Funciona:

  • O Claude utiliza ferramentas MCP para pesquisar a sua memória
  • Comece com search para obter um índice de resultados
  • Utilize timeline para ver o que estava a acontecer em torno de observações específicas
  • Utilize get_observations para obter detalhes completos dos IDs relevantes
  • Poupança de cerca de 10x em tokens ao filtrar antes de obter os detalhes

Ferramentas MCP Disponíveis:

  1. search - Pesquisa o índice de memória com consultas de texto integral, filtrando por tipo/data/projeto
  2. timeline - Obtém o contexto cronológico em torno de uma observação ou consulta específica
  3. get_observations - Obtém detalhes completos de observações por IDs (agrupe sempre vários IDs)

Exemplo de Utilização:

// Passo 1: Pesquisar índice
search(query="authentication bug", type="bugfix", limit=10)

// Passo 2: Rever o índice, identificar os IDs relevantes (ex.: #123, #456)

// Passo 3: Obter detalhes completos
get_observations(ids=[123, 456])

Consulte o Guia de Ferramentas de Pesquisa para exemplos detalhados.

Ramos de Lançamento

Os lançamentos stable partem do ramo main e são publicados no npm. Os ramos core-dev e community-edge são ramos executados a partir do código-fonte, destinados a correções de fiabilidade antecipadas e integrações com a comunidade. Consulte Ramos de Lançamento para o fluxo dos ramos e instruções de execução não-stable.

Requisitos do Sistema

  • Node.js: 20.0.0 ou superior
  • Claude Code: Versão mais recente com suporte para plugins
  • Bun: Runtime JavaScript e gestor de processos (instalado automaticamente se estiver em falta)
  • uv: Gestor de pacotes Python para pesquisa vetorial (instalado automaticamente se estiver em falta)
  • SQLite 3: Para armazenamento persistente (incluído)

Notas de Configuração para Windows

Se vir um erro semelhante a:

npm : The term 'npm' is not recognized as the name of a cmdlet

Certifique-se de que o Node.js e o npm estão instalados e adicionados ao seu PATH. Descarregue o instalador mais recente do Node.js em https://nodejs.org e reinicie o terminal após a instalação.

Configuração

As definições são geridas em ~/.claude-mem/settings.json (criado automaticamente com valores predefinidos na primeira execução). Configure o modelo de IA, a porta do worker, o diretório de dados, o nível de log e as definições de injeção de contexto.

Consulte o Guia de Configuração para todas as definições disponíveis e exemplos.

Configuração de Modo e Idioma

O Claude-Mem suporta múltiplos modos de fluxo de trabalho e idiomas através da definição CLAUDE_MEM_MODE.

Esta opção controla tanto:

  • O comportamento do fluxo de trabalho (ex.: code, chill, investigation)
  • O idioma utilizado nas observações geradas

Como Configurar

Edite o seu ficheiro de definições em ~/.claude-mem/settings.json:

{
  "CLAUDE_MEM_MODE": "code--zh"
}

Os modos estão definidos em plugin/modes/. Para ver todos os modos disponíveis localmente:

ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/

Modos Disponíveis

Modo Descrição
code Modo padrão em inglês
code--zh Modo em chinês simplificado
code--ja Modo em japonês

Os modos específicos de idioma seguem o padrão code--[lang], onde [lang] é o código de idioma ISO 639-1 (ex.: zh para chinês, ja para japonês, es para espanhol).

Nota: o code--zh (chinês simplificado) já está incluído por defeito — não é necessária instalação adicional nem atualização do plugin.

Depois de Alterar o Modo

Reinicie o Claude Code para aplicar a nova configuração de modo.

Desenvolvimento

Consulte o Guia de Desenvolvimento para instruções de compilação, testes e fluxo de contribuição.

Resolução de Problemas

Se estiver a ter problemas, descreva o problema ao Claude e a skill de resolução de problemas irá diagnosticar automaticamente e fornecer correções.

Consulte o Guia de Resolução de Problemas para problemas comuns e soluções.

Relatórios de Erros

Crie relatórios de erros abrangentes com o gerador automatizado:

cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report

Contribuir

Contribuições são bem-vindas! Por favor:

  1. Faça fork do repositório
  2. Crie um ramo de funcionalidade (feature branch)
  3. Faça as suas alterações com testes
  4. Atualize a documentação
  5. Submeta um Pull Request

O Claude-Mem é lançado a partir de três ramos: main (stable), core-dev e community-edge. Apenas o main é publicado no npm; os restantes são executados a partir do código-fonte. Consulte Ramos de Lançamento para a estratégia e instruções de execução local.

Consulte o Guia de Desenvolvimento para o fluxo de contribuição.

Licença

O Claude-Mem está licenciado sob a Apache License 2.0.

Escolhemos a Apache-2.0 porque a memória agêntica durável deve ser fácil de incorporar em ferramentas de programação, agentes locais, servidores MCP, sistemas empresariais, stacks de robótica e harnesses de agentes em produção.

Consulte o ficheiro LICENSE para todos os detalhes. Consulte docs/license.md e docs/ip-boundary.md para o âmbito de licenciamento e a fronteira entre o open e o comercial.

Nota sobre o Ragtime: O diretório ragtime/ está licenciado sob a Apache License 2.0. Consulte ragtime/LICENSE para mais detalhes.

Suporte

Construído com o Claude Agent SDK | Funciona com o Claude Code | Feito em TypeScript

E o CMEM?

O CMEM é um token criado por terceiros, mas oficialmente adotado pelo criador do Claude-Mem (Alex Newman, @thedotmack). O token funciona como catalisador comunitário para o crescimento e como veículo para levar o CMEM aos programadores e trabalhadores do conhecimento que mais dele precisam.

CA Oficial na BASE: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3