Waveloom

简体中文

DeepSeek-нативный терминальный coding-агент, спроектированный вокруг экономики кеша. Архитектура prefix-cache удерживает наибольший общий префикс «горячим» в кеше между ходами; LLM автоматически выбирает pro для глубокого рассуждения и flash для рутинных задач — максимизируя попадания в кеш и минимизируя стоимость токенов. Продвинутый TUI с поддержкой конфигов .claude/skills/ и .claude.json MCP «из коробки» — миграция без трения. Единый Go-бинарник.

Быстрый старт

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/Menfre01/waveloom/main/install.sh | sh

Или через Homebrew:

brew install menfre01/tap/waveloom

Поддерживает macOS / Linux / Windows, AMD64 и ARM64. Устанавливается в ~/.local/bin, sudo не требуется.

Windows

Требуется Git for Windows. Откройте PowerShell и выполните:

powershell -c "irm https://raw.githubusercontent.com/Menfre01/waveloom/main/install.ps1 | iex"

[!TIP] Для лучшего опыта на Windows используйте WSL2. Установите Linux-бинарник внутри WSL2 и получите нативную производительность — без прослойки Git Bash, более плавный рендеринг терминала и более быстрые shell-команды.

Предпочитаете Git Bash? Waveloom требует bash.exe — cmd и PowerShell не поддерживаются. После установки откройте Git Bash и выполните команды ниже. Если waveloom не найден, добавьте %USERPROFILE%\.local\bin в Windows PATH (инсталлятор делает это автоматически).

Настройка

waveloom setup
waveloom

[!IMPORTANT] API-ключ подключается напрямую к DeepSeek / Kimi / OpenAI — ваш код никогда не проходит через сторонний сервер. Каждая запись файла и выполнение команды требует вашего подтверждения.

Сравнение

Выбирайте Waveloom, если: нужен продвинутый терминальный UX с поддержкой нескольких провайдеров (DeepSeek / Kimi / OpenAI), drop-in .claude/skills/ + .claude/plugins/, без затрат на промахи кеша. Выбирайте Claude Code, если: используете Anthropic, нужен coordinator-режим, глубоко в экосистеме Claude. Выбирайте Reasonix, если: нужен desktop GUI, интеграция с QQ Bot или более широкое сообщество.

Почему TUI

Waveloom — единственный DeepSeek-нативный агент с продвинутой терминальной полировкой. Потоковое рассуждение с подсветкой синтаксиса, богатый diff, диалоги прав, @ fuzzy-выбор файлов, / палитра команд, переключение светлой/тёмной/дальтоник-темы, справка по хоткеям ?, i18n zh-CN / en-US. Большинство DeepSeek-агентов относятся к TUI как к второстепенной задаче — сырой текстовый стриминг без продуманного взаимодействия. Запустите и почувствуйте разницу.

Ключевые особенности

