FolkPatch

🌏 Idiomas do README: English / 中文 / 日本語

FolkPatch - Ferramenta de gerenciamento Root focada em otimização de interface e expansão de funcionalidades

Construída com base no KernelPatch, oferece capacidade Root estável enquanto traz uma experiência de interface totalmente nova e um sistema de expansão em três camadas: APM / KPM / Plugins. Comece rapidamente com nossa documentação abrangente — instalação e uso, gerenciamento de módulos, desenvolvimento de plugins, configurações personalizadas, tudo em um só lugar.

📚 Ler a documentação completa →

---

✨ Introdução

🎨 Funcionalidades principais

• Implementação de Root baseada no KernelPatch
• Hook de funções do kernel sem necessidade de recompilar o kernel

📱 Requisitos

• Obrigatório: Dispositivo Android com arquitetura ARM64 e versão do kernel Linux de 3.18 a 6.15

🎨 Interface e design do gerenciador

• Nova UI e otimização da experiência de interação
• Suporte a papel de parede personalizado
• Suporte a internacionalização
• Otimização de desempenho de animações e fluidez de interação
• Aprimoramento de detalhes visuais e efeitos dinâmicos da interface
• Suporte para desativar manualmente a verificação de atualizações automáticas, devolvendo ao usuário o controle sobre as atualizações de versão

📦 Módulos e sistema de expansão

O FolkPatch oferece capacidade de expansão em três camadas, cobrindo diversas necessidades de personalização, do kernel ao espaço do usuário:

• APM: Sistema de módulos similar ao Magisk, com suporte a instalação em lote e backup completo
• KPM: Sistema de módulos do kernel (com suporte a inline-hook e syscall-table-hook), com suporte a carregamento automático
• Plugins (APD Lua Plugin): Extensão leve por scripts Lua, posicionada entre APM e KPM
• Loja integrada para baixar com um clique os APMs, KPMs e plugins mais populares

🧩 Sistema de plugins (APD Lua Plugin)

Os plugins são a extensão leve em espaço de usuário criada exclusivamente pelo FolkPatch, posicionando-se entre o APM (módulo em nível de sistema) e o KPM (módulo em nível de kernel): não modificam arquivos do sistema, não injetam no kernel, executando apenas scripts Lua durante o ciclo de vida do apd. Comparados aos módulos tradicionais, os plugins entram em vigor imediatamente após a instalação, sem necessidade de reinicialização, e possuem uma barreira de entrada menor para desenvolvimento.

Capacidades suportadas:

• Chave de ativação/desativação e ativação/desativação com um clique
• Ações rápidas (Action) e interface de configuração do usuário
• Tarefas de guarda agendadas (execução em segundo plano por polling)
• Logs de execução persistentes, com suporte a visualização, exportação e compartilhamento

Documentação completa sobre formato de pacote, API, ciclo de vida e comandos de gerenciamento dos plugins:

• 🇨🇳 中文：https://fp.mysqil.com/modules/plugin/
• 🇬🇧 English：https://fp.mysqil.com/en/modules/plugin/

⚡ Características técnicas

• Baseado em KernelPatch

🚀 Download e instalação

1. Download: Obtenha o pacote de instalação mais recente na página de releases

2. Instalação: Instale o pacote no seu dispositivo Android e siga as instruções no aplicativo para concluir a implantação

3. Comece a usar: Leia a documentação completa para conhecer usos avançados como gerenciamento de módulos e desenvolvimento de plugins

🙏 Agradecimentos open source

Este projeto é baseado nos seguintes projetos open source:

• KernelPatch - Componente principal
• Magisk - magiskpolicy
• KernelSU - UI do aplicativo e suporte a módulos similar ao Magisk
• Sukisu-Ultra - Referência de design de algumas interfaces
• APatch - Branch upstream
• MMRL - Referência de formato de dados e fonte de dados do repositório de módulos
• Shizuku - Serviço Shizuku integrado

📄 Licença

• O FolkPatch é open source sob a licença GNU General Public License v3 (GPL-3). Como modificador ou distribuidor, você deve seguir os seguintes padrões:
• Se você modificou o código ou integrou o FolkPatch em um projeto e o distribuiu a terceiros, todo o seu projeto deve ser igualmente open source sob a licença GPLv3
• Ao distribuir binários, você deve fornecer ativamente ou comprometer-se a fornecer o código-fonte completo e legível
• É estritamente proibido cobrar taxas de licenciamento pelo próprio licenciamento do software; você pode cobrar por distribuição, suporte técnico ou desenvolvimento personalizado
• O ato de distribuição representa que você concede a todos os usuários as patentes relacionadas envolvidas no projeto
• Este software é fornecido "como está", sem qualquer garantia, e o autor original não se responsabiliza por quaisquer perdas causadas pelo uso deste software
• Qualquer violação dos termos acima resultará no término automático da sua licença GPLv3; nesse caso, você perderá o direito legal de distribuir o FolkPatch, e o autor original reserva-se o direito de buscar responsabilidade por violação de direitos autorais conforme a lei (incluindo, mas não se limitando a, requerer liminar de cessação de violação, compensação econômica e remoção de projetos irregulares)

💬 Comunidade

Discussão e comunicação do FolkPatch

• Canal no Telegram: @FolkPatch