# DeepSeek Harness Conecte o loop de execução do agente CLI do DeepSeek Harness (dsh) ao XMemo usando o pacote npm nativo dsh-xmemo. - Canonical: https://docs.xmemo.dev/pt-br/docs/connect/deepseek-harness - Locale: pt-BR - Content-Locale: pt-BR - Canonical-Content-Digest: c6de6cc4c0f626de469ac03a56dc357d0c9af7afcc4dfe19946e5ef345c10181 - Edition-Digest: 6d47a60658beffb3ae7bd7b05ef23e615cc96ef72cdbc2a3d88e000d8320213e - Source-Revision: sha256:dec9ab1fbe4dd6a2bdb916f3b710fbe7727d084a06a4c81753e6790881a0afee ## Público-alvo e limites Este guia conecta o loop de execução do agente CLI do DeepSeek Harness (dsh) à memória persistente do XMemo. A integração opera por meio do pacote de plug-in nativo dsh-xmemo (versão 0.1.0) no npm, vinculado ao repositório yonro/xmemo-deepseek-plugin @ e7101afb0a (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md). Limite importante: Esta integração destina-se especificamente à ferramenta de CLI dsh agent harness; NÃO se trata de uma integração no chat web de consumo do DeepSeek (chat.deepseek.com), que não oferece suporte a plug-ins personalizados nem extensões MCP. ## Pré-requisitos Certifique-se de que as seguintes dependências de tempo de execução e ferramentas estejam presentes antes de conectar: - CLI do DeepSeek Harness (dsh) instalada e operacional. - Ambiente de execução Node.js versão 18.0.0 ou superior. - Conta válida do XMemo em https://xmemo.dev. - Acesso de rede a https://xmemo.dev/mcp via HTTPS. ## Instalação Adicione o plug-in nativo dsh-xmemo ao seu perfil do DeepSeek Harness usando o comando documentado nas linhas 90-94 do README: ```bash dsh plugin --profile add dsh-xmemo ``` ## Autorização e configuração de credenciais Configure as credenciais usando variáveis de ambiente ou a configuração de perfil do harness. Não coloque chaves de API em texto simples em repositórios de projetos públicos: - Variável de ambiente (recomendado): Defina XMEMO_KEY no ambiente antes de iniciar o dsh (export XMEMO_KEY=''). - Configuração de perfil: Especifique as credenciais de autenticação no arquivo de configuração do perfil de destino (~/.dsh/config.json). ## Comportamento de carregamento e reinicialização Os procedimentos de reinicialização do daemon ou recarregamento do loop de execução não estão explicitamente documentados no README do plug-in dsh-xmemo (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md); consulte a documentação da CLI do DeepSeek Harness ou inicie tarefas usando seu perfil configurado. ## Verificação de conexão (somente leitura) Verifique a conectividade com uma solicitação de recall somente para leitura antes de iniciar os loops de execução do agente: - Verificação: Execute uma consulta de avaliação somente para leitura pelo dsh sem modificar o estado da memória. - Sinal de sucesso: O dsh retorna resultados de memória estruturados com campos Reference e Location válidos do espaço de trabalho autorizado. ## Primeira tarefa útil: Ciclo de vida de memória sintética Verifique a persistência de memória, a transição de sessão sem estado, o recall com atribuição de fonte e a correção: - 1. Salvar fato sintético: Armazene uma convenção de tarefa do harness ("Harness demo build target: ESM with strict typing.") em "projects/demo-dsh/conventions". - 2. Transição sem estado: Encerre a tarefa atual do dsh e inicie uma nova execução usando o perfil configurado. - 3. Recall com atribuição de fonte: Consulte "harness build target convention". Confirme os campos Reference e Location retornados. - 4. Corrigir memória: Atualize a convenção lembrada usando update_memory com os destinos de compilação atualizados. - 5. Limpeza opcional: Exclua temporariamente (forget) a convenção de demonstração quando a verificação de integração for concluída. ## Escopo de captura automática e prevenção de duplicatas Gerenciamento de memória do loop de execução do DeepSeek Harness: - Pontos de verificação de loop: O dsh-xmemo captura automaticamente resultados de tarefas, decisões de arquitetura e resoluções de erros nos limites de conclusão de tarefas. - Prevenção de duplicatas: O hash de desduplicação evita recapturar contexto de execução idêntico em iterações repetidas do loop. - Isolamento de escopo: O contexto capturado fica estritamente delimitado ao espaço de trabalho autenticado e ao escopo do repositório ativo. ## Conflitos com provedores existentes e propriedade de armazenamento Limites de tempo de execução e propriedade de armazenamento: - Conflitos de provedor: Desative a memória local efêmera padrão em dsh.config.json ao usar o dsh-xmemo para evitar injeção de contexto redundante ou conflitante. - Propriedade de armazenamento: As memórias duráveis residem no back-end em nuvem do XMemo de propriedade do usuário; o dsh armazena apenas transcrições de execução efêmeras e registros de execução locais. - Limites off-line e de repetição: Interrupções transitórias de conectividade são armazenadas temporariamente em buffer local; períodos off-line prolongados causam falha nas operações de gravação quando o buffer se esgota, e o contexto off-line não é compartilhado entre agentes até a reconexão à rede. ## Recuperação, atualização e remoção Procedimentos de solução de problemas, atualização e remoção do DeepSeek Harness: - Recuperação (401 invalid_token): Verifique se XMEMO_KEY está exportada no ambiente de shell que executa o dsh. - Atualização e remoção: Os procedimentos de atualização e remoção do plug-in não estão documentados no README do plug-in dsh-xmemo (https://github.com/yonro/xmemo-deepseek-plugin/blob/e7101afb0a/README.md); consulte a documentação da CLI do DeepSeek Harness para gerenciamento de perfis ou revogue credenciais e limpe memórias armazenadas em https://xmemo.dev/me. - Exclusão remota: Para limpar memórias armazenadas ou revogar tokens de acesso, gerencie seu espaço de trabalho em https://xmemo.dev/me.