English · 简体中文

Unfour

Локальное десктопное рабочее пространство в стиле local-first для бэкенд-разработчиков, которое объединяет отладку API, SSH-терминалы и управление базами данных — и открывает их вашему ИИ-агенту через локальный MCP-сервер.

Создано с помощью Codex и GPT-5.6

Codex использовался для рецензирования архитектуры на Rust и TypeScript, реализации и рефакторинга команд Tauri, добавления тестов, а также для разбора сбоев сборки и проблем жизненного цикла процессов MCP.

GPT-5.6 помог спроектировать сценарии диагностики бэкенда с поддержкой ИИ, проанализировать границы прав SSH и баз данных, уточнить дизайн MCP-инструментов, а также спланировать архитектуру проекта и процесс выпуска релизов.

Codex — это не просто инструмент разработки Unfour: через MCP-сервер Unfour он может использовать возможности API, SSH и баз данных, чтобы воспроизвести проблему API, просмотреть логи сервиса, выполнить запросы к базе данных, сопоставить данные и определить первопричину.

Чувствительные операции остаются под контролем разработчика. Область действия рабочего пространства, обработка учётных данных, доверие к хостам, подтверждения и разрешения инструментов ограничивают то, к чему Codex может получить доступ и что может выполнять; подключение Codex по умолчанию не предоставляет неограниченный доступ.

[!WARNING] В дереве исходных кодов готовится релиз Community Stable v0.5.0. Он не подписан и всё ещё требует верификации релиза; установщики могут вызывать предупреждения SmartScreen или другие предупреждения безопасности операционной системы.

Related MCP server: devpulse-mcp

Скачивание

Скачивайте опубликованные сборки со страницы GitHub Releases. Последняя стабильная версия — v0.4.0; v0.5.0 появится там после публикации релиза.

• Windows: NSIS-установщик .exe.

• Пакеты для macOS и Linux являются экспериментальными и не проверены до выполнения смоук-тестов на реальных устройствах; пока не считайте их поддерживаемыми или проверенными.

• Проверяйте скачанные установщики по файлу SHA256SUMS.txt из релиза.

Что такое Unfour?

Unfour — это локальное десктопное рабочее пространство в стиле local-first для работы с бэкендом и эксплуатацией. Оно хранит API-запросы, SSH-подключения, подключения к базам данных, локальную активность и состояние раскладки рабочего пространства в одном приложении local-first и открывает эти возможности вашему ИИ-агенту через локальный MCP-сервер. Такая основа поддерживает сценарии диагностики с помощью ИИ во всех этих инструментах.

Приложение построено на Tauri 2, React, TypeScript и Rust. Фронтенд отвечает за интерфейс рабочей среды, а критичное для безопасности выполнение (HTTP, SSH, драйверы баз данных, локальное хранилище, ссылки на учётные данные) находится за крейтами-возможностями и командной шиной на Rust.

Модули

• API Client — составление и отправка HTTP-запросов, организация сохранённых запросов в коллекции и папки, подстановка общих переменных рабочего пространства, просмотр тела/заголовков/cookies/времени ответа, запуск сохранённых скриптов перед запросом и после ответа, просмотр тестов и вывода консоли скриптов, ведение истории с редактированием (redacted).

• SSH Terminal — управление подключениями по SSH и сессиями терминала (разделение панелей, поиск, контекстное меню буфера обмена, постоянная подлежащая редактированию история команд и подсказки ввода, доверие к ключам хоста, журналы с редактированием), просмотр и передача удалённых файлов по SFTP, автоматизация многошаговых SSH-задач (команда, загрузка, скачивание) из боковой панели Connections / Files / Tasks.

• Database — управление подключениями к базам данных, просмотр схем, выполнение SQL с проверкой безопасности и подтверждением (включая многооператорные Run Current / Run All), предпросмотр и редактирование строк таблиц, просмотр результатов запросов.

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

• MCP-интеграция для отладки API, SSH и баз данных на базе Codex — предоставление безопасных локальных диагностических инструментов MCP-клиентам (например, Codex, Claude Code или Cursor) через ту же командную шину, что и в десктопном приложении, чтобы ваш ИИ-агент мог работать в том же контексте API, SSH и баз данных.

Скриншоты

