README_ru-RU.md

HagiCode

HagiCode — это продукт, который объединяет AI-инструмент для программирования, игровую систему обратной связи и полноценное рабочее пространство разработки в одной платформе.

Используйте его, чтобы разбираться в репозиториях, писать предложения, декомпозировать задачи, изменять код, упорядочивать коммиты, управлять несколькими репозиториями и собирать переиспользуемую базу знаний, не выходя из одного рабочего пространства.

Website · Product Overview · Desktop · Container · Microsoft Store · Blog

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Português (Brasil) · Русский

---

Microsoft Store And Add-ons

Превью	Продукт	Что это	С чего начать
	HagiCode for Windows	Current public entry point for the desktop app. The Steam main application entry has been retired.	Open Microsoft Store · Desktop downloads · Steam status FAQ
	Hagicode Plus	Bundle and upgrade guidance remains available through the docs site.	Read Hagicode Plus docs
	Turbo Engine DLC	DLC guidance for higher concurrency and customization remains available through the docs site.	Read Turbo Engine DLC docs

Что такое HagiCode

HagiCode создавался не как ещё одно чат-окно для кода. Он встраивает ИИ во весь процесс разработки ПО: понимание репозиториев, планирование изменений, реализация кода, организация коммитов, накопление знаний и поддержание всего потока от идеи до архива в удобном для ревью виде.

Ключевые возможности

1. AI-кодинг на основе предложений с OpenSpec

Для нетривиальной работы HagiCode начинает с предложения, а не сразу переходит к правке файлов. OpenSpec превращает запросы в область работ, задачи, анализ влияния, шаги проверки и историю выполнения, которую удобно просматривать и проверять.

2. Популярные Agent CLI и OmniRoute

HagiCode поддерживает Codex, Claude Code, GitHub Copilot, OpenCode, Hermes, QoderCLI, Kiro, Kimi, Gemini, Pi, Reasonix, DeepAgents и Codebuddy. OmniRoute отделяет выбор CLI от уровня моделей и подписок, чтобы команды могли маршрутизировать модели и endpoints без жёсткой привязки ко всему одному стеку по умолчанию.

3. Полноценное рабочее пространство разработки, а не только чат

Рабочее пространство объединяет возможности, которые обычно оказываются разбросаны по разным инструментам:

• MonoSpecs для инвентаризации, области работ и координации между несколькими репозиториями
• Skills для устанавливаемых расширений рабочих процессов и инструментов с учётом доверия
• Vault для накопления переиспользуемых знаний между проектами
• AI Compose Commit и интеграция с code-server, чтобы завершать работу в том же потоке

4. Игровая обратная связь, которая остаётся полезной в работе

HagiCode рассматривает достижения, ежедневные отчёты, множители эффективности, пропускную способность токенов и тематическую обратную связь интерфейса как часть продукта, а не как декоративные остатки. В результате получается рабочее пространство, где долгие AI-процессы остаются видимыми, а не сплющиваются в одну бесконечно прокручиваемую переписку.

Официальные точки входа

• Website для полной главной страницы продукта
• Product Overview для официального публичного введения в продукт
• Desktop для локальной установки и управления сервисами
• Container для сценария self-hosted развертывания
• Microsoft Store for the current Windows desktop entry point
• Steam status FAQ for why the Steam main application is no longer the primary channel
• Blog для обновлений продукта и длинных публикаций

Разработка этого репозитория

Этот репозиторий содержит публичный сайт HagiCode. В каталоге repos/site выполните:

npm install
npm run dev
npm run build
npm run preview

Сервер разработки по умолчанию запускается на http://localhost:31264. Для руководства по вкладу начните с AGENTS.md и CLAUDE.md.

Продакшн-деплой

• Основной workflow: .github/workflows/site-deploy-gh-pages.yml
• Источник истины для production: ветка gh-pages, публикуемая только через GitHub Actions
• Контракт публикуемого payload: esa.jsonc в корне ветки и проверенный статический снимок Astro в dist/
• Путь в R2 после gh-pages: после успешного завершения job deploy job upload-r2 скачивает тот же проверенный artifact site-gh-pages-payload и синхронизирует только содержимое .deploy/gh-pages/dist/ в корень bucket R2 или в корень опционального prefix, не добавляя лишний сегмент dist/
• Путь для ручного запуска: workflow_dispatch по умолчанию использует latest-gh-pages, поэтому сопровождающие могут повторно опубликовать данные прямо из последнего snapshot ветки gh-pages без новой сборки; current-ref-build выбирайте только тогда, когда действительно нужен ручной rebuild и повторная публикация из текущего ref
• Обязательные R2 secrets: R2_ENDPOINT, R2_BUCKET, R2_ACCESS_KEY_ID и R2_SECRET_ACCESS_KEY; R2_PREFIX необязателен и удаляет ведущие и замыкающие / перед вычислением целевого корня
• Диагностика сбоев: если gh-pages завершился успешно, а загрузка в R2 нет, workflow упадёт в upload-r2; смотрите GitHub step summary, чтобы увидеть вычисленный bucket, корень prefix и понять, случилась ли ошибка до передачи или во время синхронизации
• Необходимые права GitHub: deploy job требует contents: write; build job остаётся только для чтения
• Необходимая настройка хостинга: production-хост должен читать gh-pages/esa.jsonc и обслуживать gh-pages/dist/ как каталог статических файлов
• Проверки первого деплоя: убедитесь, что workflow публикует esa.jsonc и dist/, что целевой хостинг по-прежнему смотрит на gh-pages, что summary показывает ожидаемый bucket R2 или корень prefix, и затем откройте https://hagicode.com
• Путь отката: откатить изменение в исходниках или повторно запустить деплой из более старого коммита, чтобы CI снова опубликовал предыдущий снимок

Резервный Desktop Index

Индекс истории desktop по адресу https://index.hagicode.com/desktop/history/ здесь выступает только как внешняя зависимость по ссылке. Сайт указывает на него как на резервную runtime-цель для desktop-инструкций, но сам этот репозиторий не публикует и не поддерживает этот индекс напрямую.

Лицензия

Этот репозиторий распространяется по LICENSE.