Biblioteca de leitura
Projete um painel de filtros que revele suas suposições
Faça o painel de LocalLLaMA explicar seus limites: condições visíveis, mudanças reversíveis, estado legível da requisição e alcance honesto do material.
Identifique cada filtro ativo
O painel descreve o material que uma requisição pode retornar. No caderno proposto, mostre q=quantization, subreddit=LocalLLaMA, limit=3 e page=1 como decisões distintas. Restringir a comunidade não garante que todas as discussões pertinentes pertençam a ela nem que o arquivo contenha todas. Coloque a pergunta por perto, como em quais condições a memória foi medida. Isso distingue um limite escolhido de uma ausência inexplicada.
Use rótulos alinhados ao contrato. Vários termos q analisados devem corresponder dentro de um title ou text, não nos dois simultaneamente nem reunindo correspondências parciais entre eles. kind=comment limita o tipo, mas não promete discussões completas. min_score=10 aplica um limiar ao valor armazenado, sem avaliar autoridade ou utilidade. Diferencie filtros omitidos de restrições ativas. Um padrão que estreita a consulta sem avisar também é uma decisão que precisa ser entendida.
Mostre uma restrição que possa ser removida
Permita remover uma condição sem reconstruir a requisição. A ação Remover pontuação mínima pode preservar consulta, comunidade e outros filtros. Mostre a mudança antes de enviar e comece a nova sequência em page=1. Isso permite comparar requisições declaradas. Não garante mais registros nem revela quantos foram excluídos: as respostas são limitadas, os totais podem ser limites inferiores e repetir a recuperação não promete imagem estável.
Não associe qualidade ao controle. Retirar min_score não significa convidar spam; acrescentar não seleciona evidência especializada. Pergunte o que o limiar contribui para essa investigação. Se apenas esconde perspectivas pouco familiares sem ajudar, pode ser razoável deixá-lo desligado. Envie explicitamente, não a cada ajuste. Toda recuperação bem-sucedida custa um crédito, inclusive vazia; explorar controles não deve virar silenciosamente um fluxo de requisições pagas.
Mantenha legível o estado da URL
Uma URL com filtros ativos registra as suposições da busca. Um exemplo é https://api.redditsearchapi.com/v1/search?q=quantization&subreddit=LocalLLaMA&limit=3&page=1. O aplicativo pode mostrar um resumo equivalente e guardá-lo no caderno. Codifique corretamente os valores ao construir URLs e use rótulos legíveis na interface. A requisição salva reproduz condições; não preserva a resposta antiga nem garante que os mesmos registros continuem disponíveis.
Não coloque a credencial na URL ou em capturas compartilhadas. O backend acrescenta X-API-Key ou Authorization: Bearer a partir do armazenamento de segredos. Consultas e notas também podem ser sensíveis: revise antes de compartilhar. Datas devem ser serializadas em from e to como YYYY-MM-DD UTC; to inclui o dia inteiro. Mudar período ou tamanho da página inicia outra comparação, não continua uma página cujos limites anteriores mudaram de significado.
Explique o alcance resultante
Ao receber a resposta, diferencie o exibido do que os metadados estabelecem. Mostre a quantidade realmente apresentada e qualifique pagination.total com pagination.relation. Use pelo menos para gte, não sinal de aproximação; em unknown ou null, informe total desconhecido. pagination.has_more controla a continuação na janela e pagination.window_exhausted indica seu limite final. Há no máximo 100 registros e 100 páginas. Nem o limite nem a contagem exata provam cobertura completa da comunidade ou do assunto.
Explique que os registros chegam em _doc, não em ordem cronológica, de relevância ou pontuação. Reorganizar localmente afeta apenas o carregado. São registros planos; título, autor, data e link podem faltar. parent_id e link_id opcionais permitem agrupar registros disponíveis, mas não são filtros nem prova de conversa completa. O painel deve permitir nomear restrições e incertezas, não confundir um formulário preciso com uma visão completa ou representativa do Reddit.
