Архитектура¶

OpenCode Initializer построен на модульной архитектуре: лёгкий оркестратор (setup.sh, 561 строка), который подключает 39 модулей и запускает 11 режимов.

C4 Уровень 1: Контекст системы¶

C4Context
    title opencode_initializer — Контекст системы

    Person(dev, "Разработчик", "Хочет готовое AI-усиленное окружение для разработки")
    System(oci, "OpenCode Initializer", "Настраивает полную dev-машину: 8 языков, 39 модулей, 21 MCP, 15 плагинов, 23 провайдера, инфраструктура")

    System_Ext(gh, "GitHub", "Исходный код, релизы, CI/CD")
    System_Ext(ghp, "GitHub Packages", "npm пакеты, Docker образы")
    System_Ext(apt, "Реестры пакетов", "apt, dnf, pacman, apk, zypper, brew")
    System_Ext(mcp_registry, "MCP Registry", "MCP-серверы")
    System_Ext(ai_api, "AI Провайдеры", "OpenCode, DeepSeek и 14+ других")

    Rel(dev, oci, "Запускает setup.sh", "curl|bash")
    Rel(oci, gh, "Скачивает", "HTTPS")
    Rel(oci, ghp, "Устанавливает пакеты", "npm, pip, cargo")
    Rel(oci, apt, "Устанавливает системные пакеты", "apt/dnf/pacman")
    Rel(oci, mcp_registry, "Загружает MCP-серверы", "npm, npx")
    Rel(oci, ai_api, "Настраивает провайдеров", "HTTPS/API")

    UpdateLayoutConfig($c4ShapeInRow="3", $c4BoundaryInRow="2")

C4 Уровень 2: Контейнеры¶

C4Container
    title opencode_initializer — Контейнеры

    Container_Boundary(oci, "OpenCode Initializer") {
        Container(setup, "setup.sh", "Bash", "Оркестратор — запускает 11 режимов, подключает 39 модулей, отслеживает прогресс")
        Container(dev_cli, "dev CLI", "Bash", "Управление после установки: install, remove, update, health, config, isolated")
        Container(lib, "src/lib/ (39 модулей)", "Bash", "Основные модули: система, языки, инструменты, MCP, LSP, LLM, провайдеры, инфраструктура, cockpit, изолированный режим")
        Container(modes, "src/modes/ (5 скриптов)", "Bash", "Режимы: ci, health, fix-zshrc, upgrade, interactive")
        Container(tests, "tests/", "Bash + Bats", "Юнит, интеграционные, E2E тесты (350+ утверждений)")
        Container(docs_site, "Сайт документации", "MkDocs Material", "Документация (эта страница)")
    }

    System_Ext(gh_actions, "GitHub Actions", "CI/CD — ShellCheck, shfmt, тесты, деплой доков")
    System_Ext(github_pages, "GitHub Pages", "Хостинг документации")

    Rel(setup, lib, "Подключает модули", "source")
    Rel(setup, modes, "Запускает режим", "bash")
    Rel(dev_cli, lib, "Подключает helpers", "source")
    Rel(gh_actions, tests, "Запускает", "CI триггер")
    Rel(gh_actions, docs_site, "Собирает и деплоит", "mkdocs build + gh-pages")
    Rel(docs_site, github_pages, "Деплоится на", "GitHub Pages")

C4 Уровень 3: Схема модулей¶

