Introdução
Toda vez que você usa o CLI do Copilot, um conjunto completo de dados sobre sua sessão, incluindo seus prompts, as respostas do Copilot, as ferramentas que foram usadas e detalhes dos arquivos que foram modificados, é registrado no seu computador local. Com o tempo, isso constrói um histórico rico sobre em que você trabalhou, como trabalhou e o que o Copilot fez por você.
Esses dados de sessão alimentam vários recursos:
-
**Retomando sessões**: você pode continuar de onde parou em qualquer sessão anterior. -
**Fazendo perguntas sobre seu histórico**: você pode fazer perguntas ao Copilot sobre suas atividades passadas, e ele consultará seus dados de sessão para respondê-las. -
**O comando barra `/chronicle`**: um conjunto de subcomandos com propósito específico que geram relatórios de reunião, dicas personalizadas e sugestões para melhorar suas instruções personalizadas, todos derivados do histórico de sessão.
Este artigo conceitual explica como os dados de sessão são armazenados e como você pode aproveitá-los para aprimorar seu fluxo de trabalho. Para obter um guia prático para retomar uma sessão, consultar o Copilot sobre suas sessões da CLI e usar o comando barra /chronicle, consulte Usando dados de sessão CLI do GitHub Copilot.
Observação
O comando /chronicle e a capacidade de Copilot de responder perguntas sobre seu histórico de sessão são funcionalidades experimentais atualmente, e estão disponíveis somente se você tiver utilizado o comando de barra /experimental on ou a opção de linha de comando --experimental.
Como os dados de sessão são armazenados
Cada sessão do CLI do Copilot é mantida como um conjunto de arquivos no diretório ~/.copilot/session-state/ do seu computador. Os dados de cada sessão contêm um registro completo da sessão. Esses arquivos permitem que você retome uma sessão interativa da CLI.
Além dos arquivos de sessão, CLI do Copilot armazena dados de sessão estruturados em um banco de dados SQLite local, chamado de repositório de sessão. Esses dados são um subconjunto dos dados completos armazenados nos arquivos de sessão. O repositório de sessão é o que alimenta o comando barra /chronicle e também permite que o Copilot responda às perguntas que você faz sobre seu trabalho anterior.
Localidade de dados e privacidade
Todos os dados de sessão são armazenados localmente em seu diretório inicial e só podem ser acessados para sua conta de usuário. O Copilot lê esses dados em seu computador quando você faz perguntas sobre suas interações com a CLI ou quando usa o comando barra /chronicle. Dados de sessão, como seus prompts anteriores, dados de contexto e respostas que você recebeu podem ser enviados para o modelo de IA, assim como aconteceria em qualquer interação normal do CLI do Copilot.
Se você quiser remover dados de uma sessão específica da CLI, poderá excluir o diretório de sessão relevante de ~/.copilot/session-state/. Você pode limpar todos os dados de sessão excluindo tudo em ~/.copilot/session-state/. Depois de fazer isso, você deve reindexar manualmente o repositório de sessão. Consulte a reindexação do armazenamento de sessão mais adiante neste artigo.
Sobre o comando barra /chronicle
O comando /chronicle SUBCOMMAND usa os dados no repositório de sessão para fornecer insights e sugestões sobre o uso do CLI do Copilot.
Você pode inserir os seguintes comandos em uma sessão interativa da CLI:
-
`/chronicle standup`: gera um relatório breve resumindo em que você trabalhou em suas sessões recentes da CLI, incluindo nomes de ramificações, links de solicitações de pull e verificações de status. -
`/chronicle tips`: Fornece dicas personalizadas sobre como usar CLI do Copilot com mais eficiência. -
`/chronicle improve`: analisa seu histórico de sessão para identificar padrões em que Copilot pode ter entendido mal sua intenção ou onde houve um monte de idas e vindas e gera instruções personalizadas para ajudar Copilot entender melhor você no futuro. -
`/chronicle reindex`: Recria o armazenamento de sessão a partir dos arquivos de histórico de sessão.
Benefícios de /chronicle e os dados da sessão
-
**Fluxo de trabalho de auto-aperfeiçoamento**: o `improve` subcomando cria um ciclo de feedback que ajuda você a refinar suas instruções personalizadas. Com o tempo, isso torna o agente mais eficaz para seu projeto específico. -
**Relatórios de reunião sem esforço**: em vez de reconstruir manualmente o que você fez ontem, o `/chronicle standup` gera um resumo de reunião a partir dos dados reais da sua sessão. -
**Coaching personalizado**: o subcomando `tips` atua como um treinador pessoal de produtividade que sabe o que o CLI do Copilot pode fazer e como você realmente o utiliza. Ele faz a ponte entre os recursos disponíveis e o fluxo de trabalho atual. -
**Fale com seu histórico de codificação**: o repositório de sessão permite que o Copilot responda a qualquer pergunta com a qual suas sessões anteriores possam ajudar – desde a recuperação de uma correção de bug que você fez na semana passada até analisar seus padrões de prompts ao longo do tempo. -
**Local e privado**: todos os dados de sessão, tanto os arquivos JSONL brutos quanto o repositório de sessão SQLite, permanecem no computador. Nada é carregado ou compartilhado além das interações normais do modelo de IA que ocorrem em qualquer sessão do CLI do Copilot. Você tem controle total sobre seus dados e pode excluí-los a qualquer momento.
Quando você deve usar esses recursos?
-
**No início do seu dia**: execute `/chronicle standup last 3 days` para gerar um lembrete do que você trabalhou recentemente e da sessão da CLI em que você estava trabalhando. -
**Periodicamente, para nivelar**: execute `/chronicle tips` a cada semana ou duas para descobrir recursos e melhorias de fluxo de trabalho que você pode estar perdendo. -
**Quando Copilot continua cometendo o mesmo erro**: execute `/chronicle improve` para identificar o padrão e gerar instruções personalizadas para corrigi-lo. -
**Para lembrar do trabalho passado**: faça uma pergunta de forma livre como "Trabalhei em algo relacionado à API de pagamentos?" e Copilot pesquisará seu histórico. -
**Para continuar o trabalho anterior**: use `copilot --continue` ou `copilot --resume` para continuar de onde parou.
Reindexação do armazenamento de sessão
O repositório de sessão é preenchido incrementalmente durante uma sessão da CLI. Os dados de uma sessão são gravados em disco em um subdiretório específico da sessão de ~/.copilot/session-state/. Isso também ocorre periodicamente durante uma sessão e também quando a sessão termina.
Você pode reindexar o repositório de sessão dos arquivos de sessão no disco, embora normalmente você nunca precise fazer isso.
As situações em que talvez seja necessário reindexar incluem:
-
**Indexando sessões antigas**: se você tiver arquivos de sessão antigos no disco que foram criados antes da existência do repositório de sessão, a reindexação preencherá o repositório de sessão com dados dessas sessões. -
**Exclusão** de sessão: se você quiser excluir uma sessão do seu histórico, poderá excluir o diretório da sessão e reindexar o repositório de sessão. -
**Migrando/recuperando sessões**: se você moveu seus arquivos de sessão para outro computador ou restaurou-os de um backup, sem também mover/restaurar o arquivo do repositório de sessão (`~/.copilot/session-store.db`), você poderá usar o comando reindex para recriar o repositório de sessão. -
**Corrupção** de arquivos: se o arquivo do repositório de sessão (`~/.copilot/session-store.db`) ficar corrompido ou for excluído acidentalmente, você poderá recuperar o repositório de sessão dos arquivos de sessão. -
**Encerramento inesperado**: se uma sessão for encerrada inesperadamente (por exemplo, devido a uma falha ou perda de energia) antes que os dados mantidos na memória sejam liberados para o repositório de sessão, você poderá preencher o repositório de sessão com os dados ausentes se ele tiver sido gravado em disco, nos arquivos de sessão, antes do encerramento.
Para reindexar o repositório de sessão, use o seguinte comando barra em uma sessão interativa do CLI:
/chronicle reindex
/chronicle reindex
Leitura adicional
-
[AUTOTITLE](/copilot/how-tos/copilot-cli/chronicle) -
[AUTOTITLE](/copilot/reference/cli-command-reference)