История сессий Harness

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end --> Tesserae может импортировать локальные transcript AI-agent и отображать их как память проекта в разделе sessions/ статического сайта.

Эта функция намеренно отделена от export-agent-harness:

• export-agent-harness — исходящий контекст для инструментов вроде Claude Code, Codex, Gemini, Cursor, Kiro и OpenCode.
• project sessions ... — входящая история: она нормализует предыдущие сессии Claude Code/Codex для текущего проекта, сохраняет их в .tesserae/harness_sessions/ и позволяет project build-site публиковать страницы index/detail сессий.

Модель приватности

Импорт сессий выполняется явно. Обычный project compile или project build-site читает уже нормализованные сессии из .tesserae/harness_sessions/, но не выполняет неожиданное scrape приватных каталогов harness transcript.

Импортированные записи сессий — локальные артефакты проекта. Проверьте их перед публикацией публичного сайта, особенно если transcript могут содержать secrets, приватные пути, данные клиентов или не выпущенный код.

Обнаружение и импорт локальных сессий

Из корня проекта:

tesserae project sessions discover --import

Discovery сканирует локальные корни transcript Claude Code и Codex, относящиеся к рабочей директории текущего проекта. Используйте --root, чтобы сканировать конкретный config-каталог, и повторяйте --harness, чтобы ограничить discovery:

tesserae project sessions discover \
  --root ~/.claude \
  --root ~/.codex \
  --harness claude-code \
  --harness codex \
  --import

Без --import discovery печатает найденное, не записывая нормализованные записи сессий.

Прямой импорт нормализованного JSON

Если другой инструмент уже создал нормализованный JSON HarnessSession, импортируйте один файл или список файлов:

tesserae project sessions import path/to/session.json path/to/more-sessions.json

Каждый вход может содержать один объект сессии или список объектов сессий.

Список импортированных сессий

tesserae project sessions list

Сессии хранятся здесь:

.tesserae/harness_sessions/
  manifest.json
  <harness>/
    <session>.json
    <session>.md

Сборка статических страниц сессий

После импорта сессий пересоберите сайт:

tesserae project build-site

Сайт создаёт:

.tesserae/site/sessions/index.html
.tesserae/site/sessions/<project>/<session>.html

Сгенерированный сайт ссылается на Sessions из global rail, карточек Browse на главной, поисковых записей и breadcrumb trail каждой страницы detail сессии.

Макет страницы detail сессии

Страницы detail сессий используют общий static-site shell, а не отдельный transcript dump. Они включают:

• hero и stat strip;
• high-level summary;
• timeline и size metadata;
• decisions, files, commands, tools и errors, если есть;
• свёрнутое subagent tree;
• user/assistant conversation по turn;
• свёрнутые tool-use blocks, прикреплённые под предыдущим assistant turn;
• левый conversation rail со ссылками на anchors #turn-N.

Markdown разговора рендерится через site markdown renderer. Семантические поверхности вроде inline code, явной command/tag markup, paths, filenames и hashtags оформляются как компактные chips; случайные существительные с заглавной буквы не chip-ятся автоматически.

Текущая transcript typography:

Чеклист публикации сессий

Перед деплоем публичного сайта с сессиями:

1. Запустите tesserae project sessions list и подтвердите ожидаемое количество.
2. Проверьте .tesserae/harness_sessions/ на чувствительное содержимое.
3. Пересоберите через tesserae project build-site.
4. Локально откройте sessions/index.html и хотя бы одну страницу detail сессии.
5. Убедитесь, что tool blocks свёрнуты по умолчанию и raw tool payloads допустимы к публикации.
6. После commit исходного дерева выполните деплой через tesserae project deploy --build.