📖 Documentação do Codis#
Documentação do Codis · Aether (v1.0.1). Os arquivos desta pasta alimentam a GitHub Wiki e o site. CHANGELOG, ROADMAP, CONTRIBUTING e SECURITY ficam na raiz do repositório.
Começando#
| Documento | Conteúdo | |
|---|---|---|
| 🚀 | Primeiros Passos | Instalação, requisitos, execução, wizard inicial |
| 🖥️ | Interface | Layout geral: Activity Bar, Sidebar, painéis, barra de status |
| 📸 | Previews | Tour visual: capturas do editor por dentro, painel por painel |
| ⌨️ | Atalhos | Referência completa de todos os atalhos e cheat sheet |
| ⚙️ | Configurações | As 24 categorias de config.json, com tipo e valor padrão |
| 🎨 | Temas | Temas built-in, pré-visualização, criação customizada e via plugin |
| ❓ | FAQ | Perguntas frequentes e solução de problemas |
| 🛠️ | Solução de Problemas | Diagnóstico técnico avançado: comandos, logs, causas |
Editando#
| Documento | Conteúdo | |
|---|---|---|
| ✏️ | Editor | Syntax highlighting, autocomplete, snippets, minimap, dobramento |
| 🧠 | Inteligência do Editor | Multi-Cursor, Smart Tips, Complexity Lens, Code Rhythm, Edit Heatmap |
| 📚 | KDocs | Documentação nativa (Python/Rust/Go/Ruby/Lua/C++/C#/JSDoc), hover balloon |
| 🔍 | Linting & LSP | ESLint, Flake8, Mypy, Pylint, language servers externos |
| 🐞 | Debug | Depuração real via DAP/debugpy: breakpoints, stepping, variáveis, console |
| 🌿 | Git | Painel Git completo, autenticação HTTPS/SSH, blame inline |
| 💻 | Terminal | Shell integrado, múltiplas sessões, REPLs |
| 🗂️ | Workspace & Produtividade | Workspace Switcher, Templates, Code Runner, Macros, Key Remapper, Trust |
| 🛠️ | Utilitários de Desenvolvimento | Formatador, Variáveis de Ambiente, Grafo de Dependências |
Assistente e conectividade#
| Documento | Conteúdo | |
|---|---|---|
| 🤖 | Assistente de IA | Providers, Skills, 40 ferramentas, Approval Gate, Diff interativo |
| 💬 | Chat ao Vivo | Cliente multi-protocolo: IRC, XMPP, Matrix, Slack, Discord, Telegram, Mattermost, MQTT e WebSocket |
| 🌐 | SSH Remoto | Edição de arquivos em servidores remotos via SSH/SFTP |
| 👥 | Colaboração em Tempo Real | Edição simultânea do mesmo arquivo via WebSocket, cursores remotos |
Ferramentas e extras#
| Documento | Conteúdo | |
|---|---|---|
| 💎 | Recursos Avançados | SQL Studio, Task Manager, LSP, Diff visual, Bookmarks |
| 🌟 | Recursos Exclusivos | Vim Mode imersivo, Zen Mode, Zen Media, easter eggs |
| ✦ | K-UI | Engine holográfica: nebulosas, animações cósmicas, easter eggs |
| ⚡ | Sistema & Performance | Pip Manager, Process Manager, Modo Performance, Cursor, Remote Browser |
| 🗄️ | Backups, Lixeira & Arquivos | File Timeline, Lixeira, Visualizador de ZIP/RAR/7z |
| 📤 | Painel de Saída | Output Panel: canais, níveis de log e bridge de logging |
| ♿ | Acessibilidade | Alto contraste, modos para daltonismo, navegação por teclado |
| 🖌️ | Editor de Imagens (Paint) | Editor de imagens básico, embutido ou standalone |
| 📅 | Utilitários Pessoais | Calendário, Calculadora, Relógio/Alarmes/Cronômetro |
| 🪟 | Incorporar Programas e Preview Web | /codis app (adotar/iniciar janelas) e navegador real embutido |
| 👹 | DOOM Embutido | /codis doom: motor, IWAD e reparentamento da janela |
Para quem desenvolve#
| Documento | Conteúdo | |
|---|---|---|
| 🧩 | Plugins | API: eventos, painéis, storage, sandbox, hot-reload |
| 🏗️ | Arquitetura | Estrutura de módulos, fluxo de inicialização, dependências |
| 📦 | Builds & CI/CD | Empacotamento (PyInstaller/ZIP) e os 10 workflows do GitHub Actions (pipeline commit → build → release) |
| 🔄 | Atualizador | Modos SMART/ZIP/REINSTALL/FORCE/BINARY, backup e rollback, caminhos protegidos |
| 🧪 | Testes | Suíte de testes, fixtures, convenções e como contribuir com testes |
Visão Geral#
O Codis é um editor de código desktop completo construído sobre Python 3 e Tkinter. Apesar de usar uma stack de UI clássica, o projeto leva o Tkinter além dos seus limites:
- K-UI - engine de renderização cósmica com nebulosas, auroras e partículas animadas em thread separada (PIL)
- Vim Mode - janela CLI imersiva separada com 6 modos do Vim
- Zen Media - player de mídia integrado ao Modo Zen com backend VLC/MPV não-bloqueante
- KDocs - motor de documentação universal com suporte nativo a Python (Google/NumPy/Sphinx), Rust, Go, Ruby, Lua, C/C++, C# e mais
- LSP - integração nativa com servidores de linguagem externos (pylsp, tsserver, rust-analyzer…)
- IA multi-provedor - Anthropic, OpenAI, OpenAI-compatível, Gemini, Ollama e modelos GGUF locais, com 15 Skills e 40 ferramentas
- SQL Studio - banco de dados integrado com suporte a SQLite, PostgreSQL, MySQL e DuckDB
- Task Manager - quadro Kanban com agendador de comandos shell integrado
- Plugins - API completa com sandbox estática, eventos com prioridade e armazenamento persistente por plugin
Licença#
MIT - © KillovSky