NEXUS Prompts

Resumo técnico

Editor e gerenciador de prompts para IAs do NEXUS que centraliza diretivas de personalidade com versionamento, métricas de uso e eficiência. Templates dinâmicos com variáveis {{var}}, galeria de algoritmos prontos para clonar e filtros por módulo e IA alvo padronizam a automação de instruções.

Escopo executado

• Registro: plugin.json v1.0.0, ícone lucide message-square, icon_bg #eff6ff e icon.svg próprio (balão de chat, sem is_core — plugin adicional); registerTab('prompts','Prompts','message-square',tab.php) e registerDoc('prompts','Gerenciamento de Prompts','message-square',doc.md); 7 modais registrados (prompt, prompt-preview, prompt-modules, prompt-engines, prompt-statuses, prompt-run, prompt-gallery) e JS próprio via registerJs('prompts','/plugins/prompts/assets/prompts-v2.js').
• Tabelas via install.sql: prompts (id INT PK AI, title VARCHAR(255) NOT NULL, content TEXT NOT NULL, module VARCHAR(100) DEFAULT 'Geral', target_ia VARCHAR(100), status VARCHAR(50), updated_at DATETIME ON UPDATE, usage_count INT DEFAULT 0, efficiency INT DEFAULT 100, is_favorite TINYINT(1) DEFAULT 0) e prompt_versions (id INT PK AI, prompt_id INT NOT NULL FK → prompts.id ON DELETE CASCADE, content TEXT snapshot, created_at DATETIME) — InnoDB utf8mb4.
• Versionamento automático: prompt_save grava snapshot do conteúdo anterior em prompt_versions sempre que o conteúdo muda; prompt_versions_get devolve até 10 revisões mais recentes; restoreVersion restaura com confirmação (o conteúdo atual vira nova revisão no histórico).
• API com 15 actions: prompt_list (ordenada por favorito DESC, uso DESC, módulo, título), prompt_save, prompt_delete, prompt_usage_increment, prompt_favorite_toggle (alterna 1 − is_favorite), prompt_versions_get, aliases legados prompts_list/prompts_save/prompts_delete e meta persistente prompt_modules_*, prompt_engines_* e prompt_statuses_* (gravam em system_settings via DB::setConfig).
• Configurações persistentes: módulos (prompt_modules), motores de IA (ai_engines) e status (prompt_statuses com id/value/label/emoji/color) — com fallbacks padrão no boot (Gemini, GPT-4, Claude, Flux, Ollama; Atualizado 🟢 / Em Teste 🟡 / Obsoleto 🔴).
• Templates dinâmicos: variáveis {{var}} detectadas por hasVariables/runPrompt; o modal Variable Injector monta formulário dinâmico e "Gerar & Copiar" substitui todas as ocorrências (regex com escape) e incrementa o uso do prompt.
• Galeria de templates: 4 algoritmos embutidos (Agente de SEO Expert GPT-4o, Diretiva de Código Limpo Claude 3.5, Copywriting VSL 5.0 GPT-4o, Analista de Bugs Brutal Claude 3.5) com clonagem em um clique (módulo 'Galeria').
• Fast Responses: /prompts (sem argumento) → prompt_list — lista prompts cadastrados.
• Sem cron: cronjob.json vazio — plugin 100% sob demanda, "nenhuma rotina periódica segura ou necessária".
• Interface: aba Alpine.js (tab.php, 308 linhas) com 6 stats (Total, Gemini, GPT-4, Claude, Imagens, Saúde), pills de módulos com contagens, busca e filtro por IA/módulo, paginação de 5, tabela ultra-compact com métricas de usos/precisão, badges de status coloridos e ações de favoritar/executar/copiar/editar/deletar; empty state contextual de onboarding ("Comece agora!").
• Sem enricher do Intelligence Hub: plugin puramente de gestão de prompts, sem integração com core/intel.php (diferente dos plugins de enriquecimento).

Stack e ferramentas

• PHP 8 backend (sem framework) + MySQL 8 (tabelas prompts e prompt_versions)
• Alpine.js + Tailwind CSS (aba + 7 modais) + ícones lucide
• Plugin API interno (tabs/modals/actions + fastr.json + system_settings)

Tags

Prompts, IA, Prompt Engineering, Versionamento, Galeria, Plugin NEXUS

Resultado operacional

• Biblioteca central de prompts: diretivas de personalidade versionadas por módulo e IA alvo — um só lugar para os "algoritmos" das IAs.
• Métricas de uso e eficiência: ranking por favoritos e usos, com precisão percebida (0–100) por prompt.
• Zero retrabalho: restauração de revisões em um clique, com snapshot automático do conteúdo atual.
• Padronização sem código: módulos, motores de IA e status configuráveis pelo painel — persistem em system_settings.
• Templates instantâneos: galeria com clonagem em um clique e variáveis {{var}} para reuso seguro.
• Seguro: todas as actions exigem Bearer token e permissão do módulo 'prompts' no api.php.