Qoder CN Series:Quick Start

Implantação local

Implante em um dispositivo local estável e de longa duração, como um Mac mini, para garantir uma operação 24/7 confiável.

• macOS: 13,0 ou posterior.

• Linux: Recomenda-se Ubuntu 22.04 LTS ou posterior. Um ambiente de desktop GUI é necessário para usar o Web Console local.

Implantação em nuvem

O QoderWake CN é compatível com os principais ambientes de desktop em nuvem e servidores em nuvem. Para login conveniente via navegador e gerenciamento web local, utilize o Elastic Desktop Service (Edição Empresarial ou Pessoal).

• Linux: Ubuntu 22.04 ou posterior. Um ambiente de desktop GUI é necessário para usar o Web Console local.

Pré-requisitos

O QoderWake CN inclui várias funções de funcionários digitais pré-configuradas para desenvolvimento de software. Antes da instalação, certifique-se de que seu ambiente git esteja configurado e que sua conta de usuário tenha acesso ao repositório de código alvo:

• git instalado.

• Autenticação do repositório configurada.

• Execução bem-sucedida das operações clone, pull e push.

Tanto as implantações locais quanto em nuvem exigem acesso à rede externa para login do usuário, chamadas de modelos de IA e acesso ao repositório de código. Se você estiver atrás de uma rede corporativa, proxy ou firewall, garanta que o tráfego https de saída necessário seja permitido.

macOS

Acesse o site oficial do QoderWake CN para baixar o pacote de instalação.

Alternativamente, abra o Terminal e execute o seguinte comando:

curl -fsSL https://ide.qoder.com.cn/qoderwake-cn/install.sh | bash

O script detecta automaticamente sua plataforma, baixa e verifica o pacote de instalação, instala o programa principal e os arquivos de recursos, adiciona o ponto de entrada do comando ao seu PATH, abre o navegador para login, inicia o serviço local em segundo plano e abre o Web Console. O ponto de entrada do comando é: ~/.qoderwake-cn/bin/qoderwake.

Linux

Abra um terminal e execute o seguinte comando:

curl -fsSL https://ide.qoder.com.cn/qoderwake-cn/install.sh | bash

O script de instalação executa automaticamente as seguintes ações:

• Detecta a arquitetura da CPU do Linux.

• Baixa e verifica o pacote de instalação do QoderWake CN para sua plataforma.

• Instala o programa principal e os arquivos de recursos do QoderWake CN.

• Cria um ponto de entrada de comando e tenta adicioná-lo ao seu PATH.

• Abre o navegador para login.

• Inicia ou reinicia o serviço local em segundo plano após o login.

• Abre o Web Console local.

Ponto de entrada do comando:

~/.qoderwake-cn/bin/qoderwake-cn

Endereço padrão do Web Console:

http://127.0.0.1:19830

Windows

Tarefa conversacional

Digite sua solicitação na caixa de entrada e envie. O Waker começa a trabalhar imediatamente. Durante esse processo, você pode:

• Fazer perguntas complementares ou ajustar a direção: Interrompa a qualquer momento e o Waker continuará com base no contexto.

• Anexar arquivos ou capturas de tela: Adicione anexos em qualquer ponto da conversa.

• Interromper: Pare o Waker se ele desviar do objetivo.

• Aprovar operações: Quando o Waker precisar modificar um arquivo, executar um comando ou acessar a internet, ele pausará e solicitará sua aprovação. Clique em Allow ou Deny.

• Responder às perguntas do Waker: Quando precisar tomar uma decisão, ele solicitará sua entrada. Faça sua seleção diretamente no cartão apresentado.

• Trocar o modelo de IA: Se o modelo atual apresentar baixo desempenho ou se quiser reduzir custos, troque para outro modelo no menu suspenso superior e continue a conversa.

• Visualizar o processo de raciocínio: Acompanhe o pensamento do Waker em tempo real antes que ele tome uma decisão.

• Ver artefatos: O painel à direita mostra a saída gerada pelo Waker em tempo real, como patches de código e novos arquivos.

• Selecionar o diretório de trabalho: Na parte inferior do chat, escolha o diretório local onde o Waker operará.

Tarefa automatizada

Tarefas automatizadas são ideais para cenários como "executar uma vez por dia" ou "responder automaticamente a alterações em um repositório".

Acesse Waker Details → Triggered Tasks → New para configurar o seguinte:

• Nome e descrição da tarefa: Ajuda o Waker a entender o que deve ser feito.

• Modelo de IA: Escolha qual modelo utilizar.

• Diretório de trabalho: O diretório local, repositório ou espaço de trabalho do projeto onde a tarefa será executada.

• Método de acionamento (até 5, podem ser combinados):

  • Agendado: Execução única, periódica ou em cronogramas complexos (por exemplo, diariamente às 9h, toda segunda-feira ou no dia 1º de cada mês).

  • Orientado a eventos: Escuta alterações em issues, PRs ou comentários em um repositório do GitHub.

• Número máximo de execuções / Data de término (opcional): Evita que a tarefa seja executada indefinidamente.

Após salvar, o Waker é executado automaticamente conforme o agendamento. Pause ou ative a tarefa, execute-a imediatamente para testes ou visualize o histórico de execuções a qualquer momento.

Etapa 5: Gerenciar seus Wakers

Acesse a página de detalhes de um Waker para visualizar e ajustar suas configurações.

