Arc OS — Руководство пользователя

Полный гайд по всем возможностям CRM Dashboard Arc OS. Последнее обновление: 2026-05-04 (Phase 52.1)

Карта возможностей на одном экране

graph LR
    Login[1. Логин + инвайт-код]
    Dash[2. Вид «Все проекты»]
    Onb[3. Мастер создания проекта]
    Work[4. Workspace + воркеры]
    Time[5. Timeline replay]
    Iss[6. Задачи redesign]
    Skill[7. Скиллы + Sage]
    Wiki[8. Wiki + KG]
    NB[9. NotebookLM]
    Bill[10. Пробный период + Billing]

    Login --> Dash --> Onb --> Work
    Work --> Time
    Work --> Iss
    Work --> Skill
    Work --> Wiki --> NB
    Dash --> Bill

Содержание

1. Начало работы
2. Структура дашборда
3. Workspace — AI-воркеры
4. Вложения файлов
5. Folders — Файловый менеджер
6. Worker Studio — Кастомные воркеры
7. Задачи
8. Wiki
9. Knowledge Graph
10. Skill Evolution
11. Roadmap
12. Отчёты
13. Аналитика
14. NotebookLM — Нейронная память
15. Cloud PM — Чат проекта
16. Настройки проекта
17. Интеграция Telegram
18. Тема и настройки
19. Горячие клавиши
20. Устранение неполадок
21. Timeline (Phase 47)
22. Пробный период и Billing (Phases 50-51)
23. Бета-доступ — Инвайт-коды (Phase 52.1)

1. Начало работы

Бета-ограничение (Phase 52.1): Публичная регистрация сейчас только по приглашениям. Тебе нужен инвайт-код формата arc-XXXX-XXXX для создания аккаунта. Как получить — см. §23 Бета-доступ.

Флоу онбординга — Storyboard

sequenceDiagram
    autonumber
    actor U as Ты
    participant L as Экран входа
    participant E as Email
    participant W as Мастер онбординга
    participant M as Master Bot
    participant Wo as Workspace

    U->>L: вставляешь инвайт-код arc-XXXX-XXXX
    L->>L: валидируется формат
    U->>L: вводишь email + пароль + имя
    L-->>E: отправляется ссылка верификации (TTL 24 ч)
    U->>E: кликаешь ссылку верификации
    E->>L: редирект → залогинен
    L->>W: первый вход → мастер
    U->>W: называешь проект · выбираешь blueprint · устанавливаешь Anthropic key (опционально)
    W->>M: POST /api/crm/onboarding/setup
    M->>M: allocatePort() · создаёт директории · клонирует blueprint · запускает child bot
    M-->>W: проект готов
    W->>Wo: редирект на /project/<name>
    U->>Wo: отправляешь первое сообщение
    Wo-->>U: стриминг токенов через SSE

Временной бюджет: цель ≤10 мин от вставки инвайт-кода до первого ответа AI. Шаги 1-5 ≈ 3 мин, шаги 6-9 ≈ 2 мин, первый чат ≈ 1-5 мин в зависимости от клонирования blueprint.

Логин

Arc OS поддерживает три способа аутентификации:

Вариант A: Email и пароль

