Plugins

O setup instala e mantém os plugins do perfil neuro, fixados por versão. Esta página lista o que vem instalado, mostra como usar o plugin de tráfego pago e como mexer nos plugins à mão.

O que vem instalado

Plugin	Versão	Origem	O que faz
neuro-mv-edit	1.8.0	Motor em ~/.neuro-harness/engine/neuro-mv-edit/1.8.0	Edição de vídeo: skill e comando neuro-mv-edit nas sessões. Veja Editar vídeos
neuro-ads-manager	0.1.0	~/.neuro-harness/addons/neuro-ads-manager/0.1.0	Tráfego pago na Meta. Veja neuro-ads-manager
neuro-harness-brand	—	~/.neuro-harness/plugins	Marca da interface. Veja Identidade visual
neuro-harness-pt-br	—	~/.neuro-harness/plugins	Interface em português. Veja Idioma da interface
Plugins oficiais do Harness	0.2.1-alpha.2	npm (@deepseek-ai/…)	Veja Plugins oficiais ativos

Para conferir se todos estão no perfil e na versão certa, rode neuro-harness doctor. Se faltar algum, neuro-harness setup reinstala.

Plugins oficiais ativos

Plugin	Pacote	O que faz
Agent Teams	@deepseek-ai/dsh-experimental-agent-team-profile	Equipes de agentes, com roster, mensagens entre eles e quadro de tarefas compartilhado
Auto review	@deepseek-ai/dsh-experimental-auto-review	O modo de permissão Auto: um modelo revisa cada ação e só pede a sua aprovação quando há risco. Escolha no seletor de permissão ou com /permission auto
Busca em sessões	@deepseek-ai/dsh-experimental-session-search	Os agentes buscam e leem sessões anteriores do espaço de trabalho
Terminal persistente	@deepseek-ai/dsh-experimental-terminal-bundle	Processos de shell continuam vivos entre chamadas, como o Remotion Studio e servidores
Títulos de sessão	@deepseek-ai/dsh-experimental-session-titles-bundle	O título da sessão se atualiza a cada pedido

neuro-ads-manager

O neuro-ads-manager é um gestor de tráfego pago para agentes de IA, focado em Meta Ads (Facebook, Instagram, WhatsApp e Lead Ads). Ele audita a conta, planeja campanhas, gera relatórios, prepara criativos e copy dentro das regras do segmento e confere se a conversão chega à Meta.

Só leitura

O plugin só lê a conta, pela Graph API. O que precisa mudar vira um plano de mudança com hash, que espera a sua aprovação. A execução fica com a ferramenta do projeto ou com o Gerenciador de Anúncios. O plugin não abre arquivos .env e nunca mostra o token.

O que o plugin registra no Harness

• A skill neuro-ads-manager, que o modelo usa quando o pedido é de tráfego pago.
• Um comando por tarefa, para você chamar no chat: neuro-ads-auditar, neuro-ads-planejar, neuro-ads-relatorio, neuro-ads-criativos, neuro-ads-conversao e neuro-ads-perfil.
• O comando neuro-ads-manager no PATH das sessões, enquanto o plugin estiver ativo.

Comando	O que faz
neuro-ads-auditar	Retrato da conta, achados verificados, compliance da copy ativa e auditoria priorizada
neuro-ads-planejar	Plano de campanha: estrutura, públicos, orçamento, criativos, mensuração, testes e cronograma
neuro-ads-relatorio	Relatório do período, com comparação, melhores e piores anúncios e alertas
neuro-ads-criativos	Conceitos, copy, nomes e briefing de produção, já passados pelo compliance
neuro-ads-conversao	Conferência de dataset, campanhas e arquivo de conversões, com índice de prontidão
neuro-ads-perfil	Cria ou edita o perfil de um cliente com perguntas no chat

Configurar o token da Meta

O plugin lê o token só de variáveis de ambiente. As sessões herdam o ambiente do processo do Harness, então exporte as variáveis no terminal e suba o Harness por ele.

1. Gere um token de usuário do sistema, no Business Manager do cliente, com a permissão ads_read.

2. Exporte as variáveis e reinicie o Harness no mesmo terminal:

   Terminal

   export META_ACCESS_TOKEN=... META_AD_ACCOUNT_ID=act_...
   neuro-harness restart

3. Numa sessão nova, confira a conexão:

   rode neuro-ads-manager meta conferir --perfil <perfil>

Variável	Para quê	Padrão
META_ACCESS_TOKEN	Token da Graph API (usuário do sistema, ads_read)	—
META_AD_ACCOUNT_ID	Conta de anúncio (act_…)	—
META_DATASET_ID	Pixel ou dataset para a conferência de conversão	—
META_GRAPH_VERSION	Versão da Graph API	v27.0
NEURO_ADS_HOME	Biblioteca de perfis do usuário	~/.neuro-ads-manager

Se você usa o app desktop, suba o Harness pelo terminal antes de abrir o app. O app reaproveita o Harness que já está rodando.

Exemplo de pedido

audite a conta nos últimos 30 dias com a skill neuro-ads-manager e me mostre os achados P0

Os perfis de cliente que você criar ficam em ~/.neuro-ads-manager/perfis/ e sobrevivem às atualizações.

README do neuro-ads-managerCLI completa, perfis, compliance por segmento, mensuração e planos de mudança. Repositório privado: abre para contas com acesso.

Instalar ou remover um plugin à mão

Use o gerenciador de plugins do próprio Harness, com a pasta do Harness da distribuição.

1. Instale o plugin no perfil neuro:

   Terminal

   DSH_HOME=~/.neuro-harness/dsh ~/.neuro-harness/runtime/node_modules/.bin/dsh plugin --profile neuro add <origem>

   A <origem> pode ser um pacote do npm, github:<dono>/<repo>#<tag> ou link:<pasta>.

2. Reinicie o Harness:

   Terminal

   neuro-harness restart

3. Abra uma sessão nova.

Para remover, troque add <origem> por remove <nome> e reinicie.

Plugins gerenciados pelo setup

O setup reinstala os plugins que ele gerencia, na versão fixada. Se você remover um deles à mão, o próximo setup o põe de volta.