Configuração do DeepSeek Harness

Execute o ECC no DeepSeek Harness. Guia completo: docs/DEEPSEEK-HARNESS-GUIDE.md.

Quando Usar

• Instalando skills ou hooks do ECC em uma instalação do DeepSeek Harness.
• Decidindo quais superfícies do ECC funcionam no DSH e quais não funcionam.
• Depurando uma sessão DSH que não exibe skills do ECC ou não dispara hooks do ECC.

Como Funciona

1. Skills não precisam de conversão. O DSH lê SKILL.md frontmatter (nome/descrição) de raízes de skill nativas. Vincule o catálogo do ECC uma vez:

   ln -s /path/to/ECC/skills/<skill-name> ~/.dsh/skills/<skill-name>
   

   Prioridade da raiz (raízes de projeto .dsh e .agents batem ~/.dsh): pule o vínculo de skills cujos nomes já existem em uma raiz de prioridade mais alta. Substitua os placeholders por nomes de skill reais; os colchetes angulares não são sintaxe de shell.

2. Hooks passam pela ponte de primeira parte. Gere uma configuração no formato DSH a partir do arquivo canônico de hooks do ECC:

   node scripts/dsh/generate-hooks-config.js --ecc-root /path/to/ECC --out ~/.dsh/ecc/hooks-dsh.json
   

   O gerador converte para minúsculas os correspondentes de nome de ferramenta, prefixa CLAUDE_PLUGIN_ROOT/ECC_PLUGIN_ROOT inline (a ponte não exporta a raiz do plugin), preserva timeouts e pula eventos que o DSH não pode fazer a ponte: PreCompact, PostToolUseFailure, SessionEnd.

3. Monte com uma inserção simples em ~/.dsh/profiles/<profile>/cordis.patch.yml:

   - insert:
       - id: ecc-hooks-claude-code
         name: "@deepseek-ai/dsh-hooks-claude-code"
         config:
           configPath: /absolute/path/to/hooks-dsh.json
   

   Regras do carregador que custam tempo de depuração quando aprendidas da maneira difícil: uma entrada de nível superior - id: simples é silenciosamente descartada; insert sob um id de grupo existente é rejeitado como "não é um grupo"; pacotes de plugin de primeira parte não precisam de uma entrada de perfil package.json.

4. Valide compondo, depois verifique ao vivo.

   cd ~/.dsh && dsh --profile web --dump-config > /tmp/dump.yml
   grep ecc-hooks /tmp/dump.yml
   

   O status de saída da composição permanece 0 mesmo quando o carregador descarta ou rejeita uma entrada — esses problemas são relatados apenas no stderr. Confirme se o ID da entrada aparece no dump e se o stderr está vazio. Uma negação do GateGuard ao vivo na primeira edição/escrita/bash da sessão é o sinal visível de que a ponte está ativa.

Atualizando

git pull reflete imediatamente nas skills vinculadas; regenere a configuração de hooks com o mesmo comando gerador. Se o checkout do ECC se mover, regenere (o caminho está embutido em cada comando de hook) e relink as skills.

Limites

A configuração validada aqui visa o perfil CLI/web. Perfis de desktop têm um runtime separado de propriedade da instalação e a descoberta de skills deve ser verificada lá independentemente. Gere hooks apenas a partir de um checkout do ECC revisado; o checkout vinculado fornece seu runtime.