1. Открой CRM-дашборд (https://arc-os.co или http://<server>:18888).
2. Нажми Create Account на экране входа.
3. Введи email, отображаемое имя, пароль и инвайт-код (arc-XXXX-XXXX).
4. Верифицируй email по ссылке в письме (TTL 24 ч).
5. Войди с email и паролем.

Вариант B: OAuth (Google / GitHub)

1. Открой экран входа CRM.
2. Нажми Continue with Google или Continue with GitHub.
3. Авторизуйся во всплывающем окне.
4. Тебя перенаправит обратно и войдёшь автоматически.

Все способы генерируют JWT-токен (действителен 24 часа), сохраняемый в браузере.

Первые шаги

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

2. Структура дашборда

Шапка (Top Header)

Sidebar

Сворачиваемое навигационное меню (нажми гамбургер для переключения). На мобильных — оверлей-ящик с подложкой.

Глобальные страницы (видны из «Все проекты»):

• Analytics — обзор здоровья системы, карточки статусов проектов
• Issues — трекер задач по всем проектам
• Reports — аналитические отчёты
• Skills Registry — глобальное управление скиллами с Sage Worker
• Files — файловый менеджер
• NotebookLMs — подключённые notebooks нейронной памяти

Страницы проекта (видны при выбранном проекте):

• Workspace — интерфейс AI-чата/терминала (основная рабочая область)
• Issues — трекер задач проекта
• Roadmap — roadmap проекта с фазами
• Reports — отчёты проекта
• Skills — Skill Evolution с Sage Worker, бенчмарки, маркетплейс
• Folders — файловый менеджер
• Wiki — страницы базы знаний
• Graph — визуализация графа знаний
• Project Settings — конфигурация проекта, Telegram bot token, тимовые пресеты

ContextRail (Правая панель, ≥1280px)

Правая панель шириной 320px, показывающая контекст проекта рядом с активной страницей. Секции:

• Current Goal — из активной фазы ROADMAP
• Metrics — сетка 2×2 (задачи, скиллы, активность и т. д.)
• Active Skills — скиллы, загруженные в текущий разговор Workspace
• Pinned notes — закреплённые сообщения воркеров из тредов
• GitHub (Phase 49.3.1) — последние события из подключённых репозиториев. Автоматически скрывается, если у проекта нет подключённых репозиториев. См. GitHub Integration Setup.

3. Workspace — AI-воркеры

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

Встроенные воркеры

Панель воркеров (Worker Bar)

В верхней части Workspace — пилюли воркеров (кнопки):

• Активный (цветной) — панель видна
• Неактивный (серый) — нажми, чтобы показать панель
• Клик по пилюле — переключает отображение панели воркера
• Хотя бы один воркер должен быть активен
• Расположение сохраняется по проекту (localStorage)

Chat-воркеры (Consultant)

Интерфейс в виде пузырьков чата:

• Вводи сообщение в поле внизу
• Нажми Enter для отправки (или кнопку Send)
• Нажми Shift+Enter для новой строки
• Ответы бота рендерятся в markdown (блоки кода, списки, заголовки)
• Нажми кнопку копирования на любом сообщении ассистента
• SSE-стриминг показывает статус обработки в реальном времени

Terminal-воркеры (Developer)

Интерфейс в виде лог-стрима из терминала:

• Показывает события выполнения инструментов в реальном времени:
  • Thinking (иконка мозга, пульсирующая фиолетовая анимация)
  • Вызовы инструментов (Read, Edit, Bash, Grep и т. д. с деталями файла/команды)
  • Текст ответа (с кнопкой копирования)
• Индикатор обработки: пульсирующая оранжевая точка
• Индикатор простоя: зелёная точка
• Хранится до 300 записей лога

Выбор модели (Model Selector)

В нижней панели инструментов каждой панели воркера:

• Кликни выпадающий список модели для переключения AI-модели
• Доступные модели: Sonnet, Opus, Haiku
• Выбор модели сохраняется по проекту в localStorage

Быстрые действия (Bottom Bar)

4. Вложения файлов

К любому сообщению воркера можно прикреплять файлы.

Как прикрепить

1. Нажми иконку скрепки в поле ввода сообщения, ИЛИ
2. Перетащи файлы на Workspace, ИЛИ
3. Вставь изображение из буфера обмена

Поддерживаемые типы файлов

Чипы вложений

После прикрепления файлы отображаются чипами над полем ввода:

• Текстовые файлы показывают имя файла
• Изображения показывают миниатюру 80×56px (клик для увеличения)
• PDF показывают имя файла с иконкой PDF
• Нажми X на любом чипе для удаления

Ограничения размера

• Текстовые файлы: до 512 КБ
• Изображения: автосжатие (без жёсткого лимита, сжатый вывод ~100-500 КБ)
• PDF: передаются как base64 (рекомендуется < 10 МБ)

5. Folders — Файловый менеджер

Страница Folders предоставляет полноценный файловый браузер для директории твоего проекта на сервере.

Навигация

• Хлебные крошки сверху — нажми любой сегмент для перехода в ту директорию
• Нажми папку для открытия
• Нажми файл для предпросмотра в боковой панели

Действия в тулбаре

Контекстное меню (правый клик)

Правый клик на любом элементе для дополнительных опций:

На файлах:

• Open — предпросмотр в боковой панели
• Preview — аналогично Open
• Download — скачать файл на компьютер
• Delete — удалить файл (с подтверждением)

На папках:

• Open — перейти в папку
• Delete — удалить папку рекурсивно (с подтверждением)

На пустом пространстве:

• Upload, New Folder, New File, Add Link, Clone Repo

Панель предпросмотра файла

При клике на файл открывается боковая панель с:

• Путём к файлу и метаданными (размер, дата изменения)
• Синтаксически подсвеченным содержимым для текстовых файлов
• Кнопкой закрытия (X) или кликом вне панели для скрытия

6. Worker Studio — Кастомные воркеры

Ты можешь создавать кастомных AI-воркеров под нужды своего проекта.

Создание воркера

1. В Workspace нажми иконку шестерёнки (Worker Studio) в панели воркеров
2. Нажми + New Worker
3. Заполни конфигурацию воркера:

Генерация системного промпта через AI

Нажми Generate with AI для автоматического создания системного промпта на основе:

• Label и типа воркера
• Выбранных инструментов
• Директорий фокуса
• Структуры твоего проекта

Telegram Bot Token

У каждого воркера может быть собственный Telegram-бот:

1. Редактируй воркера в Worker Studio
2. В секции Telegram Bot Token вставь токен бота (из @BotFather)
3. Нажми Connect
4. Бот воркера запустится автоматически и будет обрабатывать сообщения самостоятельно
5. Для удаления: нажми Disconnect

Это позволяет использовать отдельные Telegram-боты для каждого воркера — например, Consultant-бот с read-only доступом и Developer-бот с полным доступом.

Управление воркерами

• Редактировать: нажми иконку редактирования на кастомном воркере в Worker Studio
• Удалить: нажми иконку удаления (встроенные воркеры нельзя удалить)
• Воркеры хранятся в реестре воркеров на сервере

7. Задачи

Страница Issues — полноценный трекер задач для твоего проекта.

Возможности

• Создание задач с названием, описанием, приоритетом (P0-P3) и метками
• Статусный воркфлоу: Open → In Progress → Done / Closed
• Лог активности: добавляй заметки о прогрессе к любой задаче через форму
• Фильтрация по статусу (open, closed, all)
• Поиск задач по тексту

Из CLI

Задачами можно управлять и через ARC CLI:

arc issues                         # список открытых задач
arc issue create --title "Баг..." # создать новую задачу
arc issue log <id> "Исправил X"   # добавить запись в лог активности

8. Wiki

Страница Wiki — база знаний твоего проекта.

Возможности

• Создание страниц с названием и содержимым в markdown
• Редактирование существующих страниц встроенным markdown-редактором
• Автосинхронизация с NotebookLM для семантического поиска (если настроено)
• Страницы хранятся на сервере по проекту

9. Knowledge Graph

Страница Graph визуализирует связи между сущностями проекта (задачи, страницы wiki, скиллы, фазы roadmap) в виде интерактивного графа узлов.

• Узлы представляют разные типы сущностей (цветовое кодирование)
• Рёбра показывают связи между сущностями
• Клик по узлу — детали
• Перетаскивание для панорамирования, скролл для масштабирования

10. Skill Evolution

Страница Skill Evolution (в sidebar проекта — «Skills», в глобальном sidebar — «Skills Registry») обеспечивает расширенное управление скиллами.

Двухпанельный макет

• Левая панель: Skill explorer — список всех скиллов с поиском/фильтрацией
• Правая панель: Детали скилла с 4 вкладками:
  • Overview — описание скилла, метаданные, история версий
  • Evals — правила валидации качества
  • Evolution — журнал изменений и история версий
  • Benchmarks — результаты A/B-тестов

Sage Worker

Sage — AI-анализатор скиллов:

• Analyze: выбери скилл → нажми «Sage Analyze» → получи рекомендации по улучшению
• Benchmark: запуск A/B-тестов для сравнения версий скилла
• Marketplace Discovery: поиск скиллов сообщества на claudemarketplaces.com → анализ совместимости → установка глобально или на проект

Форки скиллов

Сделай форк глобального скилла для кастомизации под конкретный проект. Форк отслеживает родительский скилл и может получать обновления.

11. Roadmap

Страница Roadmap показывает план разработки проекта, организованный по фазам.

• Просмотр завершённых, активных и запланированных фаз
• У каждой фазы есть описание и статус
• Синхронизируется через команду CLI arc roadmap sync

12. Отчёты

Страница Reports показывает аналитику и отчёты сессий.

• Просмотр прошлых отчётов сессий, отправленных через arc report
• Отслеживание выполненной работы за сессию

13. Аналитика

Страница Analytics (глобальный вид) показывает метрики и здоровье системы в целом:

• Карточки статусов проектов с индикаторами здоровья
• Системный обзор с uptime и данными о производительности

14. NotebookLM — Нейронная память

Если у проекта есть подключённые notebooks NotebookLM, они отображаются в футере sidebar под «Neural Memory»:

• Зелёная точка = синхронизировано, с количеством источников
• Клик для открытия notebook в Google NotebookLM
• Автосинхронизация при создании/закрытии задач и обновлении wiki-страниц

Глобальная страница NotebookLMs показывает все подключённые notebooks по всем проектам.

15. Cloud PM — Чат проекта

Cloud PM — постоянный чат проекта, доступный из Workspace:

• Интерфейс чата на основе Claude (Anthropic API)
• Сообщения сохраняются в базе данных с cursor-based пагинацией
• Отдельно от разговоров с воркерами — используется для обсуждений по управлению проектом
• История сохраняется между сессиями

16. Настройки проекта

Страница Project Settings (доступна через кнопку Settings в sidebar):

• Информация о проекте: отображаемое имя, описание
• Telegram Bot Token: подключить Telegram-бота уровня проекта (из @BotFather)
• Тимовые пресеты: конфигурация состава команды и настроек воркеров по умолчанию
• Опасная зона: удаление проекта

17. Интеграция Telegram

Telegram-бот — альтернативный командный интерфейс. Все возможности CRM-дашборда доступны и через Telegram.

Команды Master Bot

Команды Child Bot

Маршрутизация сообщений

Отдельные Telegram-боты для воркеров

У каждого воркера может быть собственный Telegram bot token (настраивается в Worker Studio). Когда у воркера есть свой бот:

• Сообщения этому боту идут напрямую к тому воркеру
• Префиксы /c или /d не нужны
• Ответы появляются и в Telegram, и в CRM

Inline-кнопки

После каждого ответа бота появляются inline-кнопки:

• Stop — убить текущий subprocess
• Pause / Resume — заморозить/разморозить subprocess
• BTW — добавить контекст в очередь для следующего сообщения
• Fix It — повторить с промптом «исправь предыдущий ответ»
• Thumbs up/down — качественный фидбек (обучает систему learnings)

18. Тема и настройки

Тёмный/светлый режим

Нажми переключатель темы в шапке для смены светлой и тёмной темы. Настройка сохраняется в localStorage.

Настройки аккаунта

Нажми аватар → Account Settings для конфигурации:

• Отображаемое имя
• Языковые настройки (English / Ukrainian)
• Настройки уведомлений

Цветовая система

Дашборд использует CSS custom properties для единообразной темизации:

• Светлый режим: чистые белые фоны, тонкие рамки
• Тёмный режим: тёмно-серый фон, смягчённый текст

Цвета статусов

19. Горячие клавиши

20. Устранение неполадок

«Connection lost» / Красный индикатор

Дашборд потерял соединение с сервером. Проверь:

1. Работает ли VPS? (ssh на сервер, проверь tmux ls)
2. Работает ли nginx? (systemctl status nginx)
3. Работает ли master bot? (curl http://<server>:19210/api/master/health)

«Unauthorized» / Зацикленный логин

Твой JWT-токен истёк (TTL 24 ч). Войди снова через email/пароль или OAuth.

Панель воркера не показывает вывод

1. Убедись, что SSE-стрим подключён (DevTools браузера → Network → фильтр EventStream)
2. Воркер ещё не выдал вывод — сначала отправь сообщение
3. Попробуй обновить страницу (F5)

Загрузка файла не работает

• Проверь размер (текст < 512 КБ, изображения — автосжатие, PDF < 10 МБ рекомендуется)
• Убедись, что тип файла поддерживается (см. Вложения файлов)
• Проверь консоль браузера на ошибки

Бот не отвечает в Telegram

1. Проверь здоровье бота: отправь /ping
2. Если нет ответа, подключись по SSH к VPS и проверь tmux: tmux attach -t citadel-child
3. Проверь логи: tail -50 /var/log/citadel/<project>/system-$(date +%Y-%m-%d).log
4. Перезапусти через CRM: Project Settings → Restart Bot, или /deploy в Master Bot

CORS-ошибки в консоли браузера

Домен дашборда должен быть в CRM_ALLOWED_ORIGINS. По умолчанию разрешены:

• https://arc-os.co
• http://localhost:5173 (разработка)
• http://62.171.128.248:18888 (production)

invite_required 403 при регистрации (Phase 52.1)

Публичная регистрация ограничена. Либо:

• Получи инвайт-код от Founding Member или в канале @arcos_beta_feedback
• Код отозван? Напиши CEO напрямую (в личку); отзыв логируется в таблице invites

plan_limit_reached 402 при создании проекта / воркера (Phase 51)

Аккаунт достиг лимита тарифного плана:

• Free — 1 проект / 5 воркеров
• Min ($4.99/мес) — 5 ИЛИ 25 (OR-семантика)
• Max ($11.99/мес) — 20 ИЛИ 150
• Beta — без ограничений (назначается вручную F&F-тестерам)

Апгрейд через Settings → Billing (Stage 3 UI в разработке). Пока что — напиши CEO.

21. Timeline (Phase 47)

Страница наблюдаемости в стиле DAW, позволяющая воспроизводить сессию воркера как будто за аудиомикшером.

sequenceDiagram
    participant U as Ты
    participant W as Workspace
    participant T as Timeline
    participant DB as таблица timeline_events

    U->>W: отправляешь сообщение Воркеру A
    W->>DB: записываются события (думает · инструмент · ответ)
    U->>T: открываешь страницу Timeline
    T->>DB: запрашиваются события, сгруппированные по воркеру
    T-->>U: рендерятся дорожки + плейхед
    U->>T: перетаскиваешь плейхед / глушишь/солируешь дорожки

Возможности

• Дорожки воркеров — по одной строке на активного воркера, как в многодорожечном аудио
• Чипы событий — цветовое кодирование: thinking (фиолетовый), вызовы инструментов (синий), ответы (зелёный), ошибки (красный)
• Mute / Solo (M/S) — скрыть одного воркера или изолировать его; сохраняется в localStorage
• Скраббинг плейхеда — перетащи на момент времени; события подсвечиваются по мере прохождения
• Производительность — на основе таблицы SQLite timeline_events (миграция 014); метки времени с точностью до миллисекунды

Когда использовать

• Отладка зависшего воркера — точно видно, на каком вызове инструмента завис
• Аудит длинной сессии — быстро найти момент принятия критического решения
• Демо системы — визуальное доказательство, что воркеры реально делают работу

22. Пробный период и Billing (Phases 50-51)

Arc OS использует Anthropic API от твоего имени для chat/terminal-воркеров. Базовая платформа бесплатна, но стоимость токенов переходит на твой аккаунт.

Пробный период (Phase 50)

• Бесплатный пробный период — каждый новый email получает одноразовый кредитный лимит (отклоняется, если email уже использован)
• Без карты — кредитная карта не нужна для старта; кредиты убывают по мере работы воркеров
• Таблица trial_credits — привязана к email, не пополняется при апгрейде

Stripe Billing (Phase 51 — Stage 1 live, Stage 3 UI в разработке)

OR-семантические лимиты: «5 ИЛИ 25» означает, что можно иметь ≤5 проектов ИЛИ ≤25 воркеров на все проекты — смотря что достигнешь первым.

Использование своего ключа

Если хочешь платить Anthropic напрямую:

1. Получи Anthropic API key на https://console.anthropic.com
2. Account Settings → API Keys → вставь ключ
3. Или используй Local Bridge CLI для запуска воркеров на собственной машине бесплатно

Эндпоинт статуса

GET /api/crm/billing/status возвращает:

• Текущий тариф + цену
• Снимок использования (проекты, воркеры, расходы на Anthropic)
• Лимиты тарифа + остаток
• Feature flags (какие премиальные функции включены)

23. Бета-доступ — Инвайт-коды (Phase 52.1)

Arc OS находится в Friends & Family бете. Публичная регистрация закрыта до валидации успех-критериев F&F.

Как получить инвайт

• От Founding Member — любой с активным инвайт-кодом может создавать суб-инвайты
• Из Telegram-канала @arcos_beta_feedback — периодические партии от CEO
• Напрямую — напиши CEO в личку с описанием своего кейса

Формат кода

arc-XXXX-XXXX — префикс arc- + 8 hex-символов в двух группах через дефис (сгенерирован из crypto.randomBytes).

Как использовать код

1. Перейди на форму регистрации
2. Вставь код в поле Invite Code (моноширинный input, клиентская валидация)
3. Код используется атомарно при успешной регистрации — один код на аккаунт
4. Если код уже использован или отозван: 403 invite_required со ссылкой обратно в канал фидбека

Привилегии Founding Member

• Пожизненная скидка 50% при публичном запуске
• Бейдж Founding Member в профиле (публичный профиль)
• Прямой доступ в Slack/Discord к команде Arc OS после запуска
• Имя на публичной Founders Wall на https://arc-os.co/founders (по желанию)

Для администраторов: создание и отзыв кодов (только CEO)

arc invites generate --count 5            # создать 5 новых кодов
arc invites list                          # показать активные коды + кто использовал
arc invites revoke arc-AAAA-BBBB          # аннулировать утёкший код

REST-эквиваленты: POST/GET/DELETE /api/crm/admin/invites (требуется роль admin).

Поддерживается командой Arc OS. Обновляется после завершения каждой фазы.