C4Container
    title src/lib/ — 39 модулей

    Container_Boundary(modules, "src/lib/") {
        Container(helpers, "helpers.sh", "Bash", "_curl, _retry, _npm_install — общая инфраструктура")
        Container(core, "00-core.sh", "Bash", "Определение ОС/ПМ/архитектуры, зеркала, прогресс")

        Container(sys, "01-system.sh", "Bash", "Системные пакеты (кросс-дистрибутив)")
        Container(docker, "02-docker.sh", "Bash", "Docker Engine")
        Container(chrome, "03-chrome.sh", "Bash", "Google Chrome + chromedriver")
        Container(zsh, "04-zsh.sh", "Bash", "Zsh + Oh My Zsh + P10k + 14 плагинов")

        Container(java, "05-java.sh", "Bash", "Java 25 (Adoptium) + Zig")
        Container(node, "06-node.sh", "Bash", "Node.js 24 (n)")
        Container(python, "07-python.sh", "Bash", "Python 3.14 + uv")
        Container(go, "08-go.sh", "Bash", "Go 1.26")
        Container(rust, "09-rust.sh", "Bash", "Rust 1.97.1 (rustup)")
        Container(dotnet, "10-dotnet.sh", "Bash", ".NET 10")

        Container(opencode, "11-opencode.sh", "Bash", "OpenCode CLI + Bun")
        Container(mcp, "12-mcp-lsp.sh", "Bash", "21 MCP + 15 плагинов + 13 LSP")
        Container(chromadb, "13-chromadb.sh", "Bash", "ChromaDB + systemd")
        Container(shokunin, "14-shokunin.sh", "Bash", "Shokunin + Superpowers + Caveman")
        Container(sec, "15-security.sh", "Bash", "Trivy, Qodana")
        Container(llm, "16-llm.sh", "Bash", "Ollama, vLLM, SGLang, Open WebUI")

        Container(project, "17-project.sh", "Bash", "Структура проекта (AGENTS.md, WAL)")
        Container(json, "18-opencode-json.sh", "Bash", "Генерация opencode.json")
        Container(finalize, "19-finalize.sh", "Bash", "Git config, PATH, верификация (36 проверок)")
        Container(update, "20-autoupdate.sh", "Bash", "topgrade + systemd таймер")
        Container(rag, "21-rag.sh", "Bash", "RAG система (опционально)")

        Container(webui, "22-webui-service.sh", "Bash", "Open WebUI systemd сервис")
        Container(just, "23-just.sh", "Bash", "just — таск-раннер")
        Container(websearch, "24-websearch.sh", "Bash", "SearXNG веб-поиск + sanitizer")
        Container(providers, "26-providers.sh", "Bash", "Реестр 23 LLM-провайдеров")
        Container(dotfiles, "27-dotfiles.sh", "Bash", "chezmoi — менеджер dotfiles")
        Container(devbox, "28-devbox.sh", "Bash", "Devbox — Nix-окружения")
        Container(mise, "29-mise.sh", "Bash", "mise-en-place — менеджер версий инструментов")

        Container(infra, "30-infra.sh", "Bash", "Инфраструктура: PostgreSQL + Qdrant + Redis + Prometheus + Grafana + MemoryLayer")
        Container(cockpit, "31-cockpit.sh", "Bash", "Cockpit TUI — демон управления сервером")
        Container(isolated, "32-isolated.sh", "Bash", "Изолированный контур — автономные LLM без сети")
        Container(observ, "34-observability.sh", "Bash", "Grafana + Prometheus — стек наблюдаемости")
        Container(gui, "35-gui.sh", "Bash", "Веб-интерфейс управления")
        Container(router, "36-model-router.sh", "Bash", "Model Router — подбор модели под задачу")

        Container(vcheck, "version-check.sh", "Bash", "Сравнение версий (8+ инструментов)")
        Container(precheck, "pre-session-check.sh", "Bash", "Предсессионная валидация")
    }

    Rel(core, helpers, "Использует")
    Rel(sys, core, "Зависит")
    Rel(java, core, "Зависит")
    Rel(mcp, helpers, "Использует _curl/_npm_install")
    Rel(finalize, json, "Вызывает")
    Rel(project, core, "Зависит")

C4 Уровень 4: Поток выполнения setup.sh¶

flowchart TD
    A["setup.sh (561 строка)"] --> B["Определить SCRIPT_DIR"]
    B --> C["Подключить helpers.sh"]
    C --> D["Подключить 00-core.sh"]
    D --> E{"Разбор аргументов CLI"}
    E -->|"--help"| F["Показать справку и выйти"]
    E -->|"--version"| G["Показать версию и выйти"]
    E -->|"--health"| H["Подключить modes/health.sh"]
    E -->|"--fix-config"| I["Запустить исправление конфига"]
    E -->|"--dry-run"| J["Режим предпросмотра"]
    E -->|"--interactive"| K["Интерактивный режим"]
    E -->|"--reinit"| L["Режим переустановки"]
    E -->|"--ci"| CI["CI/CD headless режим"]
    E -->|"по умолчанию (full)"| M["Полная установка"]

    M --> N["Последовательно: 01-system.sh .. 35-gui.sh"]
    N --> O["18-opencode-json.sh"]
    O --> P["19-finalize.sh"]
    P --> Q["Верификация: 36 проверок"]
    Q --> R["Готово"]

    H --> S["65+ диагностических проверок"]
    K --> T["Покомпонентный выбор"]

Карта зависимостей модулей¶

graph LR
    subgraph "Инфраструктурный слой"
        helpers["helpers.sh"]
        core["00-core.sh"]
    end

    subgraph "Системный слой"
        sys["01-system.sh"]
        docker["02-docker.sh"]
        chrome["03-chrome.sh"]
        zsh["04-zsh.sh"]
    end

    subgraph "Языковой слой"
        java["05-java.sh"]
        node["06-node.sh"]
        python["07-python.sh"]
        go["08-go.sh"]
        rust["09-rust.sh"]
        dotnet["10-dotnet.sh"]
    end

    subgraph "Инструментальный слой"
        opencode["11-opencode.sh"]
        mcp["12-mcp-lsp.sh"]
        chromadb["13-chromadb.sh"]
        shokunin["14-shokunin.sh"]
        sec["15-security.sh"]
        llm["16-llm.sh"]
        rag["21-rag.sh"]
        websearch["24-websearch.sh"]
        providers["26-providers.sh"]
    end

    subgraph "Слой финализации"
        project["17-project.sh"]
        json["18-opencode-json.sh"]
        finalize["19-finalize.sh"]
        update["20-autoupdate.sh"]
        mise["29-mise.sh"]
        just["23-just.sh"]
        dotfiles["27-dotfiles.sh"]
        devbox["28-devbox.sh"]
    end

    helpers --> core
    core --> sys
    core --> docker
    core --> chrome
    core --> zsh

    sys --> java
    sys --> node
    sys --> python
    sys --> go
    sys --> rust
    sys --> dotnet

    helpers --> opencode
    helpers --> mcp
    helpers --> chromadb
    helpers --> shokunin
    helpers --> sec
    helpers --> llm
    helpers --> rag
    helpers --> websearch


    core --> project
    project --> json
    json --> finalize
    finalize --> update

Ключевые архитектурные решения¶

См. также: - Справочник — CLI и таблица модулей - MCP, LSP и плагины — полный каталог - Руководство — повседневное использование - Продвинутое — кастомизация и оптимизация