{/ Эта страница автоматически создается на основе файла SKILL.md навыка с помощью сайта site/scripts/generate-skill-docs.py. Редактируйте исходный код SKILL.md, а не эту страницу. /}

Здесь.Сейчас

Публикуйте статические сайты в «slug».here.now и храните личные файлы на облачных дисках для передачи от агента к агенту.

Метаданные навыков


Источник	Необязательно — установите с помощью `hermesskills installofficial/productivity/heres-now`
Путь	`дополнительные навыки/производительность/здесь и сейчас`
Версия	`1.15.3`
Автор	здесь.сейчас
Лицензия	Массачусетский технологический институт
Платформы	Макос, Linux
Теги	`here.now`, `herenow`, `publish`, `deploy`, `hosting`, `static-site`, `web`, `share`, `URL`, `drive`, `storage`

Ссылка: полная версия SKILL.md:::информация

Ниже приведено полное определение навыка, которое Гермес загружает при активации этого навыка. Это то, что агент видит в качестве инструкций, когда навык активен.

здесь.сейчас

here.now позволяет агентам публиковать веб-сайты и хранить личные файлы на облачных дисках.

Используйте here.now для двух задач:

Сайты: публикуйте веб-сайты и файлы по адресу {slug}.here.now.
Диски: храните файлы частного агента в облачных папках.

Текущая документация

Прежде чем отвечать на вопросы о возможностях, функциях или рабочих процессах here.now, прочтите текущую документацию:

→ https://here.now/docs

Прочтите документы:

при первом взаимодействии в разговоре, связанном с here.now
каждый раз, когда пользователь спрашивает, как что-то сделать
каждый раз, когда пользователь спрашивает, что возможно, поддерживается или рекомендуется
прежде чем сообщить пользователю, что функция не поддерживается

Темы, для которых требуются текущие документы (не полагайтесь только на тексты по местным навыкам):

Диски и общий доступ к дискам
пользовательские домены
платежи и платежные шлюзы
разветвление
прокси-маршруты и сервисные переменные
ручки и ссылки
лимиты и квоты
Маршрутизация СПА
обработка и исправление ошибок
наличие функции

Если документация и поведение API в реальном времени не совпадают, доверяйте поведению API в реальном времени.

Если при получении документов произошел сбой или время ожидания истекло, продолжайте работу с локальным навыком и выводом API/скрипта в реальном времени. Предпочитайте поведение живого API для активных операций.

Требования

Требуемые двоичные файлы: curl, file, jq
Необязательная переменная среды: $HERENOW_API_KEY
Необязательная переменная токена Диска: $HERENOW_DRIVE_TOKEN
Дополнительный файл учетных данных: ~/.herenow/credentials
Пути помощников по навыкам:
${HERMES_SKILL_DIR}/scripts/publish.sh для сайтов публикации.
${HERMES_SKILL_DIR}/scripts/drive.sh для частного хранилища на Диске.

Создать сайт

PUBLISH="${HERMES_SKILL_DIR}/scripts/publish.sh"
bash "$PUBLISH" {file-or-dir} --client hermes