Seção	Descrição
Home	Visualize o avatar, status, dias desde a criação, número de tarefas acionadas, número de tarefas conversacionais e mapa de calor de atividades do Waker.
Projects	Vincule os repositórios de código ou diretórios locais onde o Waker trabalhará. Um projeto pode conter várias fontes (diretórios ou repositórios). A memória do projeto é separada da memória pessoal do Waker.
Triggered tasks	Adicione, exclua, modifique ou pause tarefas automatizadas para este Waker.
Conversational tasks	Revise conversas anteriores e continue o chat.
Memory	Visualize e edite o conhecimento de longo prazo do Waker sobre você e seus projetos. A memória origina-se de captura automática durante conversas, edições manuais e revisão/desduplicação periódica do sistema. Toda a memória é armazenada localmente e não é enviada para a nuvem.
Skills	Instale novas Skills no Qoder CN Skills Marketplace oficial, faça upload de Skills personalizadas da sua máquina local ou ative/desative Skills existentes. Skills integradas não podem ser desinstaladas.
Connectors	Integre com ferramentas e serviços externos como GitHub, Jira e GitLab.
Permissions	Proteção de Ferramentas: Valida parâmetros de ferramentas com base em regras de segurança integradas para evitar ameaças como injeção de comandos, abuso de recursos, execução de código, abuso de rede, acesso a arquivos sensíveis e escalonamento de privilégios. Proteção de Arquivos: Controla o acesso de leitura e gravação a arquivos locais. Ferramentas integradas: Defina uma política Allow / Ask / Deny para cada ferramenta integrada. Para operações de alto risco, um cartão de aprovação é exibido.

Configuração do Waker

Gerenciamento de memória

Cada Waker mantém memória de longo prazo sobre você e seus projetos. A memória vem de três fontes:

• Captura automática: O Waker salva automaticamente informações importantes das conversas.

• Entrada manual: Acesse a página Memory e edite as entradas diretamente.

• Revisão do sistema: O sistema organiza e desduplica periodicamente as entradas de memória.

Acesse Waker Details → Memory para navegar, pesquisar e editar todas as entradas de memória. A memória é armazenada localmente e não é enviada para a nuvem.

Skills

Skills são pacotes de capacidades que um Waker pode invocar durante tarefas conversacionais ou automatizadas.

• Skills Marketplace: Instale a partir do Qoder CN Skills Marketplace oficial.

• Upload Skill: Importe uma Skill personalizada da sua máquina local.

• Built-in Skills: Incluídas no sistema e não podem ser desinstaladas.

Acesse Waker Details → Skills para visualizar Skills instaladas, pesquisar no marketplace e fazer upload de Skills personalizadas.

Connectors

Connectors vinculam Wakers a ferramentas e serviços externos. Adicione Connectors manualmente.

Projects

Um projeto define o espaço de trabalho de um Waker. Acesse Waker Details → Projects para:

• Vincular diretórios locais ou repositórios git.

• Incluir múltiplas fontes (diretórios ou repositórios) em um projeto.

• Manter uma memória própria para o projeto, distinta da memória pessoal do Waker.

Gerenciamento de permissões

As permissões controlam o que um Waker pode ou não fazer. Acesse Waker Details → Permissions para configurar categorias de proteção e políticas para ferramentas integradas.

Proteção de Ferramentas: Valida parâmetros de ferramentas com base em regras de segurança integradas. Se uma regra de alto risco for acionada, o sistema solicitará autorização do usuário. As categorias de regras são:

• Injeção de comandos: Detecta operações perigosas como rm e mv.

• Abuso de recursos: Detecta fork bombs, reinicializações do sistema e ameaças similares.

• Execução de código: Detecta padrões de execução remota como curl | bash.

• Abuso de rede: Detecta reverse shells e acesso ao loopback local.

• Acesso a arquivos sensíveis: Detecta acesso a arquivos críticos do sistema.

• Escalonamento de privilégios: Detecta tentativas de escalonamento de privilégios, como o uso de sudo.

Proteção de Arquivos: Controla o acesso de leitura e gravação do Waker a arquivos locais.

Ferramentas integradas: Defina uma política Allow / Ask / Deny para cada ferramenta integrada disponível ao Waker.

Quando uma ação do Waker aciona uma regra de segurança, um cartão de aprovação aparece, permitindo que você autorize ou negue a operação.

Exemplo: Corrigir um bug automaticamente

Você pode abordar isso de duas maneiras.

Método A: Iniciar uma conversa manualmente: Abra o console e selecione um Waker com a função Backend Engineer. Na caixa de chat, digite: "Ajude-me a encontrar a causa raiz deste erro e forneça uma correção mínima," e anexe a mensagem de erro. O Waker analisará o problema, identificará a causa raiz e proporá uma solução. Após sua confirmação, ele aplica a correção e envia um PR. O sistema solicitará sua aprovação antes de executar comandos ou modificar arquivos.

Método B: Configurar uma tarefa automatizada: Acesse Waker Details → Triggered Tasks → New. Como método de acionamento, selecione "Event" e configure para escutar alterações de issues em um repositório do GitHub. Na descrição da tarefa, escreva: "Quando uma nova issue de bug for criada, analise-a automaticamente e crie um PR com a correção." Após salvar, o Waker iniciará automaticamente seu processo de análise e reparo sempre que uma nova issue de bug aparecer no repositório.

Feedback

Para relatar problemas ou sugerir recursos, clique em Feedback no canto inferior direito do console. Responderemos ao seu feedback prontamente.