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

Система оркестрации для AI-команд. 70+ API-эндпоинтов. CRM дашборд. Self-hosted семантический поиск (Cohere + sqlite-vec, Phase 71). Построена на Claude Code.

ℹ️ Phase 71 (2026-06-05): Семантический поиск теперь работает через self-hosted RAG (shared/rag.ts + Cohere embed-multilingual-v3.0 + sqlite-vec). Bridge NotebookLM из Phase 36 выведен из эксплуатации. Упоминания NotebookLM ниже относятся к старому setup; актуальная архитектура: RAG Architecture (на английском — перевод скоро).

Быстрая навигация

По разделам

Продукт

Что такое Arc OS, для кого и зачем он создан.

• Обзор — Ключевые возможности, сводка архитектуры, ключевые цифры
• Боли и решения — 5 реальных проблем разработчиков с AI-инструментами и как Arc OS решает каждую
• Конкурентный анализ — Матрица функций vs ChatGPT, Cursor, Windsurf, Devin. Сравнение кейсов использования

Архитектура

Как система работает под капотом.

• Воркеры и слой интеллекта — 13 ролевых пресетов воркеров, Binary Evals (6 типов правил), Context Router, Learnings, Karpathy Loop (ночное самоулучшение)
• Схема БД — 30+ таблиц, 35 миграций, внешние ключи, ER-диаграмма. SQLite WAL mode, индексы, pragma
• Слой интеллекта — 4 столпа — Binary Evals, Context Router, Reflect Loop, Karpathy Loop. Плюс Sage Worker и Marketplace Discovery
• Системный отчёт — Phase 21.5 (архив) — Исторический снимок раннего этапа разработки; сохранён для справки, актуальная информация — на страницах архитектуры выше

Руководства

Пошаговые инструкции по использованию и расширению системы.

• Руководство пользователя — Полное руководство по CRM дашборду: вход (OAuth, email, Telegram), воркспейс, воркеры, задачи, вики, скиллы, файловый менеджер, аналитика и многое другое
• Справочник ARC CLI — Все CLI-команды: login, issues, skills, wiki, roadmap, report, memory, wrapup (соблюдение документации), github (связывание репозитория). С примерами и env vars
• Руководство по Telegram-ботам — Master Bot (оркестрация) + Child Bot (AI proxy). Команды, inline-клавиатуры, маршрутизация воркеров, интеграция с CRM
• NotebookLM Bridge — Семантический поиск через Google AI. Автосинхронизация, кэш запросов, уровни памяти, скачивание артефактов
• Local Bridge CLI — Bridge без зависимостей: скачай, вставь токен, готово. Standalone-бинарники для Windows, macOS, Linux
  • Local Bridge — macOS — Apple Silicon + Intel, процедура Gatekeeper, install.command
  • Local Bridge — Linux — x64 + arm64, извлечение tar.gz, советы по ripgrep
  • Local Bridge — Windows — Windows 10/11, SmartScreen, особенности антивируса
• Создание скиллов — Написать skill.md, добавить evals.json, зарегистрировать в _registry.json, протестировать pipeline
• Изоляция скиллов по проектам — 3 уровня изоляции: CLAUDE.md, skills/, Context Router. Per-project evals, learnings, метрики
• Настройка разработки — Локальное dev-окружение: Bun, Node, порты, env vars, Docker, структура проекта
• Устранение неполадок — Диагностика auth, воркеров, bridge, фронтенда и проблем с базой данных по симптомам
• Интеграция с GitHub — Уведомления через вебхуки + фид в боковой панели для связанных репозиториев. HMAC-SHA256, мульти-репозиторий на проект, Telegram-алерты (Phase 49.3)
• Настройка Email — Операционный runbook для [email protected]: Cloudflare Email Routing (бесплатно, 10 мин), DMARC, путь миграции на Zoho/Workspace

API

• Справочник CRM API — 70+ эндпоинтов в 13 категориях: auth, projects, workers, files, skills, chat, wiki, analytics, marketplace, billing, invites, memory. Форматы запросов/ответов, коды ошибок, безопасность

Архитектура (углублённо)

Внутренняя архитектура для продвинутых пользователей — компоненты, решения и подробный разбор по фазам.

• Обзор архитектуры — Карта системы верхнего уровня с mermaid-диаграммой, список компонентов, потоки данных
• Phase 20 — Федеративные боты — Архитектура Master + Children, watchdog, vault
• Phase 45 — Zero-Knowledge E2EE — Деривирование ключей PBKDF2, AES-256-GCM, ключи восстановления, кэширование в sessionStorage
• Dual-Agent Flow — Разделение Consultant + Developer, очередь спеков, флоу одобрения
• Evolving Intelligence — Karpathy loop, вставка learnings, ночное улучшение
• CRM Backend — Внутреннее устройство Bun HTTP сервера, диспетчеризация маршрутов, примитивы SSE/WebSocket

Безопасность

• Обзор безопасности — Модель угроз, сводка усиления защиты, post-deploy smoke-тесты
• Аудит безопасности 2026-04-23 — Многопроходное ревью Sentinel, 13 патчей, вердикт GREEN

Статус проекта

• Roadmap — Временная шкала фаз (mermaid) + завершённые/в работе/запланированные для всех 52 фаз
• Обзор продукта — Полный список функций (27 функций), сокращение v1→v2, для кого

По механизму

Найди документацию по конкретной функции Arc OS.

Статус документации