| 1 | # CascadeIDE (CIDE) |
| 2 | |
| 3 | Десктопная IDE на **Avalonia** и **.NET 10**: решения **`.sln` / `.slnx`**, редактор, **встроенный MCP-сервер** (`--mcp-stdio` — сборка, тесты, Git, UI и т.д.), канал **Intercom** и модели (в т.ч. локальный **[Ollama](https://ollama.com)**). |
| 4 | |
| 5 | **Документация (сайт):** **[ai-guiders.github.io/cascade-ide](https://ai-guiders.github.io/cascade-ide/)** — MkDocs, русский по умолчанию, переключатель **RU / EN** в шапке. Для международной аудитории: **[Concept overview (EN)](https://ai-guiders.github.io/cascade-ide/en/concept-overview/)**. |
| 6 | |
| 7 | **Лицензия кода:** [MIT](LICENSE) |
| 8 | |
| 9 | Использование исходников и сборок **внутри условий MIT** (сохранение уведомлений, лицензии и т.д.) — как обычно для open-source. Если тебе нужно **коммерческое** применение (продукт на основе IDE, встраивание в закрытый контур, поддержка, кастомизация под бизнес) — **свяжись с нами**: контакты и рамки в **[docs/COMMERCIAL-NOTICE.md](docs/COMMERCIAL-NOTICE.md)**. Планируемая модель: **MIT + commercial** (открытый код + отдельная коммерческая линейка/услуги); подробнее о границах — **[docs/licensing-vision.md](docs/licensing-vision.md)**. |
| 10 | |
| 11 | --- |
| 12 | |
| 13 | ## Быстрый старт |
| 14 | |
| 15 | Нужны [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) и ОС с поддержкой Avalonia (Windows / Linux / macOS). Для локального чата — запущенный Ollama (`http://localhost:11434`). |
| 16 | |
| 17 | ```bash |
| 18 | git clone https://github.com/AI-Guiders/cascade-ide.git |
| 19 | cd cascade-ide |
| 20 | dotnet restore |
| 21 | dotnet build CascadeIDE.sln -c Release |
| 22 | dotnet run --project CascadeIDE.csproj |
| 23 | ``` |
| 24 | |
| 25 | При старте приложение проверяет Ollama и подскажет, если API недоступен. |
| 26 | |
| 27 | Итерация без тяжёлой генерации в сборке: |
| 28 | |
| 29 | ```bash |
| 30 | dotnet build CascadeIDE.sln -c Debug -p:FastBuild=true |
| 31 | dotnet run --project CascadeIDE.csproj -p:FastBuild=true |
| 32 | ``` |
| 33 | |
| 34 | Локальная сборка сайта: `pip install -r requirements-docs.txt`, `python tools/gen_adr_pages.py`, `mkdocs serve`. |
| 35 | |
| 36 | --- |
| 37 | |
| 38 | ## Возможности |
| 39 | |
| 40 | | Область | Суть | |
| 41 | |--------|------| |
| 42 | | Редактор | AvalonEdit + TextMate (в т.ч. C#), правки из MCP; пакеты **[AIGuiders.AvaloniaEdit](https://github.com/KarataevDmitry/AvaloniaEdit)** | |
| 43 | | Решение | Дерево `.sln` / `.slnx`, открытие файлов | |
| 44 | | Чат | Ollama, OpenAI, Anthropic, DeepSeek, стриминг | |
| 45 | | MCP | [MCP protocol](https://ai-guiders.github.io/cascade-ide/MCP-PROTOCOL/) — контракт и инструменты ([исходник](docs/MCP-PROTOCOL.md)) | |
| 46 | | Отладка | **dotnet-debug-mcp** — [паритет человек/агент](https://ai-guiders.github.io/cascade-ide/debug-human-agent-parity-v1/) | |
| 47 | | Git | [Git и submodules](https://ai-guiders.github.io/cascade-ide/git-and-submodules-v1/) | |
| 48 | | UI | **Flight**: PFD · Forward · MFD — [раскладка](https://ai-guiders.github.io/cascade-ide/ui-ux/cascade-ide-ui-layout-v1/), [ADR 0021](https://ai-guiders.github.io/cascade-ide/adr/0021-pfd-mfd-cockpit-attention-model/) | |
| 49 | | Настройки | `%LocalAppData%\CascadeIDE\settings.toml`; данные рядом в WitDatabase | |
| 50 | |
| 51 | <a id="до-публичного-релиза"></a> |
| 52 | |
| 53 | ## До публичного релиза |
| 54 | |
| 55 | Пока нет массовой установки **не** наращиваем в `SettingsService` автоматические миграции при переименовании или переносе ключей в `settings.toml` — пользователь правит файл вручную или переустанавливает. Канон путей и форматов — [docs/adr/0028-user-settings-toml-localappdata-and-secrets.md](docs/adr/0028-user-settings-toml-localappdata-and-secrets.md). После публичного релиза — отдельное решение (версия файла, одноразовый мигратор, changelog). |
| 56 | |
| 57 | --- |
| 58 | |
| 59 | ## Документация |
| 60 | |
| 61 | **Опубликованный сайт:** [https://ai-guiders.github.io/cascade-ide/](https://ai-guiders.github.io/cascade-ide/) · [English `/en/`](https://ai-guiders.github.io/cascade-ide/en/) |
| 62 | |
| 63 | | На сайте | Зачем | |
| 64 | |----------|--------| |
| 65 | | [Навигатор ADR по статусу](https://ai-guiders.github.io/cascade-ide/site/adr-nav/) · [EN](https://ai-guiders.github.io/cascade-ide/en/site/adr-nav/) | Proposed / Accepted / Implemented | |
| 66 | | [Полный индекс ADR](https://ai-guiders.github.io/cascade-ide/adr/) · [EN](https://ai-guiders.github.io/cascade-ide/en/adr/) | Все решения; в репо канон RU — `docs/adr/` | |
| 67 | | [Архитектурная политика](https://ai-guiders.github.io/cascade-ide/architecture-policy/) · [EN](https://ai-guiders.github.io/cascade-ide/en/architecture-policy/) | Слои, таблица тем → ADR | |
| 68 | | [Текущая архитектура](https://ai-guiders.github.io/cascade-ide/architecture/current-architecture-v1/) · [EN](https://ai-guiders.github.io/cascade-ide/en/architecture/current-architecture-v1/) | Срез «как устроено сейчас» | |
| 69 | | [UI layout (Flight)](https://ai-guiders.github.io/cascade-ide/ui-ux/cascade-ide-ui-layout-v1/) · [EN](https://ai-guiders.github.io/cascade-ide/en/ui-ux/cascade-ide-ui-layout-v1/) | PFD / Forward / MFD, имена для MCP | |
| 70 | | [Concept overview](https://ai-guiders.github.io/cascade-ide/en/concept-overview/) | Онбординг на английском | |
| 71 | |
| 72 | **В репозитории (разработка):** |
| 73 | |
| 74 | | Документ | Зачем | |
| 75 | |----------|--------| |
| 76 | | [SETUP.md](SETUP.md) | Окружение: SDK, шаблоны Avalonia, Ollama | |
| 77 | | [Features/README.md](Features/README.md) | Оглавление `Features/` | |
| 78 | | [docs/architecture-migration.md](docs/architecture-migration.md) | Вынос фич из «кома» (не на сайте) | |
| 79 | | [docs/design/north-star-cursor-mcp-cascade-workbench-v1.md](docs/design/north-star-cursor-mcp-cascade-workbench-v1.md) | Продуктовая северная звезда | |
| 80 | | [samples/AcpSmokeDotnet](samples/AcpSmokeDotnet) | ACP smoke ([ADR 0016](docs/adr/0016-agent-client-protocol-external-agent.md)) | |
| 81 | | [docs/COMMERCIAL-NOTICE.md](docs/COMMERCIAL-NOTICE.md) | Коммерческое предложение / контакты | |
| 82 | | [docs/THIRD-PARTY-NOTICES.md](docs/THIRD-PARTY-NOTICES.md) | Сторонний код | |
| 83 | |
| 84 | --- |
| 85 | |
| 86 | ## Стек |
| 87 | |
| 88 | **.NET 10**, **Avalonia 12.x**, **CommunityToolkit.Mvvm**, **Roslyn**, Ollama + Microsoft.Extensions.AI для чата. |
| 89 | |
| 90 | Подробный чеклист установки на машину — **[SETUP.md](SETUP.md)**. |
| 91 | |