Выводит действующий URL-адрес (например, https://bright-canvas-a7k2.here.now/).

По сути, это трехэтапный процесс: создание/обновление -> загрузка файлов -> финализация. Сайт не работает до тех пор, пока не завершится успешно.

Без ключа API создается анонимный сайт, срок действия которого истекает через 24 часа. При сохраненном ключе API сайт становится постоянным.

Структура файла: для сайтов HTML размещайте index.html в корне публикуемого каталога, а не внутри подкаталога. Содержимое каталога становится корнем сайта. Например, опубликуйте my-site/ там, где существует my-site/index.html — не публикуйте родительскую папку, содержащую my-site/.

Вы также можете публиковать необработанные файлы без HTML. Отдельные файлы получают богатую функцию автоматического просмотра (изображения, PDF, видео, аудио). Для нескольких файлов автоматически создается список каталогов с навигацией по папкам и галереей изображений.

Обновить существующий сайт

PUBLISH="${HERMES_SKILL_DIR}/scripts/publish.sh"
bash "$PUBLISH" {file-or-dir} --slug {slug} --client hermes

Скрипт автоматически загружает claimToken из .herenow/state.json при обновлении анонимных сайтов. Передайте --claim-token {token} для переопределения.

Для обновлений, прошедших проверку подлинности, требуется сохраненный ключ API.

Используйте диск

Используйте Диск, если пользователю нужно частное облачное хранилище для файлов агента: документов, контекста, памяти, планов, ресурсов, мультимедиа, исследований, кода и всего остального, что должно сохраняться без публикации на веб-сайте.

Каждая учетная запись, вошедшая в систему, имеет диск по умолчанию с именем «Мой диск».

DRIVE="${HERMES_SKILL_DIR}/scripts/drive.sh"
bash "$DRIVE" default
bash "$DRIVE" ls "My Drive"
bash "$DRIVE" put "My Drive" notes/today.md --from./notes/today.md
bash "$DRIVE" cat "My Drive" notes/today.md
bash "$DRIVE" share "My Drive" --perms write --prefix notes/ --ttl 7d

Используйте токены Диска с ограниченной областью действия для передачи обслуживания от агента к агенту. Если вы получили общий блок herenow_drive, используйте его токен в качестве Authorization: Bearer <token> для api_base, соблюдайте pathPrefix, если он присутствует, и сохраняйте ETags при записи. PathPrefix со значением null означает полный доступ к Диску. Если навык доступен, отдайте предпочтение «drive.sh»; в противном случае вызовите перечисленные операции API напрямую.

Хранилище ключей API

Скрипт публикации считывает ключ API из этих источников (выигрывает первое совпадение):

Флаг --api-key {key} (только CI/сценарии — избегайте интерактивного использования)
Переменная среды $HERENOW_API_KEY
Файл ~/.herenow/credentials (рекомендуется для агентов)

Чтобы сохранить ключ, запишите его в файл учетных данных:

mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials

ВАЖНО: Получив API-ключ, немедленно сохраните его — выполните команду выше самостоятельно. Не просите пользователя запустить его вручную. Избегайте передачи ключа через флаги CLI (например, --api-key) в интерактивных сеансах; файл учетных данных является предпочтительным методом хранения.

Никогда не передавайте учетные данные или локальные файлы состояния (~/.herenow/credentials, .herenow/state.json) в систему управления версиями.

Получение API-ключа

Чтобы перейти с анонимного (24 часа) на постоянный сайт:

Попросите пользователя указать адрес электронной почты.
Запросите одноразовый код входа:

curl -sS https://here.now/api/auth/agent/request-code \
  -H "content-type: application/json" \
  -d '{"email": "user@example.com"}'

Скажите пользователю: «Проверьте свой почтовый ящик на наличие кода входа отсюда.сейчас и вставьте его сюда».
Проверьте код и получите ключ API:

curl -sS https://here.now/api/auth/agent/verify-code \
  -H "content-type: application/json" \
  -d '{"email":"user@example.com","code":"ABCD-2345"}'

Сохраните возвращенный apiKey самостоятельно (не просите это сделать пользователя):

mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials

Файл состояния

После каждого создания/обновления сайта скрипт записывает файл .herenow/state.json в рабочий каталог:

{
  "publishes": {
    "bright-canvas-a7k2": {
      "siteUrl": "https://bright-canvas-a7k2.here.now/",
      "claimToken": "abc123",
      "claimUrl": "https://here.now/claim?slug=bright-canvas-a7k2&token=abc123",
      "expiresAt": "2026-02-18T01:00:00.000Z"
    }
  }
}

Прежде чем создавать или обновлять сайты, вы можете проверить этот файл, чтобы найти предыдущие пули. Считайте .herenow/state.json только внутренним кешем. Никогда не указывайте этот локальный путь к файлу как URL-адрес и никогда не используйте его в качестве источника достоверных данных для режима аутентификации, истечения срока действия или URL-адреса утверждения.

Что сказать пользователю

Для опубликованных сайтов:

Всегда предоставляйте доступ к siteUrl из текущего запуска скрипта. — Прочтите и следуйте строкам publish_result.* из сценария stderr, чтобы определить режим аутентификации.
Когда publish_result.auth_mode=authenticated: сообщите пользователю, что сайт постоянный и сохранен в его учетной записи. URL-адрес заявки не требуется. – Если publish_result.auth_mode=anonymous: сообщите пользователю, что срок действия сайта срок действия истекает через 24 часа. Поделитесь URL-адресом заявки (если publish_result.claim_url не пуст и начинается с https://), чтобы они могли сохранить его навсегда. Предупреждаем, что токены претензий возвращаются только один раз и не могут быть восстановлены. – Никогда не просите пользователя проверять .herenow/state.json на предмет URL-адресов утверждений или статуса аутентификации.

Для приводов:

– Не называйте файлы Диска общедоступными URL-адресами. – Сообщите пользователю, что содержимое Диска является конфиденциальным, если только к нему не предоставлен доступ с помощью токена с ограниченной областью действия. – При совместном доступе с другим агентом отдавайте предпочтение токену с ограниченной областью действия с узким pathPrefix и коротким сроком жизни.

параметры публикации.sh

Флаг	Описание
`--слизняк {слизняк}`	Обновите существующий сайт вместо создания
`--claim-token {токен}`	Переопределить токен утверждения для анонимных обновлений
`--title {текст}`	Название просмотра (сайты, не использующие HTML)
`--описание {текст}`	Описание программы просмотра
`--ttl {секунды}`	Установить срок действия (только для аутентификации)
`--клиент {имя}`	Имя агента для указания авторства (например, «Гермес»)
`--base-url {url}`	Базовый URL-адрес API (по умолчанию: `https://here.now`)
`--allow-nonherenow-base-url`	Разрешить отправку аутентификации на нестандартный `--base-url`
`--api-key {ключ}`	Переопределение ключа API (предпочитает файл учетных данных)
`--спа`	Включить маршрутизацию SPA (обслуживать index.html для неизвестных путей)
`--разветвляемый`	Разрешить другим создавать форк этого сайта

За пределами публикации.sh

Для операций с Диском используйте Drive.sh или Drive API. Для более широкого управления учетными записями и сайтами — удаление, метаданные, пароли, платежи, домены, дескрипторы, ссылки, переменные, прокси-маршруты, разветвление, дублирование и многое другое — см. текущую документацию:

→ https://here.now/docs

Полная документация: https://here.now/docs.