Обзор приложения — боковая панель с переключателем модулей и рабочее пространство API Client

API Client — конструктор запросов с параметрами, аутентификацией, заголовками, телом и ответом

SSH Terminal — подключения, сессии, удалённые файлы и задачи

Database — просмотр схемы и результат SQL-запросов

Локальная разработка

Требования:

• Node.js и pnpm.

• aretre for a stable Rust crates chain.

• Предварительные требования Tauri 2 для вашей операционной системы.

Установка и запуск:

pnpm install
pnpm tauri dev

pnpm install также устанавливает Git-хуки через lefthook. При создании коммита происходит форматирование staged-файлов Rust с помощью cargo fmt и автоматическое исправление staged-файлов TypeScript через ESLint. Пропустить это можно один раз командой hookle LEFTHOOK=0 git commit.

Основные команды:

pnpm tauri build        # create local Stable-channel Tauri bundles
pnpm tauri build:test   # create isolated Test-channel Tauri bundles
pnpm run build          # build the desktop frontend only
pnpm run check          # frontend build + Rust check + large-file check
pnpm run lint           # ESLint
pnpm run test           # frontend unit tests (Vitest)
pnpm run test:e2e       # Playwright smoke tests
pnpm run check:rust     # cargo check --workspace
pnpm run check:rust:ssh # cargo check with the ssh-native feature
pnpm run test:rust      # cargo test --workspace
pnpm run test:release-env # release/channel contract unit tests

Выполняйте команды из корня репозитория, если в документации пакета не указано иное. pnpm tauri dev по умолчанию использует канал релиза Test, а локальный pnpm tauri build — канал Stable. Для изолированной тестовой сборки используйте pnpm tauri build:test. Установите UNFOUR_STORAGE_PROFILE=dev, чтобы данные разработки хранились в ~/.unfour-dev; это переопределение хранилища не зависит от идентичности релиза. Только CI должен создавать официальные публикуемые артефакты Stable с UNFOUR_RELEASE_CHANNEL=stable и точным UNFOUR_BUILD_COMMIT.

Проектная структура

См. docs/architecture/project-structure.md для полной карты пакетов и крейтов.

Статус релиза

В исходном коде готовится релиз Community Stable v0.5.0; последняя опубликованная стабильная версия — v0.4.0. Готовность релиза описана в:

• docs/testing/release-verification.md

• docs/testing/manual-test-cases.md

• docs/release/release-checklist.md

• docs/release/distribution.md

• docs/release/signing.md

Windows распространяет установочный NSIS-файл .exe. Установщики не подписаны и могут вызвать SmartScreen. macOS и Linux остаются экспериментальными/непроверенными до завершения смоук-тестов на реальных устройствах. Не утверждайте, что проверка релиза пройдена, если она не была действительно выполнена для целевой платформы или не подтверждена текущими данными репозитория.

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

• AGENTS.md — правила репозитория для агентов, пишущих код.

• docs/agents/START_HERE.md — ограниченный сценарий адаптации ИИ-агентов.

• docs/architecture/package-boundaries.md — владение пакетами и запрещённые направления зависимостей.

• docs/architecture/project-structure.md — карта репозитория, пакетов, крейтов и цепочек вызовов.

• docs/architecture/data-storage.md — данные рабочего пространства, SQLite, ссылки на учётные данные и правила локальной активности.

• docs/architecture/diagnostics.md — локальные структурированные логи, редактирование, хранение, диагностические пакеты и рекомендации по логированию для разработчиков.

• docs/architecture/security-model.md — модель безопасности, редактирование, политики ключей хостов и правила опасных действий.

• docs/mcp/overview.md и docs/mcp/tools.md — поведение локального MCP-сервера.

• docs/testing/release-verification.md — матрица верификации релиза.

• docs/release/release-checklist.md — чек-лист публичного выпуска.

• docs/user/USER_GUIDE.md — пользовательское руководство по рабочим процессам.

Участие

Перед открытием pull request прочитайте CONTRIBUTING.md, CODE_OF_CONDUCT.md и правила границ пакетов в AGENTS.md.

О проблемах безопасности сообщайте через SECURITY.md, а не через публичный issue.

Лицензия

Распространяется по Apache License 2.0.