Quick Start - : Central de Documentação do Alibaba Cloud

configure o QoderWake CN do zero: instale a ferramenta, abra o console, crie seu primeiro Waker, atribua tarefas e gerencie sua equipe.

Filosofia do product: Funcionários digitais 24/7, "Always awake, always working."

Recursos do product: Seguro e controlável, pronto para produção e em evolução contínua.

Conceitos principais: Role → Agent → Agent Teams.

Funções iniciais: Backend Engineer, Frontend Engineer, Test Engineer, Product Manager, Data Analyst e Content Operations, com suporte para criação de uma Custom Role.

Qual função você precisa?

O beta por convite inclui as funções a seguir. escolha a que melhor atende às suas necessidades.

Função	Descrição
Backend Engineer	Especializado em desenvolvimento de API, modelagem de dados, integração de service, otimização de desempenho e estabilidade online. Segue práticas de engenharia como entrega incremental, validação por testes e design orientado a convenções. O Agent analisa automaticamente bugs ou problemas, corrige o código e envia um PR.
Frontend Engineer	Focado em design e implementação de interfaces front-end. Destaca-se em arquitetura de componentes, refinamento de linguagem visual, design responsivo, otimização de acessibilidade e ajuste de desempenho. Adota entrega incremental, validação em camadas e verificação baseada em evidências para equilibrar experiência do usuário com qualidade de engenharia.
Test Engineer	Garante a qualidade de ferramentas de linha de comando e products web de uso geral. Concentra-se na criação de documentos de plano de teste, execução de testes ponta a ponta, reprodução de defeitos e geração de relatórios baseados em evidências. Não execute testes unitários nem corrige problemas.
Product Manager	Função de gestão de product orientada por IA para products de software. Foca em gestão de requisitos orientada a objetivos e de ciclo completo, geração de PRD, análise de feedback de usuários, pesquisa competitiva e comunicação de lançamentos. defina gates de aprovação claros para operações externas de escrita.
Data Analyst	Analista de dados orientado por IA, com foco em enquadramento de problemas, definição de métricas, coleta de dados via MCP a partir de documentos e planilhas do DingTalk, diagnóstico de dados, análise de contexto de mercado e recomendações baseadas em evidências.
Content Operations	Função de operações de conteúdo orientada por IA, com foco em posicionamento de conta, análise de tendências, gestão de calendário de conteúdo, criação de posts para Xiaohongshu, briefing de ativos visuais, publicação após aprovação, engajamento com comentários, revisão de desempenho, conformidade de marca e adaptação de conteúdo para múltiplas plataformas.
Custom	defina o fluxo de trabalho e o estilo de atuação da função por conta própria. É possível anexar qualquer configuração, como MCPs e Skills.

Preparação do ambiente

O QoderWake CN suporta implantação local e em cloud. Para uma operação 24/7 ideal, implante em um dispositivo sempre ligado e com conexão de rede estável, como uma máquina local dedicada ou um desktop em cloud.

A versão para Windows ainda não está disponível publicamente, mas será lançada em breve. Por enquanto, utilize o QoderWake CN no macOS ou Linux.

Implantação local

Implante em um dispositivo local estável e de execução contínua, como um Mac mini, para garantir operação 24/7 confiável.

macOS: 13,0 ou posterior.
Linux: Ubuntu 22.04 LTS ou posterior (recomendado). É necessário um ambiente de desktop gráfico para utilizar o Web Console local.

Implantação em cloud

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

Linux: Ubuntu 22.04 ou posterior. É necessário um ambiente de desktop gráfico para utilizar o Web Console local.

Pré-requisitos

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

git instalado.
Autenticação do repositório configurada.
Operações de clone, pull e push executadas com sucesso.

Tanto a implantação local quanto a em cloud exigem acesso à rede externa para login do usuário, chamadas ao modelo 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 esteja liberado.

Etapa 1: instale o QoderWake CN

