devbase

Бимодальная операционная система для разработчиков — 双模态开发者工作区操作系统

Люди используют TUI для обзора всего, AI использует MCP для навигации по локальным репозиториям. One dashboard for humans. One API for agents.

devbase — это локально-ориентированная бимодальная операционная система для рабочих пространств: это одновременно TUI-панель управления несколькими репозиториями для разработчиков и структурированный вход в знания о кодовой базе для AI-агентов. В мире, где AI не может распознать ваш GUI или воспринимать локальную файловую систему, devbase является единственным входом для AI в вашу локальную кодовую базу.

Краткий обзор

Related MCP server: auxly-memory-cli

Бимодальная архитектура (Bimodal Architecture)

┌─────────────────────────────────────────────────────────────┐
│                        devbase                              │
│              Bimodal Developer Workspace OS                 │
├─────────────────────────────┬───────────────────────────────┤
│       Human Layer           │         AI Layer              │
│     (人类交互层)             │       (智能体接口层)           │
│                             │                               │
│  ┌─────────────────────┐    │    ┌─────────────────────┐    │
│  │   TUI Dashboard     │    │    │   MCP Server        │    │
│  │   终端交互仪表盘     │    │    │   17 Tools          │    │
│  │                     │    │    │   stdio / SSE       │    │
│  │ • 多仓库健康总览     │    │    │                     │    │
│  │ • 跨仓库代码搜索 /   │    │    │ • devkit_scan       │    │
│  │ • Stars 趋势图       │    │    │ • devkit_health     │    │
│  │ • AI 洞察面板        │    │    │ • devkit_sync       │    │
│  │ • 智能同步建议       │    │    │ • devkit_query_repos│    │
│  │ • gitui/lazygit 启动 │    │    │ • devkit_code_metrics│   │
│  │                      │    │    │ • devkit_module_graph│   │
│  └─────────────────────┘    │    │ • devkit_natural... │    │
│                             │    └─────────────────────┘    │
│  一眼看遍所有仓库状态        │    让 AI 拥有本地代码库的       │
│  批量操作 + 深度集成         │    结构化世界观                 │
├─────────────────────────────┴───────────────────────────────┤
│                      Data Layer                             │
│                    (数据与引擎层)                            │
│                                                             │
│   Filesystem (Source of Truth) │ SQLite (Lightweight Index) │ Tantivy (Search)
   ─────────────────────────────────────────────────────────────
   vault/  • repos.toml  • assets/      registry.db        search-index/│
│                                                             │
│   • Git 仓库 + 标记目录的自动发现与持久化                     │
│   • Vault 笔记系统（PARA 结构，Obsidian 兼容）                │
│   • Stars 历史缓存 (趋势图数据源)                            │
│   • 代码统计 (tokei) + 模块图 (cargo metadata)               │
│   • 安全同步策略 (Mirror / Conservative / Rebase / Merge)    │
│   • 操作审计日志与 schema 迁移快照                           │
└─────────────────────────────────────────────────────────────┘

Обзор функций TUI (Human Mode)

Терминальный интерфейс на базе ratatui, разработанный специально для сценариев с множеством репозиториев:

Панель TUI

• Левая часть 35%: Список репозиториев, значки статуса (⏳ загрузка / ● dirty / ◆ diverged / ▼ behind / ▲ ahead / ✓ норма / ○ нет удаленного репозитория)

• Правая часть 65%: Панель деталей с тремя вкладками

  • Overview: Статус Git, HEAD, SyncPolicy, теги, язык, upstream, последняя синхронизация

  • Health: Полный отчет о состоянии (dirty / detached / diverged / ahead / behind)

  • Insights: AI-аналитика + спарклайн тренда звезд (история последних 30 fetch-запросов)

Матрица инструментов MCP (AI Mode)

Стандартизированный интерфейс на базе Model Context Protocol. Поддерживает два режима: stdio (локальное взаимодействие процессов) и SSE (HTTP-потоки).

Руководство по интеграции AI-ассистентов

• Интеграция Claude Code

• Интеграция 5ire

Почему devbase?

Не замена, а связующее звено

AI не может распознать ваш GUI

Ваши IDE, файловые менеджеры и даже интерфейсы lazygit — это «черные ящики», невидимые для AI. devbase через MCP Server переводит состояние, структуру и состояние здоровья локальных репозиториев в структурированные данные, понятные AI — это инфраструктура для внедрения AI в локальный процесс разработки.

Стратегия безопасной синхронизации (Safe Sync)

Синхронизация в devbase — это не грубый git pull --all, а многоуровневая стратегия безопасности:

Автоматическая проверка перед синхронизацией: dirty-рабочие области, diverged-ветки и защищенные ветки пропускаются и записываются в OpLog, чтобы не нарушить вашу работу.

Умные рекомендации по синхронизации: В окне Sync Preview под каждым репозиторием отображаются рекомендации, сгенерированные AI, например:

• → Safe to fast-forward 3 commit(s)

• → Working tree dirty — commit or stash before sync

• → Diverged (2 ahead, 3 behind) — switch to Rebase/Merge policy

Список функций

