From 6c7309674e2ecd2480c9515c05c214a67eb9522b Mon Sep 17 00:00:00 2001 From: Lukas Geiger Date: Wed, 28 Oct 2026 14:51:05 +0100 Subject: [PATCH 1/3] docs: add French README and clarify language availability --- README.es.md | 2 +- README.fr.md | 425 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.ja.md | 2 +- README.md | 2 +- README.ru.md | 2 +- README.zh.md | 2 +- README_de.md | 2 +- llms.txt | 3 +- 8 files changed, 433 insertions(+), 7 deletions(-) create mode 100644 README.fr.md diff --git a/README.es.md b/README.es.md index e4b6ece..60ccd55 100644 --- a/README.es.md +++ b/README.es.md @@ -18,7 +18,7 @@ [![Última comprobación](https://img.shields.io/badge/last%20checked-2026--10--04-informational.svg)](llms.txt) [![llms.txt](https://img.shields.io/badge/llms.txt-available-green.svg)](llms.txt) -[English](README.md) | [Deutsch](README_de.md) | Español | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Русский](README.ru.md) +[English](README.md) | [Deutsch](README_de.md) | Español | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Русский](README.ru.md) | [Français](README.fr.md) CodeBox es un entorno de desarrollo integrado (IDE) de escritorio local-first para desarrolladores de Windows, Linux y macOS que buscan un editor de código ligero en PySide6 con espacio de trabajo con múltiples pestañas, árbol de proyectos, terminal integrado, indicadores de estado de Git porcelain, resaltado de sintaxis, diagnóstico de Language Server Protocol (LSP) y una arquitectura extensible de complementos de lenguajes en JSON/Python. diff --git a/README.fr.md b/README.fr.md new file mode 100644 index 0000000..53648c4 --- /dev/null +++ b/README.fr.md @@ -0,0 +1,425 @@ +Bannière CodeBox + +# CodeBox — Éditeur de code de bureau PySide6 privilégiant le local + +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) +[![Attribution: NOTICE](https://img.shields.io/badge/Attribution-NOTICE-blue.svg)](NOTICE) +[![Python 3.10+](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue.svg)](https://www.python.org/) +[![Platform: Windows | Linux | macOS](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]() +[![CI](https://github.com/dev-bricks/CodeBox/actions/workflows/ci.yml/badge.svg)](https://github.com/dev-bricks/CodeBox/actions/workflows/ci.yml) +[![Tests](https://img.shields.io/badge/tests-360%20passed%20%7C%20100%25-brightgreen.svg)]() +[![Privacy: Zero-Egress](https://img.shields.io/badge/privacy-100%25%20local--first%20%7C%20zero--egress-success.svg)](SECURITY.md) +[![Security Policy](https://img.shields.io/badge/security-bilingual%20policy-blue.svg)](SECURITY.md) +[![Ecosystem: dev-bricks](https://img.shields.io/badge/ecosystem-dev--bricks-blue.svg)](https://github.com/dev-bricks) +[![Part of: open-bricks](https://img.shields.io/badge/part%20of-open--bricks-blue.svg)](https://github.com/open-bricks) +[![LSP Ready](https://img.shields.io/badge/LSP-ready-purple.svg)]() +[![Version: 0.3.5](https://img.shields.io/badge/version-0.3.5-green.svg)](CHANGELOG.md) +[![SBOM Level 1](https://img.shields.io/badge/SBOM-Level%201%20Audited-blue.svg)](THIRD_PARTY_LICENSES.md) +[![Last Checked](https://img.shields.io/badge/last%20checked-2026--10--04-informational.svg)](llms.txt) +[![llms.txt](https://img.shields.io/badge/llms.txt-available-green.svg)](llms.txt) + +[English](README.md) | [Deutsch](README_de.md) | [Español](README.es.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Русский](README.ru.md) | Français +> Cette version traduit uniquement la documentation. CodeBox propose toujours une interface utilisateur en six langues : allemand, anglais, espagnol, chinois, japonais et russe. + +CodeBox est un IDE de bureau privilégiant l’exécution locale, conçu pour les développeurs Windows, Linux et macOS qui recherchent un éditeur de code PySide6 léger avec un espace de travail à plusieurs onglets, une arborescence de projet, un terminal intégré, des indicateurs d’état Git au format porcelain, la coloration syntaxique, les diagnostics du Language Server Protocol (LSP) et une architecture extensible de plugins de langage en JSON et Python. + +> [!NOTE] +> Pour le contexte destiné aux agents d’IA et à la découverte automatisée, consultez [llms.txt](llms.txt), qui fournit des informations lisibles par machine, des résumés de l’architecture et des liens de navigation. + +--- + +## Navigation rapide + +- [1. Pour commencer](#start-here) +- [2. Architecture du système](#system-architecture) +- [3. Cycle de vie complet du flux de travail](#end-to-end-workflow-lifecycle) +- [4. Capacités clés et invariants d’exécution](#key-capabilities--runtime-invariants) +- [5. Aperçu visuel](#visual-showcase) +- [6. Profils cibles et cas d’utilisation](#target-personas--use-cases) +- [7. Comparaison avec les solutions de remplacement](#comparative-matrix-vs-alternatives) +- [8. Fonctionnalités](#features) +- [9. Installation et démarrage rapide](#installation--quickstart) +- [10. Configuration du Language Server Protocol (LSP)](#language-server-protocol-lsp-setup) +- [11. Système déclaratif de plugins](#declarative-plugin-system) +- [12. Compilation locale sous Windows](#local-windows-build) +- [13. Structure du projet](#project-structure) +- [14. Écosystème associé](#sibling-ecosystem) +- [15. Recherche et désambiguïsation](#search--disambiguation) +- [16. Licences tierces et SBOM de niveau 1](#third-party-licenses--level-1-sbom) +- [17. Sécurité et confidentialité](#security--privacy) +- [18. Licence et responsabilité](#license--liability) + +--- + + +## Pour commencer + +| Besoin | Commencer par | +| --- | --- | +| Lancer l’éditeur depuis les sources | `pip install -r requirements.txt` et `python main.py` | +| Ouvrir directement un fichier précis | `python main.py --open path/to/file.py` | +| Gérer les plugins et les langages | `Ctrl+Shift+P` ou menu *Edit -> Plugins & Languages...* | +| Consulter les raccourcis clavier | `F1` ou menu *Help -> Keyboard Shortcuts* | +| Créer un exécutable Windows autonome | `build_exe.bat` | +| Ajouter des diagnostics ou la complétion | Installer un serveur de langage local, par exemple `python-lsp-server[all]` | +| Parcourir le plan de développement | [DEVELOPMENT_PLAN.md](DEVELOPMENT_PLAN.md) | +| Lire les consignes de sécurité | [SECURITY.md](SECURITY.md) | + +--- + + +## Architecture du système + +```mermaid +flowchart TD + subgraph UI ["Desktop UI Layer (PySide6)"] + MW["MainWindow (ui/main_window.py)"] + TB["ToolBar & Action Dispatcher"] + ST["StatusBar & Position/Encoding/Language"] + MW --> TB + MW --> ST + end + + subgraph Core ["Editor Core & Tab Management"] + Tabs["TabWidget (core/tabs.py)"] + Ed["CodeEditor & UniversalHighlighter (core/highlighter.py)"] + MM["Minimap Widget (core/minimap.py)"] + BM["BracketMatcher (core/bracket_matcher.py)"] + Tabs --> Ed + Ed --> MM + Ed --> BM + end + + subgraph Workspace ["Workspace & Project Tree"] + PT["ProjectTree & FilterProxy (features/project_tree.py)"] + Git["Git Porcelain Status Resolver (features/git_status.py)"] + PT --> Git + end + + subgraph Diagnostics ["Language Server & Diagnostics Engine"] + LSPMgr["LSPManager & Client Thread (features/lsp_manager.py)"] + Linter["Background Linter (Ruff/flake8/ESLint) (features/linter.py)"] + Prob["ProblemsPanel (ui/problems_panel.py)"] + LSPMgr --> Prob + Linter --> Prob + end + + subgraph Runtime ["Execution & Extensibility"] + Term["Integrated Terminal QProcess (features/terminal.py)"] + Out["OutputPanel Process Runner (core/output.py)"] + PluginMgr["PluginManager (features/plugin_manager.py)"] + Decl["Declarative Providers (languages/declarative.py)"] + Theme["ThemeManager (features/theme_manager.py)"] + PluginMgr --> Decl + end + + MW --> Tabs + MW --> PT + MW --> Diagnostics + MW --> Term + MW --> Out + MW --> PluginMgr + MW --> Theme +``` + +--- + + +## Cycle de vie complet du flux de travail + +```mermaid +sequenceDiagram + autonumber + actor Dev as Developer + participant UI as MainWindow + participant Ed as CodeEditor (Tabs) + participant Linter as Background Linter + participant LSP as LSP Client Thread + participant Prob as ProblemsPanel + participant Term as Terminal / Runner + + Dev->>UI: Launch CodeBox & Open File + UI->>Ed: Load Buffer & Attach UniversalHighlighter + Ed-->>Dev: Render Syntax Highlighting & Line Numbers + + Dev->>Ed: Edit Code & Save (Ctrl+S) + Ed->>Linter: Dispatch non-blocking lint trigger + Ed->>LSP: Notify textDocument/didSave + + par Background Diagnostics + Linter->>Linter: Execute Ruff / flake8 / ESLint (subprocess) + Linter-->>Prob: Update Linter Diagnostics + and Language Server Analysis + LSP->>LSP: Query Language Server (pylsp / clangd / rust-analyzer) + LSP-->>Prob: Update LSP Diagnostic Markers + end + + Prob-->>UI: Aggregate Findings & Highlight Errors + UI-->>Dev: Display in Problems Panel & Status Bar + + opt Run Code in Terminal / Output + Dev->>UI: Trigger Run (F5) + UI->>Term: Spawn QProcess (cmd/powershell/bash) + Term-->>Dev: Stream Output & Error Codes + end +``` + +--- + + +## Capacités clés et invariants d’exécution + +| Capacité / principe | Détails de l’implémentation | Garantie / invariant | +| --- | --- | --- | +| **Priorité au local et absence de sortie réseau** | L’éditeur, la coloration syntaxique, les plugins et le terminal fonctionnent entièrement hors ligne. | Aucune télémétrie ni requête réseau externe pendant l’édition standard. | +| **Sans élévation (mode utilisateur)** | Fonctionne entièrement dans l’espace utilisateur sans privilèges. | Aucun privilège administrateur ou root n’est demandé. | +| **Coloration syntaxique multilangage** | Moteur regex universel (`UniversalHighlighter`) avec échappement des limites. | Python, JavaScript, TypeScript, C++, Rust, Go, Java et plugins personnalisés. | +| **Système de plugins extensible** | Format JSON déclaratif (`plugins/*.json`) et classes Python dynamiques. | Rechargement à chaud et découverte automatique sans modifier les fichiers source du cœur. | +| **Diagnostics et complétion LSP** | Client Qt thread-safe communiquant par stdin/stdout avec les Language Servers standard. | Interface non bloquante ; compatible avec pylsp, typescript-language-server, rust-analyzer, clangd et gopls. | +| **Analyse en arrière-plan** | Exécution asynchrone des linters locaux (Ruff, flake8, ESLint) à l’enregistrement. | Erreurs et avertissements regroupés dynamiquement dans un panneau unifié. | +| **Résilience en cas d’échec d’enregistrement** | Opérations d’écriture sur le système de fichiers protégées, avec conservation du tampon. | Les onglets restent ouverts et les modifications non enregistrées sont protégées si l’écriture échoue. | +| **Terminal intégré** | Terminal `QProcess` intégré prenant en charge `cmd`, `PowerShell` et `bash`. | Adaptation dynamique de l’encodage (cp1252 / utf-8) et synchronisation du répertoire de travail. | +| **Espaces de travail multi-racines** | Format natif `.codebox-workspace` avec chemins relatifs portables. | Passage fluide entre plusieurs racines de dépôts (`Ctrl+Shift+O`). | +| **Recherche globale dans les fichiers** | Recherche grep multithread (`core/file_search.py`) avec `Ctrl+Shift+F`. | Recherche rapide non bloquante avec options Regex/Mot/Casse et accès direct au résultat. | +| **Aller à la définition et aux références** | Requêtes LSP `textDocument/definition` et `references` (`F12`, `Shift+F12`), avec solution de repli AST/regex. | Navigation instantanée entre symboles dans les fichiers ouverts et les projets de l’espace de travail. | +| **Tâches et panneau TODO** | Analyse automatique en arrière-plan (`core/todo_scanner.py`) des marqueurs TODO, FIXME, BUG et HACK (`Ctrl+Alt+T`). | Accès direct, regroupement par fichier et marqueur, et filtrage des résultats en temps réel. | + +--- + + +## Aperçu visuel + +![Fenêtre principale de CodeBox](README/screenshots/main.png) +*Figure 1 : interface de bureau CodeBox avec l’arborescence de navigation du projet, l’éditeur à plusieurs onglets et coloration syntaxique, le terminal intégré et le panneau de diagnostics.* + +--- + + +## Profils cibles et cas d’utilisation + +CodeBox est conçu pour les développeurs soucieux de la confidentialité, les ingénieurs systèmes et les créateurs d’outils spécialisés qui ont besoin d’un IDE de bureau isolé du réseau : + +| Identifiant | Profil cible | Besoin central et difficulté rencontrée | Réponse de CodeBox | Requêtes de recherche à forte intention | +|---|---|---|---|---| +| **[PERSONA-01]** | **Développeurs privilégiant le local et le hors ligne** | Sont frustrés par les connexions cloud imposées, l’envoi de télémétrie et l’activité réseau silencieuse des éditeurs de code modernes. | Exécution entièrement isolée du réseau, sans sortie réseau (`INV-LOCAL-01`). Aucune télémétrie distante ni dépendance au cloud, tout s’exécute localement. | `local-first code editor`, `zero-egress python IDE`, `offline code editor windows` | +| **[PERSONA-02]** | **Ingénieurs bureau et systèmes** | Subissent la consommation de plusieurs gigaoctets de RAM des IDE basés sur Electron et des démarrages de plus de 10 secondes dans des configurations multiprojets. | Moteur natif PySide6 / C++ Qt, démarrage en moins d’une seconde, faible empreinte mémoire de base et terminal multicoque intégré (`INV-PERF-02`, `INV-TERM-06`). | `lightweight desktop IDE python`, `fast python code editor`, `pyside6 code editor` | +| **[PERSONA-03]** | **Responsables sécurité et conformité** | Doivent garantir la transparence de la chaîne d’approvisionnement, un fonctionnement sans privilèges, l’absence de code copyleft indésirable et des délais de traitement des vulnérabilités définis. | Exécution sans privilèges via RunAsInvoker (`INV-NOELEV-02`), SBOM de niveau 1 avec isolation dynamique de LGPL-3.0 (`INV-LGPL-03`) et délai de réponse de 48 heures pour les signalements de sécurité (`INV-SLA-10`). | `secure offline editor SBOM`, `MIT code editor zero copyleft`, `enterprise compliant desktop IDE` | +| **[PERSONA-04]** | **Auteurs de DSL et d’outils** | Les modèles d’extension complexes des IDE historiques exigent compilation, empaquetage et comptes sur des marchés propriétaires. | Système déclaratif de plugins JSON (`INV-PLUG-07`) pour définir dans de simples fichiers JSON la coloration syntaxique, les règles de commentaires et les paires automatiques, avec rechargement à chaud immédiat. | `declarative language editor plugin`, `custom dsl syntax highlighter`, `json language definition ide` | + +--- + + +## Comparaison avec les solutions de remplacement + +Le tableau suivant compare CodeBox à quatre environnements de développement de bureau courants selon dix invariants techniques essentiels : + +| Invariant technique | CodeBox (dev-bricks) | VS Code / VSCodium | Sublime Text | PyCharm Community | CLI léger (Micro/Nano) | +|---|---|---|---|---|---| +| **INV-LOCAL-01 : absence totale de sortie réseau** | **Garantie native** (aucune télémétrie, fonctionnement entièrement hors ligne) | Partiel / désactivation manuelle de la télémétrie requise | Natif (commercial, code source fermé) | Désactivation de la télémétrie requise | Natif (terminal uniquement) | +| **INV-PERF-02 : démarrage à froid et mémoire** | **Démarrage à froid en moins d’une seconde** (PySide6/Qt natif) | Lourd (surconsommation de RAM d’Electron / Chromium) | Très rapide (C++ propriétaire) | Lent (empreinte mémoire de la JVM) | Instantané | +| **INV-LGPL-03 : isolation sans copyleft** | **Licence permissive / LGPL dynamique uniquement** | Mélange de licences MIT et d’extensions propriétaires du marché | Licence propriétaire | Apache 2.0 | GPL-3.0 (copyleft) | +| **INV-CRASH-04 : protection contre l’échec d’enregistrement** | **Tampons protégés** (état conservé en cas d’erreur d’écriture) | Oui | Oui | Oui | Risque d’interruption du terminal | +| **INV-LSP-05 : moteur LSP asynchrone** | **Client Qt thread-safe** (`pylsp`, `clangd`, etc.) | Prise en charge native du LSP | Via un plugin LSP | Indexation propriétaire intégrée | Aucun / adaptateur LSP externe | +| **INV-TERM-06 : terminal multicoque intégré** | **Terminal `QProcess`** (cmd/PowerShell/bash) | xterm.js intégré | Aucun (terminal externe) | Terminal intégré | Environnement shell natif | +| **INV-PLUG-07 : plugins JSON déclaratifs** | **Schémas JSON immédiats** (aucune compilation) | Extension empaquetée en TypeScript | Scripts / paquets Python | Plugins Java / Kotlin | Règles syntaxiques dans un fichier de configuration | +| **INV-PORT-08 : espaces de travail multi-racines** | **`.codebox-workspace`** (chemins relatifs portables) | `.code-workspace` | `.sublime-project` | Répertoire de projet `.idea` | Arguments de répertoire | +| **INV-GIT-09 : Git porcelain et diff intégrés** | **État porcelain + diff unifié** | Intégration Git complète | Badges Git simples | Intégration Git complète | Commandes Git en CLI | +| **INV-SLA-10 : délai de sécurité de 48 h et § 521 BGB** | **SLA formel + mention § 521 BGB** | Triage communautaire | Assistance fournisseur | Suivi JetBrains | Au mieux des possibilités | + +--- + + +## Fonctionnalités + +- **Surveillance des expressions et pile d’appels du débogueur** : suivi interactif des variables et expressions (`Ctrl+Shift+W`), inspection des cadres de pile avec accès direct à la ligne source, barre d’évaluation instantanée des expressions et synchronisation en direct des sessions PDB (`Ctrl+Shift+D`). +- **Gestionnaire d’extraits et expansion par déclencheur de tabulation** : navigation native entre points de tabulation (`$1`, `${1:default}`, `$0`) avec `Tab` / `Shift+Tab`, catalogue intégré d’extraits pour dix langages de programmation et de balisage, stockage JSON personnalisé persistant et boîte de dialogue interactive `SnippetsDialog` (`Ctrl+Shift+J`). +- **Ouverture rapide et palette de commandes** : recherche floue instantanée de fichiers (`Ctrl+P`) et palette de commandes interactive (`Ctrl+Shift+P`) pour naviguer au clavier. +- **Indexation Git et dialogue de commit** : indexation Git intégrée (`git add`, `git restore --staged`), abandon des modifications, inspection des différences et dialogue de commit (`Ctrl+Alt+C`) depuis la barre latérale du projet et le menu d’affichage. +- **Visionneuse de différences Git intégrée** : affichage côte à côte ou unifié des différences directement dans l’IDE (`Ctrl+Alt+D`). +- **Multi-curseurs et sélection en colonne** : modification simultanée de plusieurs emplacements, sélection en colonne (`Alt+Shift+Drag`), sélection des occurrences (`Ctrl+Shift+L` / `Ctrl+Alt+L`), ajout automatique des paires et annulation/restauration atomique des modifications multi-curseurs. +- **Repli de code et éditeur partagé** : repli interactif du code avec indicateurs dans la gouttière et volets partagés côte à côte ou empilés, avec tampons synchronisés. +- **Coloration syntaxique avancée** : coloration préconfigurée pour Python, JavaScript, TypeScript, C++, Rust, Go et Java, avec correspondance des limites de mots qui respecte la ponctuation. +- **Architecture déclarative de plugins** : création et extension rapides de définitions de langages à l’aide de schémas JSON simples (`plugins/`, `~/.codebox/plugins/`). +- **Boîtes de dialogue de gestion interactives** : interfaces graphiques complètes pour gérer les plugins de langage et consulter les raccourcis clavier (`F1`). +- **Terminal intégré** : shell natif embarqué avec historique des commandes, diffusion de la sortie et synchronisation automatique du répertoire. +- **Arborescence des fichiers du projet** : vue en arborescence avec filtrage de la recherche, actions contextuelles et badges d’état Git porcelain. +- **Espace de travail à plusieurs onglets** : réorganisation des onglets par glisser-déposer, protection contre les échecs d’enregistrement et infobulles avec chemins absolus. +- **Aperçu et navigation par minimap** : aperçu synchronisé par minimap, fermeture automatique des paires de délimiteurs et accès à une ligne (`Ctrl+G`). +- **Interface utilisateur multilingue (6 langues)** : allemand, anglais, espagnol, chinois, japonais et russe, avec changement à chaud via *View -> Language* ou la boîte de dialogue des paramètres, et chaîne de repli à quatre niveaux (`target -> en -> de -> key`). +- **Double thème** : bascule fluide entre palettes claire et sombre, gérée par `features/theme_manager.py`. +- **Diagnostics et complétion LSP** : requêtes asynchrones en arrière-plan pour obtenir des diagnostics et des suggestions de code en temps réel. +- **Linters automatisés** : exécution à l’enregistrement de Ruff, flake8 et ESLint, avec résultats intégrés au panneau unifié des problèmes. + +--- + + +## Installation et démarrage rapide + +```bash +# Clone the repository +git clone https://github.com/dev-bricks/CodeBox.git +cd CodeBox + +# Install runtime dependencies +pip install -r requirements.txt + +# Launch CodeBox +python main.py +``` + +Sous Windows, vous pouvez également lancer CodeBox en double-cliquant sur `start.bat`. + +### Configuration requise + +- **Python** : 3.10, 3.11, 3.12 ou 3.13 +- **Framework graphique** : PySide6 >= 6.5.0 +- **Systèmes d’exploitation** : Windows 10/11, Linux POSIX (Ubuntu, Debian, Fedora), macOS + +--- + + +## Configuration du Language Server Protocol (LSP) + +CodeBox se connecte directement aux Language Servers standard installés sur votre système : + +| Langage | Language Server recommandé | Commande d’installation | +| --- | --- | --- | +| **Python** | `python-lsp-server` (pylsp) | `pip install "python-lsp-server[all]"` | +| **TypeScript / JS** | `typescript-language-server` | `npm install -g typescript-language-server typescript` | +| **Rust** | `rust-analyzer` | `rustup component add rust-analyzer` | +| **Go** | `gopls` | `go install golang.org/x/tools/gopls@latest` | +| **C / C++** | `clangd` | Installer le paquet LLVM / Clang | + +CodeBox privilégie les serveurs présents dans le `PATH` du système et bascule automatiquement vers `python -m pylsp` dans les environnements virtuels. + +--- + + +## Système déclaratif de plugins + +Définissez facilement des langages personnalisés en plaçant un fichier JSON dans `plugins/` ou `~/.codebox/plugins/` : + +```json +{ + "name": "CustomLang", + "version": "1.0.0", + "extensions": [".custom", ".cst"], + "keywords": ["function", "end", "if", "then", "else", "return"], + "comment_style": ["#"], + "auto_close_pairs": { + "(": ")", + "[": "]", + "{": "}" + } +} +``` + +Rechargez les plugins à chaud depuis le gestionnaire de plugins (`Ctrl+Shift+P`). + +--- + + +## Compilation locale sous Windows + +Compilez un exécutable Windows autonome sans dépendances : + +```bat +build_exe.bat +``` + +Le script de compilation utilise PyInstaller avec `CodeBox.spec` pour inclure les icônes de l’application, les thèmes par défaut et les plugins déclaratifs dans `%LOCALAPPDATA%\CodeBox\build\dist\CodeBox.exe` (vous pouvez remplacer cet emplacement avec la variable d’environnement `CODEBOX_BUILD_ROOT`). + +--- + + +## Structure du projet + +```text +CodeBox/ +├── main.py # Application entry point & CLI parameter parser +├── version.py # Central version constants & window title formatter +├── translator.py # TranslationSystem v2.0 with 4-stage fallback chain (P-006) +├── manage_translations.py # Translation parity validator CLI (--check) for CI/CD +├── pyproject.toml # PEP 621 packaging metadata & pytest configuration +├── requirements.txt # Production runtime dependencies (PySide6) +├── locales/ # Localization catalogs (translations.json, 6 languages) +├── core/ # Core editor tabs, highlighter, minimap, output panel +├── features/ # Terminal, project tree, LSP manager, linter, themes, plugins +├── languages/ # Language definitions, providers, and declarative parser +├── ui/ # MainWindow layout, settings, shortcuts, and plugin dialogs +├── plugins/ # Bundled declarative language plugins (JSON) +├── themes/ # QSS stylesheets (dark.qss, light.qss) +├── assets/ # High-resolution vector banners and desktop icons +├── tests/ # Comprehensive automated test suite (360 tests) +└── README/screenshots/ # Visual showcase assets +``` + +--- + + +## Écosystème associé + +CodeBox s’intègre à l’écosystème d’outils pour développeurs **dev-bricks** et **ellmos-ai**, sous l’égide de **open-bricks** : + +| Dépôt | Domaine | Écosystème | +|---|---|---| +| [dev-bricks/safe-start-for-codex](https://github.com/dev-bricks/safe-start-for-codex) | Outil de démarrage sécurisé pour les automatisations Codex locales | `dev-bricks` | +| [dev-bricks/companion-for-agy](https://github.com/dev-bricks/companion-for-agy) | Couche d’orchestration Node.js pour Antigravity | `dev-bricks` | +| automation-master (non public) | Orchestration des tâches et supervision de l’automatisation | `dev-bricks` | +| [dev-bricks/automizer-for-claude-desktop](https://github.com/dev-bricks/automizer-for-claude-desktop) | Pont d’automatisation pour Claude Desktop | `dev-bricks` | +| [ellmos-ai/ellmos-codecommander-mcp](https://github.com/ellmos-ai/ellmos-codecommander-mcp) | Serveur MCP d’analyse AST, de refactorisation et de diagnostic du code | `ellmos-ai` | +| [ellmos-ai/ellmos-filecommander-mcp](https://github.com/ellmos-ai/ellmos-filecommander-mcp) | Serveur MCP de manipulation sécurisée du système de fichiers et de supervision des processus | `ellmos-ai` | +| [doc-bricks/CleanMarkdown](https://github.com/doc-bricks/CleanMarkdown) | Éditeur Markdown de bureau moderne et sans distraction | `doc-bricks` | +| [file-bricks/ExplorerPro](https://github.com/file-bricks/ExplorerPro) | Gestionnaire de fichiers local à plusieurs onglets | `file-bricks` | +| [open-bricks/.github](https://github.com/open-bricks/.github) | Organisation faîtière open source et normes communes | `open-bricks` | + +--- + + +## Recherche et désambiguïsation + +Pour rechercher CodeBox, utilisez des mots-clés précis afin de le distinguer des anciens dépôts sans lien : + +- `dev-bricks CodeBox` +- `CodeBox PySide6 desktop IDE` +- `local-first code editor Python Windows` +- `PySide6 code editor with LSP diagnostics` +- `lightweight offline code editor Python` +- `CodeBox declarative language plugin system` + +--- + + +## Licences tierces et SBOM de niveau 1 + +CodeBox est distribué sous licence MIT permissive. Les dépendances tierces complètes, les textes de licence et les invariants de conformité sont audités et documentés : + +- **SBOM de niveau 1 :** `THIRD_PARTY_LICENSES.md` (auditée le 2026-09-23) +- **Inventaire des textes des composants :** `THIRD_PARTY_LICENSES.txt` +- **Attribution légale et avis de droit d’auteur :** `NOTICE` +- **Garantie d’absence de copyleft :** PySide6 est lié dynamiquement via les roues officielles de PyPI, conformément à la section 4 de LGPL-3.0. Tous les plugins de langage fournis et les fonctionnalités du cœur sont publiés sous des licences permissives. + +--- + + +## Sécurité et confidentialité + +CodeBox respecte des exigences strictes de sécurité et de confidentialité. Consultez [SECURITY.md](SECURITY.md) pour en savoir plus : + +- **Fonctionnement entièrement hors ligne (`INV-LOCAL-01`)** : aucun suivi, aucune télémétrie ni communication cloud non sollicitée. +- **Fonctionnement sans privilèges (`INV-NOELEV-02`)** : s’exécute uniquement avec les permissions d’un utilisateur standard (RunAsInvoker). +- **Délai de réponse de 48 heures (`INV-SLA-10`)** : tous les signalements de vulnérabilité font l’objet d’un triage initial sous 48 heures. +- **Signalement confidentiel** : signalez les vulnérabilités en privé via [GitHub Security Advisories](https://github.com/dev-bricks/CodeBox/security/advisories/new) ou en écrivant à `security@ellmos.ai` et `lukas@open-bricks.org`. + +--- + + +## Licence et responsabilité + +Ce projet est distribué sous [licence MIT](LICENSE). L’avis d’attribution officiel figure dans [`NOTICE`](NOTICE). + +### Limitation légale de responsabilité (§ 521 BGB) + +Ce logiciel est fourni à titre de contribution bénévole à un projet open source, conformément aux articles 516 et suivants du Code civil allemand (BGB). En vertu de l’article 521 BGB, la responsabilité est limitée aux actes intentionnels et à la faute lourde. Aucune garantie n’est accordée quant à la disponibilité du logiciel ni à son adéquation à un usage particulier. + +> Cette traduction a été réalisée avec l’aide d’une IA ; le README anglais fait autorité. diff --git a/README.ja.md b/README.ja.md index b946b4a..bb42919 100644 --- a/README.ja.md +++ b/README.ja.md @@ -18,7 +18,7 @@ [![Last Checked](https://img.shields.io/badge/last%20checked-2026--10--04-informational.svg)](llms.txt) [![llms.txt](https://img.shields.io/badge/llms.txt-available-green.svg)](llms.txt) -[English](README.md) | [Deutsch](README_de.md) | [Español](README.es.md) | [简体中文](README.zh.md) | 日本語 | [Русский](README.ru.md) +[English](README.md) | [Deutsch](README_de.md) | [Español](README.es.md) | [简体中文](README.zh.md) | 日本語 | [Русский](README.ru.md) | [Français](README.fr.md) > 本書は機械支援による翻訳です。英語版 [README.md](README.md) が正本です。 diff --git a/README.md b/README.md index 6a087ec..7e7aefb 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@ [![Last Checked](https://img.shields.io/badge/last%20checked-2026--10--04-informational.svg)](llms.txt) [![llms.txt](https://img.shields.io/badge/llms.txt-available-green.svg)](llms.txt) -English | [Deutsch](README_de.md) | [Español](README.es.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Русский](README.ru.md) +English | [Deutsch](README_de.md) | [Español](README.es.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Русский](README.ru.md) | [Français](README.fr.md) CodeBox is a local-first desktop IDE for Windows, Linux, and macOS developers who want a lightweight PySide6 code editor with multi-tab workspace, project tree, integrated terminal, Git status porcelain indicators, syntax highlighting, Language Server Protocol (LSP) diagnostics, and an extensible JSON/Python language plugin architecture. diff --git a/README.ru.md b/README.ru.md index 976e17a..9057a74 100644 --- a/README.ru.md +++ b/README.ru.md @@ -18,7 +18,7 @@ [![Last Checked](https://img.shields.io/badge/last%20checked-2026--10--04-informational.svg)](llms.txt) [![llms.txt](https://img.shields.io/badge/llms.txt-available-green.svg)](llms.txt) -[English](README.md) | [Deutsch](README_de.md) | [Español](README.es.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | Русский +[English](README.md) | [Deutsch](README_de.md) | [Español](README.es.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | Русский | [Français](README.fr.md) > Этот перевод выполнен с помощью машинного перевода; приоритет имеет английский README.md. diff --git a/README.zh.md b/README.zh.md index b74f483..a462320 100644 --- a/README.zh.md +++ b/README.zh.md @@ -18,7 +18,7 @@ [![Last Checked](https://img.shields.io/badge/last%20checked-2026--10--04-informational.svg)](llms.txt) [![llms.txt](https://img.shields.io/badge/llms.txt-available-green.svg)](llms.txt) -[English](README.md) | [Deutsch](README_de.md) | [Español](README.es.md) | 简体中文 | [日本語](README.ja.md) | [Русский](README.ru.md) +[English](README.md) | [Deutsch](README_de.md) | [Español](README.es.md) | 简体中文 | [日本語](README.ja.md) | [Русский](README.ru.md) | [Français](README.fr.md) > 本文为机器辅助翻译；以英文 README.md 为准。 diff --git a/README_de.md b/README_de.md index 40730b8..0a8a133 100644 --- a/README_de.md +++ b/README_de.md @@ -18,7 +18,7 @@ [![Letzte Prüfung](https://img.shields.io/badge/letzte%20pr%C3%BCfung-2026--10--04-informational.svg)](llms.txt) [![llms.txt](https://img.shields.io/badge/llms.txt-verf%C3%BCgbar-green.svg)](llms.txt) -[English](README.md) | Deutsch | [Español](README.es.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Русский](README.ru.md) +[English](README.md) | Deutsch | [Español](README.es.md) | [简体中文](README.zh.md) | [日本語](README.ja.md) | [Русский](README.ru.md) | [Français](README.fr.md) CodeBox ist eine lokale Desktop-IDE für Windows-, Linux- und macOS-Entwickler, die einen leichtgewichtigen PySide6-Codeeditor mit Multi-Tab-Arbeitsbereich, Projektbaum, integriertem Terminal, Git-Porcelain-Statusanzeigen, Syntax-Highlighting, Language-Server-Protocol-Diagnosen (LSP) und einer erweiterbaren deklarativen JSON/Python-Plugin-Architektur suchen. diff --git a/llms.txt b/llms.txt index fbc7c73..169a81b 100644 --- a/llms.txt +++ b/llms.txt @@ -14,6 +14,7 @@ Part of the dev-bricks family. Python, MIT. - [README.zh.md](https://github.com/dev-bricks/CodeBox/blob/main/README.zh.md): Simplified Chinese entry point (machine-assisted translation; English README is authoritative). - [README.ja.md](https://github.com/dev-bricks/CodeBox/blob/main/README.ja.md): Japanese entry point (machine-assisted translation; English README is authoritative). - [README.ru.md](https://github.com/dev-bricks/CodeBox/blob/main/README.ru.md): Russian entry point (machine-assisted translation; English README is authoritative). +- [README.fr.md](https://github.com/dev-bricks/CodeBox/blob/main/README.fr.md): French entry point (AI-assisted translation; the English README is authoritative). - [NOTICE](https://github.com/dev-bricks/CodeBox/blob/main/NOTICE): Copyright attribution and open-bricks umbrella metadata. - [THIRD_PARTY_LICENSES.md](https://github.com/dev-bricks/CodeBox/blob/main/THIRD_PARTY_LICENSES.md): Level 1 Software Bill of Materials (SBOM) and governance invariants (`INV-LOCAL-01` to `INV-SLA-10`). - [SECURITY.md](https://github.com/dev-bricks/CodeBox/blob/main/SECURITY.md): Bilingual security policy, supported versions, zero-egress invariants, and reporting protocols. @@ -88,5 +89,5 @@ CodeBox local desktop IDE ## External Discovery Notes - The primary disambiguators are `dev-bricks`, `PySide6`, `local-first`, `Windows desktop IDE`, `declarative language plugins`, and `Language Server Protocol`. -- All documentation is fully bilingual (EN/DE) with zero-egress privacy and non-elevation security guarantees. +- README entry points are available in English, German, Spanish, Simplified Chinese, Japanese, Russian, and French; the English README is authoritative. The UI supports six languages only: German, English, Spanish, Chinese, Japanese, and Russian. Runtime remains zero-egress and does not require elevated privileges. - Statutory liability is limited to intent and gross negligence pursuant to § 521 BGB (Gefälligkeitsrecht). From f312f2c7e1e5af3ecf5c3691e1d3e443c0d649fe Mon Sep 17 00:00:00 2001 From: Lukas Geiger Date: Mon, 2 Nov 2026 20:55:13 +0100 Subject: [PATCH 2/3] docs: complete French README license references and source parity --- CHANGELOG.md | 2 ++ README.fr.md | 8 ++++---- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ebf7a34..60c8754 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,6 +12,8 @@ Alle wesentlichen Änderungen an CodeBox werden hier dokumentiert. ## [Unreleased] +- Französische README mit reziproker Sprachwahl und Dokumentationsindex ergänzt. Lizenzverweise und Gewährleistungsformulierung nach Gegenprüfung an die englische Vorlage angeglichen; die Laufzeitsprachen bleiben unverändert (2026-11-02). + ### Repository-Hygiene & interne Dateien [2026-09-28] - **Interne Dateien geschuetzt (`.gitignore`):** `BEFUNDE.md`, `MARKETING-LOG.txt`, `TASKPLAN_STATUS_*.md` und `_after-care/` in `.gitignore` aufgenommen. - **Git-Tracking bereinigt:** `BEFUNDE.md` aus dem Git-Tracking entfernt (`git rm --cached`), bleibt lokal erhalten. diff --git a/README.fr.md b/README.fr.md index 53648c4..f67794e 100644 --- a/README.fr.md +++ b/README.fr.md @@ -394,9 +394,9 @@ Pour rechercher CodeBox, utilisez des mots-clés précis afin de le distinguer d CodeBox est distribué sous licence MIT permissive. Les dépendances tierces complètes, les textes de licence et les invariants de conformité sont audités et documentés : -- **SBOM de niveau 1 :** `THIRD_PARTY_LICENSES.md` (auditée le 2026-09-23) -- **Inventaire des textes des composants :** `THIRD_PARTY_LICENSES.txt` -- **Attribution légale et avis de droit d’auteur :** `NOTICE` +- **SBOM de niveau 1 :** [`THIRD_PARTY_LICENSES.md`](THIRD_PARTY_LICENSES.md) (auditée le 2026-09-23) +- **Inventaire des textes des composants :** [`THIRD_PARTY_LICENSES.txt`](THIRD_PARTY_LICENSES.txt) +- **Attribution légale et avis de droit d’auteur :** [`NOTICE`](NOTICE) - **Garantie d’absence de copyleft :** PySide6 est lié dynamiquement via les roues officielles de PyPI, conformément à la section 4 de LGPL-3.0. Tous les plugins de langage fournis et les fonctionnalités du cœur sont publiés sous des licences permissives. --- @@ -420,6 +420,6 @@ Ce projet est distribué sous [licence MIT](LICENSE). L’avis d’attribution o ### Limitation légale de responsabilité (§ 521 BGB) -Ce logiciel est fourni à titre de contribution bénévole à un projet open source, conformément aux articles 516 et suivants du Code civil allemand (BGB). En vertu de l’article 521 BGB, la responsabilité est limitée aux actes intentionnels et à la faute lourde. Aucune garantie n’est accordée quant à la disponibilité du logiciel ni à son adéquation à un usage particulier. +Ce logiciel est fourni à titre de contribution bénévole à un projet open source, conformément aux articles 516 et suivants du Code civil allemand (BGB). En vertu de l’article 521 BGB, la responsabilité est limitée aux actes intentionnels et à la faute lourde. Aucune garantie n’est fournie, notamment concernant la disponibilité du logiciel ou son adéquation à un usage particulier. > Cette traduction a été réalisée avec l’aide d’une IA ; le README anglais fait autorité. From e1c2190d2286df6583db6370b6803fba64c51eaa Mon Sep 17 00:00:00 2001 From: Lukas Geiger Date: Mon, 2 Nov 2026 23:09:59 +0100 Subject: [PATCH 3/3] docs: clarify French Git staging and split editor terms --- README.fr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.fr.md b/README.fr.md index f67794e..b14ddb4 100644 --- a/README.fr.md +++ b/README.fr.md @@ -234,10 +234,10 @@ Le tableau suivant compare CodeBox à quatre environnements de développement de - **Surveillance des expressions et pile d’appels du débogueur** : suivi interactif des variables et expressions (`Ctrl+Shift+W`), inspection des cadres de pile avec accès direct à la ligne source, barre d’évaluation instantanée des expressions et synchronisation en direct des sessions PDB (`Ctrl+Shift+D`). - **Gestionnaire d’extraits et expansion par déclencheur de tabulation** : navigation native entre points de tabulation (`$1`, `${1:default}`, `$0`) avec `Tab` / `Shift+Tab`, catalogue intégré d’extraits pour dix langages de programmation et de balisage, stockage JSON personnalisé persistant et boîte de dialogue interactive `SnippetsDialog` (`Ctrl+Shift+J`). - **Ouverture rapide et palette de commandes** : recherche floue instantanée de fichiers (`Ctrl+P`) et palette de commandes interactive (`Ctrl+Shift+P`) pour naviguer au clavier. -- **Indexation Git et dialogue de commit** : indexation Git intégrée (`git add`, `git restore --staged`), abandon des modifications, inspection des différences et dialogue de commit (`Ctrl+Alt+C`) depuis la barre latérale du projet et le menu d’affichage. +- **Mise en index Git et boîte de dialogue de commit** : mise en index des modifications (`git add`, `git restore --staged`), abandon des modifications, inspection des différences et dialogue de commit (`Ctrl+Alt+C`) depuis la barre latérale du projet et le menu d’affichage. - **Visionneuse de différences Git intégrée** : affichage côte à côte ou unifié des différences directement dans l’IDE (`Ctrl+Alt+D`). - **Multi-curseurs et sélection en colonne** : modification simultanée de plusieurs emplacements, sélection en colonne (`Alt+Shift+Drag`), sélection des occurrences (`Ctrl+Shift+L` / `Ctrl+Alt+L`), ajout automatique des paires et annulation/restauration atomique des modifications multi-curseurs. -- **Repli de code et éditeur partagé** : repli interactif du code avec indicateurs dans la gouttière et volets partagés côte à côte ou empilés, avec tampons synchronisés. +- **Repli de code et éditeur scindé** : repli interactif du code avec indicateurs dans la gouttière et volets côte à côte ou empilés, avec tampons synchronisés. - **Coloration syntaxique avancée** : coloration préconfigurée pour Python, JavaScript, TypeScript, C++, Rust, Go et Java, avec correspondance des limites de mots qui respecte la ponctuation. - **Architecture déclarative de plugins** : création et extension rapides de définitions de langages à l’aide de schémas JSON simples (`plugins/`, `~/.codebox/plugins/`). - **Boîtes de dialogue de gestion interactives** : interfaces graphiques complètes pour gérer les plugins de langage et consulter les raccourcis clavier (`F1`).