macOS

acesse o site oficial do QoderWake CN para baixe o pacote de instalação.

Como alternativa, 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 service 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 automaticamente:

Detecta a arquitetura de CPU do Linux.
baixe e verifica o pacote de instalação do QoderWake CN para a sua plataforma.
instale o programa principal e os arquivos de recursos do QoderWake CN.
crie um ponto de entrada do comando e tenta adicioná-lo ao seu PATH.
Abre o navegador para login.
Inicia ou reinicia o service 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

A versão para Windows será lançada em breve. Esta página será atualizada quando a versão oficial estiver disponível.

Etapa 2: Abrir o console

Abra o navegador e acesse http://127.0.0.1:19830/. Este é o console local do QoderWake CN, onde você gerencie Wakers, atribui tarefas e configure permissões.

Visão geral da interface:

Barra lateral esquerda: Exibe a lista "My Wakers", com todos os Wakers criados e o horário da última atividade de cada um.
Botões superiores: clique em "Create Waker" para adicionar um novo Waker. No canto superior direito, é possível criar uma nova tarefa.
Área principal: Ao selecionar um Waker, a interface de chat abre por padrão, permitindo atribuir tarefas diretamente.
Barra lateral direita: Mostra detalhes das tarefas criadas e das tarefas em execução.

Na primeira visita, o sistema solicitará login. Siga as instruções na tela para concluir o processo.

Etapa 3: crie um Waker

clique em no botão "Create Waker" à esquerda.

selecione um modelo de função: Cada modelo vem com uma persona pré-definida, um fluxo de trabalho típico, um conjunto principal de Skills e prompts padrão. clique em "View Details" para visualizá-los.
Ou crie uma função personalizada: Se nenhuma das funções pré-configuradas atender às suas necessidades, selecione "Custom Role". defina a persona, a especialidade e o estilo de trabalho do Waker do zero, além de configure seus Skills, Connectors e permissões.
Preencha as informações básicas: insira o nome, avatar e bio do Waker. Ao selecionar uma função pré-configurada, essas informações são preenchidas automaticamente, mas é possível editá-las conforme necessário.
salve: clique em Save para criar o Waker. Após a criação, um guia de integração aparece, sugerindo quais Skills adicionar e quais canais conectar. Você pode ignorá-lo e fazer a configuração depois.

Para obter os melhores resultados com uma Custom Role, forneça informações abrangentes durante a criação. Isso inclui o posicionamento da função, responsabilidades principais, fluxo de trabalho, Skills necessários e capacidades de ferramentas como configuração de MCP.

Etapa 4: Começar a trabalhar com seu Waker

Após criar um Waker, você pode iniciar uma tarefa conversacional ou criar uma tarefa automatizada.

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 de acompanhamento ou ajustar a direção: Intervenha a qualquer momento; o Waker continuará com base no contexto.
Anexar arquivos ou capturas de tela: Adicione anexos em qualquer ponto da conversa.
Interromper: Pare o Waker caso ele saia do caminho esperado.
Aprovar operações: Quando o Waker precisa modifique um arquivo, execute um comando ou acessar a internet, ele pausa e solicita sua aprovação. clique em Allow ou Deny.
Responder às perguntas do Waker: Quando ele precisa tomar uma decisão, solicita sua contribuição. Faça sua seleção diretamente no cartão apresentado.
Trocar o modelo de IA: Se o modelo atual apresentar desempenho insatisfatório ou se você quiser reduzir custos, selecione um modelo diferente no menu suspenso superior e continue a conversa.
visualize o processo de raciocínio: Acompanhe em tempo real o raciocínio do Waker antes de ele tomar uma decisão.
visualize artefatos: O painel à direita exibe em tempo real a saída gerada pelo Waker, como patches de código e novos arquivos.
selecione 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 "execute uma vez por dia" ou "responder automaticamente a alterações em um repositório."

