DeepSeek Harness

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:

dsh plugin --profile <name> 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='<your-xmemo-token>').
• 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.