Related Work

Отдельная страница литературы: коллекция статей (поиск, Zotero, CSV), вопрос исследователя, кластеризация ответов и черновик Related Works. Результаты лежат в koi-structure/literature/; агент будится через Literature Inbox.

Как работает

Вход с главной рабочей области — пункт RelatedWork (открывает literature.html, можно с ?project=…).

Три источника коллекции:

Источник	Что делает
Найти	поиск (в т.ч. arXiv / настройки режима поиска) по ключевым словам
Zotero	подключение user id + API key, выбор коллекции
CSV	загрузка локальной таблицы статей

Дальше типичный цикл:

Собрать и отметить статьи слева.
Задать исследовательский вопрос в центре.
Запустить анализ (промпт / кластеризация) — агенты читают выбранные тексты относительно вопроса.
Смотреть кластеры, findings, черновик Related Works справа / в панелях.
История прогонов — в literature/index.json и по ссылке «Прошлые вопросы».

Мультиагентная кластеризация (скилл orchestrator): 3–4 агента-работника без пересечения статей → обмен суждениями о похожести → оркестратор собирает кластеры и черновик Related Work → критик и правщик → report.md и related_work.md в каталоге прогона.

Короткая очередь UI → Markdown Related Works: кнопка Related Work ставит задачу в .run/related-work-queue.json; скилл koi-related-work делает claim → пишет 2–5 абзацев только по фактам из промпта → answer возвращает текст на страницу.

Разбор одной статьи как графа утверждений (морфология) — соседний инструмент (morphology.html), часто из карточки статьи; к Related Work по коллекции не подменяет.

Как человек работает в интерфейсе

С workspace: клик RelatedWork в доке (или прямой URL). Выберите проект в селекте, если нужно.
Пустая коллекция: три кнопки Найти / Zotero / CSV. После загрузки — список, «Все» / «Сброс», «+» для добавления ещё.
Введите вопрос → «Промпт» (или связанный запуск кластеризации — по текущему UI сценарию). Настройте Inbox литературы один раз: скопировать bootstrap → чат ResearchOS Literature Inbox → «Inbox готов».
Пока агент работает — статус «Агент работает» / таймер. Появление отчёта и Related Works — в колонке insights / панелях просмотра.
Навигация по кластерам слева; настройки поиска (шестерёнка) — режим internet/library, ключи Zotero.
«←» к проекту возвращает в index.html.

Какие сценарии для агента подключаются

Сценарий (skill)	Роль
`literature-cluster-orchestrator`	Полный прогон: работники → таблица похожести → кластеры → Related Work + критик → файлы в `literature/<run_id>/`.
`koi-related-work`	Очередь из UI: короткий синтез Related Works в Markdown обратно на страницу.
Literature Inbox	`koi.related_work.inbox_cli`, wake `RELATED_WORK_WAKE` в `.run/logs/related-work-watch.log`.
Article morphology (внешний скилл / `morphology.html`)	Граф утверждений одной статьи со ссылками на места в тексте.

python -m koi.related_work.cli pending
python -m koi.related_work.cli claim <queue_id>
python -m koi.related_work.cli context <queue_id>
python -m koi.related_work.cli answer <queue_id> -f related-work.md
python -m koi.related_work.inbox_cli watch

Как устроено технически

Хранение прогонов

koi-structure/literature/
  index.json                 # история run_id
  <run_id>/                  # {query_hash}_{UTC}
    index.json
    report.md                # основной рендер в UI
    findings.json
    similarity.json
    related_work.draft.md
    related_work.md
    rw_critique.json
    workers/…

query_hash — отпечаток вопроса; run_id уникален на каждый запуск.

Клиент и очереди

Страница: web/literature.html + web/literature.js. Связь с проектом с главной: btn-related-work в web/app.js. Очередь Related Work: пакет koi/related_work/. Морфология: web/morphology.html (+ JS рядом).

Настройки RW в localStorage (koi-rw-settings): режим поиска, Zotero.

Ограничения

Без выбранных статей и вопроса кластеризация не стартует.
Related Works из очереди не выдумывает статьи — только материал промпта/кластеров.
PDF и полные тексты зависят от того, что удалось скачать/приложить к записи библиотеки.

Связанные страницы

Research Chat (тот же Inbox-паттерн, другая очередь)
База знаний
Обзор архитектуры
PaperDraft

Текст: content/related-work.md. Медиа: media/related-work-hero.*.