acesse Waker Details → Triggered Tasks → New para definir as seguintes opções:

Nome e descrição da tarefa: Ajuda o Waker a entender o que deve fazer.
Modelo de IA: escolha qual modelo utilizar.
Diretório de trabalho: O diretório local, repositório ou workspace do projeto onde a tarefa será executada.
Método de acionamento (até 5, combináveis):
- Agendado: execute uma vez, periodicamente ou com agendamento complexo (por exemplo, diariamente às 9h, toda segunda-feira ou no primeiro dia de cada mês).
- Orientado a eventos: Monitore alterações em issues, PRs ou comentários em um repositório GitHub.
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 definido. Você pode pausar ou ative a tarefa, execute-a imediatamente para testes ou consultar o histórico de execuções a qualquer momento.

Etapa 5: gerencie seus Wakers

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

Seção	Descrição
Home	Exibe o avatar do Waker, status, dias desde a criação, número de tarefas acionadas, número de tarefas conversacionais e mapa de atividade.
Projects	Vincule os repositórios de código ou diretórios locais onde o Waker trabalhará. Um projeto pode conter múltiplas 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 deste Waker.
Conversational tasks	Revise conversas anteriores e continue o diálogo.
Memory	visualize e edite o conhecimento de longo prazo do Waker sobre você e seus projetos. A memória provém de captura automática durante conversas, edições manuais e revisão periódica do sistema com deduplicação. Todos os dados de memória são armazenados localmente e não são enviados para a cloud.
Skills	instale novos Skills do Skills Marketplace oficial do Qoder CN, faça upload de Skills personalizados da sua máquina local ou ative e desative Skills existentes. Skills integrados não podem ser desinstalados.
Connectors	Integre com ferramentas e service externos como GitHub, Jira e GitLab.
Permissions	Tool Protection: Valida parâmetros de ferramentas com base em regras de segurança integradas para prevenir ameaças como injeção de comandos, abuso de recursos, execução de código, abuso de rede, acesso a arquivos sensíveis e escalação de privilégios. File Protection: Controla o acesso de leitura e escrita a arquivos locais. Built-in tools: 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 provém de três fontes:

Captura automática: O Waker salve automaticamente informações importantes das conversas.
Entrada manual: acesse a página Memory e edite entradas diretamente.
Revisão do sistema: O sistema organiza e deduplica periodicamente as entradas de memória.

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

Skills

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

Skills Marketplace: instale a partir do Skills Marketplace oficial do Qoder CN.
Upload Skill: Importe um Skill personalizado da sua máquina local.
Built-in Skills: Incluídos no sistema e não podem ser desinstalados.

acesse Waker Details → Skills para visualize Skills instalados, pesquisar no marketplace e fazer upload de Skills personalizados.

Connectors

Connectors vinculam Wakers a ferramentas e service externos. Você pode adicionar Connectors manualmente.

Projects

Um projeto define o workspace 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 mesmo projeto.
gerencie a memória própria do projeto, separada 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 configure categorias de proteção e políticas para ferramentas integradas.

Tool Protection: Valida parâmetros de ferramentas com base em regras de segurança integradas. Se uma regra de alto risco for acionada, o sistema solicita 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 de loopback local.
Acesso a arquivos sensíveis: Detecta acesso a arquivos críticos do sistema.
Escalação de privilégios: Detecta tentativas de escalação de privilégios, como o uso de sudo.

File Protection: Controla o acesso de leitura e escrita do Waker a arquivos locais.

Built-in tools: defina uma política Allow / Ask / Deny para cada ferramenta integrada disponível para o Waker.

Quando a ação de um 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

Há duas formas de abordar esse cenário.

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 analisa o problema, identifica a causa raiz e propõe uma solução. Após sua confirmação, ele aplica a correção e envia um PR. O Waker solicita sua aprovação antes de execute comandos ou modifique arquivos.

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

Feedback

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