MZX OS + MZX System Computer

Visão Geral

O projeto MZX OS visa transformar um dispositivo Android em um ambiente de "quase computador", controlável via PC, com uma interface desktop e funcionalidades avançadas. Este projeto é modular, leve e preparado para futuras expansões, incluindo a possibilidade de se tornar uma ROM customizada.

Estrutura do Projeto

O projeto é dividido nos seguintes módulos:

• /cli: Contém a ferramenta de linha de comando mzx-os-cli para interagir com o sistema.
• /core: Base do sistema (launcher avançada e estrutura para futura ROM).
• /android-launcher: Código-fonte do launcher Android com interface desktop.
• /bridge: Módulo MZX Bridge para comunicação entre PC e Android.
• /ai-engine: Módulo MZX AI Engine para integração com modelos de IA.
• /config: Arquivos de configuração do sistema.
• /logs: Diretório para logs do sistema.
• /scripts: Scripts auxiliares, como para configuração ADB.

Funcionalidades Principais

1. Core do Sistema

• Launcher Avançada: Interface estilo desktop (semelhante a Windows/Linux) com sistema de janelas, barra de tarefas e gerenciador de arquivos básico.
• Sistema de Apps Internos: Suporte para aplicativos nativos do MZX OS.

2. Modo "System Computer"

• Ativação Automática: Modo desktop ativado ao conectar via USB (futuramente HDMI).
• Suporte a Periféricos: Compatibilidade com mouse, teclado e gamepad.
• Interface Adaptativa: Transição fluida entre interfaces mobile e desktop.

3. Controle via PC

• MZX Bridge: Módulo interno para comunicação e controle remoto via USB Debugging.
• Integração ADB: Utiliza ferramentas ADB para espelhamento de tela e envio de comandos.

4. CLI (mzx-os-cli)

Um pacote NPM para gerenciar o MZX OS a partir do PC:

• mzx init: Inicializa o ambiente e verifica dependências.
• mzx connect: Detecta e conecta ao dispositivo Android.
• mzx install: Instala o MZX Launcher no dispositivo.
• mzx start: Ativa o modo MZX System Computer.
• mzx bridge: Inicia o MZX Bridge para controle remoto.
• mzx doctor: Diagnóstico de erros do sistema.
• mzx logs: Exibe os logs do sistema.

5. Sistema de IA Interno (MZX AI Engine)

• Integração Multimodelo: Suporte a OpenAI, Google Gemini, Anthropic e modelos locais via Ollama.
• Gerenciador de Modelos: Configuração flexível via config/models.json.
• Fallback Automático: Garante a continuidade do serviço em caso de falha de um modelo.

6. Sistema de Configuração

Arquivos de configuração centralizados na pasta /config:

• api.json: Chaves e configurações para APIs externas.
• local-models.json: Configurações para modelos Ollama.
• system.json: Configurações gerais do sistema MZX OS.
• device.json: Configurações específicas do dispositivo Android.

7. Logs e Debug

• Sistema de Logs Detalhado: Registra erros de API, falhas de conexão e falhas de modelo em /logs.
• Comando mzx logs: Acesso fácil aos logs via CLI.

8. Interface

• UI Moderna: Estilo dark, focado em produtividade, responsivo, simples e leve.

9. Arquitetura

• Backend/CLI: Node.js
• Android: Java/Kotlin (para o launcher)
• Comunicação: ADB e WebSocket.

Como Começar

1. Clone o Repositório:

   git clone <URL_DO_REPOSITORIO>
   cd mzx-os

2. Instalar Dependências da CLI e Bridge:

   npm install --workspaces

3. Configurar ADB: Certifique-se de ter o Android SDK Platform-Tools instalado e o adb configurado no seu PATH.

4. Configurar APIs (Opcional): Edite config/api.json e config/local-models.json com suas chaves de API e configurações de modelos, se for usar o MZX AI Engine.

5. Compilar o Android Launcher: Navegue até /android-launcher e compile o projeto Android para gerar o APK. (Instruções detalhadas serão adicionadas aqui).

6. Inicializar o MZX OS no Dispositivo: Conecte seu dispositivo Android via USB e execute:

   mzx init
   mzx install
   mzx start

7. Iniciar o MZX Bridge: Para controle remoto via PC:

   mzx bridge

Diferenciais

• Leveza: Projetado para rodar em celulares com hardware mais modesto.
• Modularidade: Fácil adição de novas funcionalidades e componentes.
• Escalabilidade: Preparado para crescimento e evolução para uma ROM completa.
• Compatibilidade Termux: Potencial para integração com Termux para maior flexibilidade.

Foco Final

O MZX OS é projetado para ser funcional, escalável, modular e preparado para evolução para uma ROM completa no futuro, oferecendo uma experiência de desktop completa em dispositivos Android.