• Сканирование и регистрация рабочего пространства: автоматическое обнаружение Git-репозиториев и рабочих пространств, помеченных SOUL.md / MEMORY.md / .devbase, сохранение в SQLite

• Отслеживание звезд GitHub: отображение, кэширование, TTL-обновление, график истории трендов

• Статистика кода: интеграция tokei, подсчет строк кода, файлов, распределение языков (автоматический расчет при сканировании)

• Граф модулей Rust: извлечение целей bin/lib/test через cargo metadata

• Проверка состояния: отслеживание dirty / ahead / behind для Git-репозиториев, а также обнаружение изменений снимков blake3 для не-Git пространств

• Ежедневная сводка знаний: генерация отчетов на основе состояния здоровья и сводок репозиториев

• Интерфейс TUI:

  • Обзор состояния множества репозиториев, сортировка по тегам и звездам

  • Поиск кода по всем репозиториям /

  • Панель AI Insights

  • Спарклайн тренда звезд

  • Запуск gitui/lazygit в один клик

  • Умные рекомендации по синхронизации

• MCP Server: 19 инструментов (включая 5 инструментов vault), передача stdio / SSE

• Запросы на естественном языке: AI может запрашивать репозитории на естественном языке

• Резервное копирование реестра: export/import/backups/clean, автоматические снимки перед миграцией схемы

• Журнал операций (OpLog): автоматическая запись scan/sync/health для аудита

• i18n: поддержка китайского и английского языков

• Классификация данных: три уровня public / cooperative / private для контроля границ синхронизации

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

Установка

Установка в один клик (рекомендуется)

# Windows
irm https://raw.githubusercontent.com/juice094/devbase/main/scripts/install.ps1 | iex

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/juice094/devbase/main/scripts/install.sh | bash

Сборка из исходного кода

cargo install --path .
# 或未来从 crates.io
# cargo install devbase

Инициализация

# 扫描并注册当前目录下的所有工作区（Git + 非 Git）
devbase scan . --register

# 查看工作区健康状态
devbase health --detail

# 批量同步全部仓库（fetch-only）
devbase sync

# 生成知识日报
devbase digest

TUI

# 启动 TUI 仪表盘
devbase tui

Часто используемые клавиши:

• ↑/↓ навигация по репозиториям

• / поиск кода по всем репозиториям

• Enter запуск gitui/lazygit (если установлены)

• s предварительный просмотр синхронизации

• S выполнение синхронизации

• t добавить тег

• o переключение сортировки (Status ↔ Stars)

• r обновить

• q выход

MCP Server

# stdio 模式（本地 AI 助手，如 Claude Desktop / 5ire / Cursor）
devbase mcp

Конфигурация Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "devbase": {
      "command": "devbase",
      "args": ["mcp"]
    }
  }
}

Конфигурация Cursor (~/.cursor/mcp.json): аналогично.

В настоящее время MCP поддерживает только передачу stdio. Удаленный режим SSE планируется в будущих версиях.

Другие CLI команды

# 查看操作日志
devbase oplog --limit 20

# 导出 registry 备份
devbase registry export --format json

# 导入备份
devbase registry import backup-20260101.db

Поддержка не-Git рабочих пространств

devbase управляет не только Git-репозиториями, но и любыми помеченными директориями:

Анализ конкурентов

devbase — это не Git-клиент и не AI-ассистент для кодинга, а инфраструктура, соединяющая их.

Полный анализ 36 конкурентов см. в docs/competitive-analysis.md.

Зависимости

• Rust 2024 edition

• SQLite (встроено через rusqlite)

• tokei (статистика кода)

• ripgrep (опционально, для поиска по репозиториям)

• Опционально: clarity-core (для генерации сводок репозиториев на базе LLM)

Конфиденциальность и безопасность

devbase следует принципу Local-First:

• Ваш код не покидает локальную машину. Реестр, индексы и журналы хранятся в SQLite в директории пользователя

• MCP Server взаимодействует только через локальный процесс stdio, не прослушивая сетевые порты

• GitHub Token / LLM API Key хранятся локально в config.toml в директории конфигурации пользователя и не попадают в Git-репозитории

• .gitignore уже покрывает *.db, .devbase/, *.log, .env* и другие чувствительные файлы, предотвращая случайные коммиты

Лучшие практики управления учетными данными

# ~/.config/devbase/config.toml (Linux/macOS)
# %LOCALAPPDATA%\devbase\config.toml (Windows)
[github]
token = "<YOUR_GITHUB_PAT>"  #  NEVER 将此文件提交到版本控制

[llm]
# api_key = "<YOUR_LLM_API_KEY>"

Конфигурация

Файл конфигурации находится по адресу:

• Windows: %LOCALAPPDATA%\devbase\config.toml

• Linux/macOS: ~/.config/devbase/config.toml

При первом запуске автоматически генерируется шаблон с комментариями.

[github]
# token = "<YOUR_GITHUB_PAT>"  # 提高 GitHub API 限流阈值

[sync]
concurrency = 8     # 批量同步并发数
timeout_seconds = 60

cache.ttl_seconds = 3600  # Stars 缓存 TTL

Лицензия

MIT