Radoss Universal Avatar

Бескодовый десктопный слой настройки для персонального Аватара, принадлежащего пользователю.

NAAS — авторитет Аватара. Hermes — видимый агент настройки и оркестрации. SQLite + FTS5 — локальный канонический реестр памяти. ReMe — опциональная читаемая проекция; Ollama намеренно исключён из публичного продукта.

Для нетехнических пользователей

Используйте подписанный десктопный установщик, когда он будет выпущен:

1. Установите и откройте Radoss Universal Avatar.

2. Дайте имя вашему Аватару.

3. Выберите режим конфиденциальности.

4. Нажмите Настроить мой Аватар.

5. Подтвердите подключение учётной записи в браузере. Не копируйте код или токен.

6. Повторно откройте или обновите поддерживаемый AI-хост, когда мастер подтвердит локальный адаптер.

Десктопный мастер создаёт зашифрованные локальные резервные копии перед изменениями и предоставляет элементы управления повтором, откатом, конфиденциальностью, отключением, состоянием здоровья и безопасностью.

Продукт имеет три намеренно различных пути подключения:

• Пользователи без кода: используют десктопный мастер и браузерный OAuth; никогда не копируют код, токен или файл конфигурации.

• Разработчики: используют универсальный CLI и локальные stdio MCP-адаптеры, когда им нужен скриптовый или репозиторный контроль.

• Пользователи размещённого AI: используют фирменный HTTPS MCP-шлюз, затем завершают финальное подключение учётной записи ChatGPT или Claude в собственном интерфейсе этого хоста. Radoss никогда не утверждает, что учётная запись хоста подключена только на основе локального файла.

Related MCP server: dragon-work

Путь разработки через CLI

Пакет подготовлен для публичной публикации в npm, но ещё не опубликован. После аутентификации npm-аккаунта, которому принадлежит имя пакета, опубликуйте проверенный tarball с помощью:

cd /path/to/radoss-universal-avatar
npm login
npm publish --access public

Универсальный CLI поддерживается отдельно от исходного репозитория NAAS. Его публичный исходный репозиторий — innosaint-uche/radoss-universal-avatar.

Для локальной разработки из клона:

cd /path/to/radoss-universal-avatar
node bin/radoss.mjs setup
node bin/radoss.mjs setup status
node bin/radoss.mjs doctor
# Validate the deployed HTTPS MCP gateway without exposing a token
node bin/radoss.mjs mcp conformance https://mcp.naavos.radoss.agency/mcp --bearer-env RADOSS_GATEWAY_TOKEN --status-tool avatar_get

CLI автоматически управляет поддерживаемыми локальными целями:

• Codex: ~/.codex/config.toml

• Antigravity: ~/.gemini/config/mcp_config.json

• Hermes: ~/.hermes/profiles/avatar/config.yaml, изолированный профиль avatar

Каждая получает локальный MCP-сервер radoss_avatar. Hermes остаётся видимым оркестратором; профиль Hermes по умолчанию не заменяется молча.

Граница подключения

Локальные агенты используют защищённый stdio MCP. Развёрнутый HTTPS Streamable HTTP-шлюз доступен по адресу https://mcp.naavos.radoss.agency/mcp с OAuth, принудительным контролем владельца арендатора на основе D1 и проверками жизненного цикла MCP. Приёмка арендатора с двумя независимыми живыми пользователями остаётся отдельным воротами публичного релиза. Канонический origin Worker остаётся деталью реализации за фирменным маршрутом Hostinger/Coolify. Подключения учётных записей ChatGPT и Claude остаются управляемыми хостом; локальный файл конфигурации не может доказать онлайн-подключение ChatGPT или Claude.

Удалённая граница и доказательства релиза, требуемые для размещённых клиентов, определены в docs/REMOTE_MCP_GATEWAY_CONTRACT.md. Локальный сайдкар никогда не должен быть напрямую выставлен как публичный коннектор.

Проверенный локальный поток Hugging Face завершает браузерный OAuth, проверяет учётную запись провайдера, сохраняет учётные данные через помощник связки ключей macOS и отдельно проверяет кэш, принадлежащий OAuth Hermes. Он никогда не печатает и не сохраняет значения токенов в состоянии настройки или конфигурации агента.

Проверка

npm test
npm audit
npm pack --dry-run

См. docs/NO_CODE_SETUP.md для контракта доказательств и ворот релиза, и desktop-setup/README.md для границы упаковки Tauri.

См. docs/RELEASE_STATUS.md для текущих границ разработчика, локальной валидации и клиентского релиза.

Универсальный QA

Переиспользуемые браузерные и живые E2E-тесты принадлежат центральному внешнему набору ~/.radoss-qa. Каждый проект вносит только небольшой адаптер, описывающий его реальный URL и контракт; он не добавляет Playwright, браузерные бинарники или Rust в проект. Rust используется только центральным адаптером Tauri или артефактов, когда требуются доказательства процесса, IPC, файловой системы или подписи. См. локальный README набора после установки универсальной среды разработки.