O painel local: o teu espaço de trabalho, visto pelo agente

O painel local é uma pequena aplicação web que mostra o teu espaço de trabalho tal como o teu agente o vê: produtos, o que o agente sabe sobre cada um, progresso do onboarding, todos os estados de submissão registados, as coisas que precisam de ti e as datas de acompanhamento. Corre apenas na tua máquina, não contacta nenhum diretório e foi adicionado na versão de 15 de setembro de 2026 listada no changelog. Este guia cobre como o arrancar, para que serve cada ecrã e as regras que impõe.

Arrancar

No Windows, usa py -3 em vez de python3 nos comandos abaixo (ou python, se for esse o teu comando de Python 3.10 ou mais recente). Mantém o espaço de trabalho numa pasta local privada, fora do OneDrive e de outras pastas sincronizadas.

python3 scripts/dashboard.py            # opens 127.0.0.1:8765 in your browser
python3 scripts/dashboard.py --demo     # explore a throwaway sample workspace
python3 scripts/dashboard.py --port 8790 --no-open

É Python 3.10+ de biblioteca standard: sem dependências, sem passo de build. Corre-o a partir do teu espaço de trabalho privado, a pasta que o scripts/init-workspace.py criou. Arrancado a partir do checkout de entrega partilhado, limita-se a oferecer a criação desse espaço de trabalho. O caminho mais fácil continua a ser o prompt de arranque do guia de arranque em três passos: o agente cria o espaço de trabalho, arranca o servidor e entrega-te o link.

A vista geral

O primeiro ecrã responde a «o que precisa de mim?» antes de tudo o resto: passagens para humano de CAPTCHA e dois fatores que o agente não conseguiu concluir, plataformas marcadas como bloqueadas, acompanhamentos atrasados e onboarding por terminar. Abaixo vêm os teus produtos com totais por grupo de estado — precisa de ti, problemas, em revisão, agendadas, live — e a saúde do espaço de trabalho lida do workspace.json. Se só abres o painel uma vez por semana, é esta a página a ver.

A página de produto

Cada produto tem uma checklist de prontidão produzida pelo doctor.py, o resumo da última sessão, as suas submissões com filtros, as verificações de onboarding, o briefing do produto, identidade, permissões e notas. Uma «vista do agente» lista que ficheiros estão preenchidos e quais continuam vazios — útil quando uma sessão termina cedo e queres saber o que a próxima vai perguntar. O vocabulário de estados mostrado aqui é o do tracker; a entrada de glossário estado da listagem explica o que significa cada estado.

Planear e retomar uma execução

Começa com um objetivo de 10 submissões novas confirmadas e um worker de browser. O planeador monta a execução a partir das vias prontas e gratuitas e guarda também um orçamento de tempo: 15 minutos por plataforma e, por defeito, 150 minutos ativos no total. Se houver menos vias adequadas do que o teu objetivo, propõe a execução mais pequena e honesta.

Guarda a execução e copia o prompt dela para o teu agente. Usa /goal quando o teu anfitrião o suportar; caso contrário, cola o mesmo texto como mensagem normal. O painel guarda o plano e mostra o trabalho que falta, mas não lança workers do agente nem executa ações no browser. Um objetivo não se sobrepõe aos limites do fornecedor nem aos desafios que exigem um humano.

Só contam as submissões novas confirmadas: em revisão, em fila, agendadas ou live, uma vez por plataforma. Rascunhos e listagens já existentes não contam. Retoma uma execução guardada em vez de começar uma nova que esquece o progresso anterior. O guia da execução explica a conclusão, as passagens para humano e a limpeza de janelas.

Registar resultados, catálogo e prompts

O formulário Registar resultado escreve através do scripts/record.py e aplica exatamente as regras da linha de comandos: um dos estados distintos, sem links nem segredos nas notas, um URL público mais a tua atestação para live, uma data de lançamento igual ou posterior à data mínima para scheduled, e uma substituição explícita quando já existe uma linha. O guia de registo de resultados percorre cada uma dessas regras e porque existem.

Novo produto pede o nome do produto, sugere um nome de pasta editável, com verificação de duplicados e nomes reservados, cria a pasta a partir de templates/project e entrega-te ou o prompt de onboarding para o teu agente ou os formulários para preencheres tu. Catálogo abre nas vias prontas e gratuitas verificadas, com as vias condicionais, só de pesquisa e indisponíveis em vistas separadas; podes pesquisar e filtrar, ler qualquer playbook, sobrepor o estado de um produto e registar diretamente a partir da lista. Prompts do agente e docs mostra os prompts do agente com botões de copiar e apresenta a documentação do kit no próprio painel, para raramente precisares de abrir os ficheiros markdown à mão.

O que nunca vai fazer

Os limites são deliberados e vale a pena conhecê-los antes de confiares nele:

• Liga-se a 127.0.0.1 e rejeita pedidos cross-site.
• Edita apenas os ficheiros JSON e markdown do produto que o agente também edita. O credentials.json é mostrado como plataforma, método e estado; os seus valores nunca são enviados para o browser.
• Não submete nada, não controla um browser e não verifica uma listagem. Registar um estado é uma declaração do operador, não evidência — o painel torna essa declaração fácil de fazer e difícil de fazer mal, nada mais.

Onde o painel se situa entre o produto, o agente e os diretórios está desenhado na página como funciona. Se quiseres experimentá-lo sem espaço de trabalho próprio, --demo é a porta de entrada.