• Оптимизация под prefix cache — фиксированный системный промпт, append-only история сообщений, четырёхуровневая watermark-компакция. Максимальный общий префикс остаётся «горячим» в кеше между ходами.
• Мультимодальное зрение — ссылайтесь на изображения через @shot.png; deepseek-v4-flash-vision-exp описывает скриншоты, распознаёт текст (OCR) и анализирует графики.
• Безопасность прав — трёхуровневые решения (allow / deny / ask) с движком правил по паттернам, поддержанные 5-слойным пайплайном безопасности вывода инструментов (очистка Unicode → сканирование инъекций → граничные маркеры → оценка риска → безопасное усечение). Каждая операция записи требует вашего подтверждения.
• Sandbox уровня ОС — опциональная изоляция выполнения через bubblewrap (Linux) / Seatbelt (macOS): корень только для чтения, запись только в workspace, настраиваемое маскирование credentials (filesystem.denyRead / credentials.files; рекомендованный список в документации по настройкам), удаление переменных окружения, настраиваемая инъекция env (перенаправление кешей build-инструментов вроде GOPATH/GOMODCACHE/npm_config_cache в workspace) и контроль сети (off / on). Авто-активируется с --bypass-permissions; настраивается через "sandbox" в settings.json или --sandbox-network off|on.
• Система hook'ов — хуки PreToolUse / PostToolUse / Notification / Stop с полем permission_mode. Fail-open по умолчанию — падение хука никогда не блокирует выполнение инструмента; код выхода 2 явно блокирует. Настраивается через settings.json.
• Персистентность сессии — закройте терминал, вернитесь через дни с waveloom --continue. Агент помнит весь предыдущий контекст.
• Checkpoint/Rewind — откат к любому предыдущему сообщению с полным восстановлением состояния файлов. Fork-режим сохраняет оригинальную сессию нетронутой — история никогда не теряется.
• Plan-режим — двухэтапный воркфлоу: сначала исследование и проектирование, реализация после одобрения. Shift+Tab для входа/выхода, Guard принудительно защищает от записи.
• Конфигурация sub_model — задайте "sub_model": "deepseek-v4-flash" в settings.json, чтобы назначить лёгкую модель для explore-субагентов. Explore использует flash (~в 2 раза дешевле) для поиска и обнаружения кода; evaluate/verification-субагенты используют pro для полноценного рассуждения. LLM автоматически выбирает между pro/flash по сложности задачи. Экономит ~50% на стоимости токенов субагентов.
• 14 встроенных инструментов — read / write / edit / bash / web_fetch / web_search / ask_user_question / enter_plan_mode / exit_plan_mode / skill / agent / kill_background_task / todo_create / todo_update.
• Многоязычность i18n — полный двуязычный UI zh-CN / en-US. CLI-флаг --locale, команда /locale, автоопределение из LANG.

FAQ

В: Как переключить модель? Введите /model в интерактивном режиме, или waveloom --model deepseek-v4-flash. Выберите proplan, чтобы использовать pro-модель в plan-режиме и flash-модель для обычных задач (/model proplan). Требует настройки model (plan-режим) и sub_model (обычные задачи) в settings.json; иначе — обычная ошибка модели.

В: Работает ли web_search с deepseek-v4-flash? Да — с deepseek-v4-flash Waveloom автоматически переключается на DeepSeek Responses API, и web_search становится встроенным серверным поиском (без зависимости от DuckDuckGo/Brave). Другие модели используют локальные поисковые бэкенды.

В: Как переключить LLM-провайдера? Введите /provider, чтобы открыть интерактивный выбор провайдера (оверлей с ↑↓ выбором / Enter подтверждением / Esc отменой), или /provider kimi для прямого переключения. Профили настраиваются в settings.json в разделе llm.profiles.

В: Безопасен ли мой API-ключ? Хранится локально в ~/.waveloom/. Ключи подключаются напрямую к DeepSeek / Kimi / OpenAI — без стороннего релея.

В: Как переключить язык? Введите /locale, чтобы переключиться между китайским и английским, или waveloom --locale zh-CN. Настройка автоматически сохраняется в settings.json.

В: Как настроить лёгкую модель для explore-субагентов? Добавьте "sub_model": "deepseek-v4-flash" в раздел llm в settings.json. Explore-субагент использует эту модель для поиска и обнаружения кода — ~в 2 раза дешевле основной модели. Для evaluate/verification-субагентов используется основная модель (model, например deepseek-v4-pro) для полного качества рассуждения. Переключение во время работы не требуется.

В: Какие языки поддерживаются? Waveloom работает с любым текстовым проектом. Пост-edit диагностика LSP автоматически проверяет корректность кода для Go, Rust, TypeScript/JavaScript и C/C++. Другие языки используют нативные build-инструменты (go build, npx tsc, cargo build, make и т.д.).

Документация

Разработка

Go 1.25+, make build / make test. См. CONTRIBUTING.md для структуры проекта и гайда по контрибьютингу.

Построен на Bubble Tea (TUI-фреймворк), Glamour (рендеринг Markdown) и Lip Gloss (терминальная стилизация) — часть экосистемы Charm.