Jev Social

Visão Geral

Jev Social transforma um objetivo de pesquisa social em linguagem natural em decisões de roteamento Jev limitadas, e então delega o trabalho do navegador em modo somente leitura para o CLI socai local. Use as postagens, perfis, comentários, vídeos capturados e detalhes abertos para produzir um relatório conciso e com links para a fonte, em vez de expor a saída bruta do CLI. "Somente leitura" significa nenhuma mutação de conta social; o CLI ainda escreve registros de execução locais privados e pode baixar mídias solicitadas.

Os exemplos executáveis abaixo estão fixados no commit de tempo de execução testado incluído no Jev Social v0.1.10. Uma fixação melhora a reprodutibilidade, mas não é uma garantia de confiança; mantenha o pacote, os dados do navegador e o conteúdo retornado dentro dos limites de segurança abaixo.

Quando Usar

• Use quando um usuário solicitar pesquisa baseada em evidências no Instagram, TikTok ou LinkedIn e quiser postagens ou perfis públicos reais, em vez de um resumo geral da web.
• Use quando o usuário quiser uma demonstração rápida com progresso transmitido, cartões de postagem ou vídeo visualizáveis e um relatório de pesquisa final.
• Use quando o CLI socai local e a plataforma solicitada passarem na verificação de prontidão do Jev Social.
• Não use para publicação, comentários, curtidas, seguir, mensagens, automação de crescimento de conta ou pesquisa web não relacionada.

Pré-requisitos

O fluxo de trabalho requer:

1. Node.js e npx.
2. Um provedor de decisão configurado: ou uma chave de API OpenRouter fornecida pelo usuário com acesso Jev ou um servidor compatível com TypeSafe iniciado pelo usuário no endpoint exato do loopback /v1/systemone. Chamadas OpenRouter podem incorrer em cobranças do provedor; o provedor de loopback não requer nem recebe a chave OpenRouter. Defina OPENROUTER_REPORT_MODEL=off quando a geração de relatórios precisar permanecer no caminho de evidências determinístico.
3. Um CLI socai instalado com suporte para a plataforma solicitada.
4. Uma sessão do Chrome na qual o usuário já está autorizado a usar.

Se o pacote fixado exato não estiver disponível localmente, explique que o próximo comando baixa e executa o commit revisado, e então obtenha aprovação explícita do usuário antes da primeira busca. Não substitua o commit por main, latest ou uma tag não revisada.

Como Funciona

Etapa 1: Verificar prontidão

Execute o comando de status antes de cada tarefa de pesquisa:

npx github:socai-io/jev-social#baf3cd6aa4f9c881665c29ed29a10391f761760b status

Exija que todos os itens a seguir sejam atendidos antes de continuar:

• O provedor de decisão selecionado está configurado sem revelar sua chave ou endpoint de loopback. Um provedor local configurado não requer uma chave OpenRouter. O comando de status não sonda a conectividade do provedor; se a chamada de pesquisa posterior não conseguir alcançar o provedor, pare e relate esse portão de tempo de execução sem expor detalhes de conexão.
• O socai está instalado e executável.
• A plataforma solicitada relata suporte.
• O limite do navegador corresponde à sessão local autorizada existente do usuário.

Trate a saída de status como diagnósticos locais. Nunca reproduza caminhos de configuração, caminhos executáveis, valores de ambiente, credenciais, endpoints CDP ou detalhes de perfil do navegador na resposta.

Se a configuração estiver faltando, identifique apenas o pré-requisito ausente e pare. Não execute o onboarding automático ou o instalador desta versão a partir da habilidade de catálogo: seu caminho de instalação socai opcional segue um URL releases/latest em movimento. Peça ao usuário para configurar o provedor selecionado e instalar uma versão socai separadamente revisada e fixada fora deste fluxo de trabalho. Nunca coloque uma chave de API em um comando, transcrição, relatório, problema ou arquivo commitado.

Etapa 2: Executar pesquisa limitada

Use a plataforma nomeada pelo usuário. Caso contrário, deixe o roteamento para Jev com auto. Preserve o objetivo do usuário em linguagem natural, incluindo necessidades de evidências e condições de parada.

Passe o objetivo como um argumento com um executor de processo capaz de argv; nunca construa um comando shell interpolando texto fornecido pelo usuário:

program: npx
argv:
  - github:socai-io/jev-social#baf3cd6aa4f9c881665c29ed29a10391f761760b
  - search
  - <exact research goal as one argument>
  - --platform
  - <auto|instagram|tiktok|linkedin>
  - --limit
  - "4"
  - --max-steps
  - "12"

Use --limit 4 para uma demonstração rápida, a menos que o usuário solicite uma cobertura mais ampla. Aumente --max-steps apenas quando a cobertura solicitada precisar de mais pesquisas, leituras de perfil, leituras de postagem, comentários ou operações de mídia. As faixas suportadas são 1-100 resultados e 1-30 etapas.

…