Клинические тексты и гранты: приватность, отслеживаемые черновики и LaTeX офлайн
Почему авторам медицинских, общественно-медицинских и грантовых текстов важно, где хранится черновик, и как локальный исследовательский редактор с настоящим Git, офлайн-компиляцией и без учётной записи вписывается в циклы проверки.
Клинические рукописи и тексты грантовых заявок часто содержат чувствительные подробности ещё до того, как деидентификация завершена. Отправлять каждое нажатие клавиши на сторонний редактор — решение в области политики не меньше, чем предпочтение в инструментах. Этическим комитетам (IRB), соглашениям об использовании данных и ИТ-отделам больниц безразлично, что облачный редактор был удобен в 11 вечера.
Эта заметка о том, как писать и верстать так, чтобы это можно было объяснить службе комплаенса. Считайте её советом по организации работы, а не юридической экспертизой.
Обычные файлы проще объяснить
Папка с файлами .tex и рисунками может лежать на зашифрованном диске, в образе больничного ноутбука или на изолированной от сети машине. Службе комплаенса можно указать путь. Проекты в браузере требуют доверять модели доступа поставщика, пути экспорта и списку субобработчиков данных.
Oleafly (откроется в новой вкладке) устроен так намеренно: без учётной записи, без телеметрии продукта, проекты — обычные папки с настоящим репозиторием Git. Страница о приватности короткая, потому что документу для существования не нужен сервер Oleafly. Сеть используется для действий, которые вы запускаете сами (пакеты, необязательный поиск цитат, облачный ИИ, если вы его включили, GitHub), а не для каждого нажатия клавиши в черновике.
Если политика запрещает облачный ИИ, оставьте ассистента выключенным или направьте его на локальную модель. Редактор, цикл компиляции и Git продолжают работать.
Отслеживание изменений без жизни в Word
Руководители грантов (PI) по-прежнему просят «режим исправлений». В мире LaTeX это обычно означает историю Git плюс комментарии соавторов в PDF или короткий экспорт в Word для человека, который отказывается что-либо устанавливать. Держите .tex источником истины; см. соавторы, которые знают только Word.
В Oleafly каждый проект с первого дня — репозиторий Git: автоматические контрольные точки после успешных компиляций и пауз в правках, сравнение версий бок о бок, восстановление в один клик, GitHub по желанию, если нужен закрытый удалённый репозиторий. Можно создать ответвление всего пакета заявки в виде второго проекта (с полной историей), чтобы опробовать рискованное сокращение, не трогая копию, готовую к отправке. Если вы пользуетесь необязательным ИИ-ассистентом, он создаёт контрольную точку перед первой правкой и вносит изменения только через сравнение с подтверждением.
Называйте коммиты по целям или разделам (aim2-methods-cut), чтобы PI мог просмотреть историю, не читая диффы, как программист.
Офлайн полезен в больницах
Клинические сети блокируют случайные SaaS-домены. Локальный компилятор позволяет продолжать писать в промежутках между сеансами работы с электронной медицинской картой (EHR). Oleafly поставляет Tectonic (и Typst) внутри приложения; пакеты кэшируются после первого использования, а офлайн-режим может запретить компилятору обращаться к сети. Проверка орфографии и грамматики работает локально по обычному тексту (команды и формулы она пропускает). Именно эти ограничения обычно волнуют ИТ больницы, поэтому разговор о локальных исследовательских редакторах возникает часто.
SyncTeX и PDF рядом с исходником важны, когда вы подгоняете объём под лимит страниц за компьютером на посту медсестёр с ненадёжным Wi‑Fi.
Шаблоны, лимиты страниц и предпроверка
Шаблоны в стиле NIH и фондов — это поля, шрифты и ограничения на число страниц. Пакеты геометрии и шрифтов важнее хитрых макросов. Компилируйте в PDF и проверяйте число страниц после каждого крупного сокращения, а не в ночь перед закрытием портала. Начните с известного шаблона из галереи, если подходящий есть; но всё равно сверяйтесь с текущим объявлением о конкурсе (FOA) по шрифтам, полям и структуре (если Specific Aims занимает одну страницу, значит, ровно одну).
Когда PDF должен пройти через машинное чтение (резюме, некоторые институциональные порталы), Предпроверка до отправки показывает структуру и результаты извлечения текста так, как это делает парсер. Это эвристические сигналы риска, которые можно прочитать и по которым можно действовать.
Совместная работа нескольких PI
Закрепляйте файлы за людьми по разделам или целям. Один человек отвечает за главный .bib или общий экспорт групповой библиотеки Zotero. Договоритесь, правят ли соавторы TeX или возвращают комментарии в PDF. Закрытые удалённые репозитории — только на одобренных институциональных серверах Git, если этого требует политика; не всякому черновику заявки место на публичном GitHub.
Менеджеры библиографии
Общие группы Zotero экспортируют .bib, который могут обновлять несколько PI. Импортируйте его в проект, вставляйте DOI при добавлении новых цитат и проверяйте недостающие поля до отправки, чтобы годы не превращались в [?] в собранном PDF: проверка BibTeX. Oleafly дополняет и проверяет ключи цитирования по библиографии проекта, пока вы пишете, поэтому неверные ключи \cite выявляются раньше, чем в журнале.
Рисунки и защищённые данные пациентов (PHI)
Никогда не помещайте данные, позволяющие опознать пациента, в рисунки или подписи, которые попадут в репозиторий, доступный другим для клонирования. Используйте деидентифицированные схемы. Всё, что остаётся чувствительным, храните под теми же мерами защиты, что и клинический набор данных, а не рядом с публичной схемой методов.
Чем это не является
Подход local-first по-прежнему подчиняется одобрению IRB, соглашениям об использовании данных и деидентификации. Включите облачный ИИ или отправьте проект на удалённый репозиторий, и часть байтов покинет компьютер на условиях политик этих сервисов. Local-first меняет путь по умолчанию для работы над чувствительным текстом: папка под вашим контролем, редактор, работающий офлайн, и история, которую можно восстановить, не обращаясь к поставщику за экспортом.
Практическая начальная настройка
- Создайте локальный проект; включите офлайн-компиляцию, когда пакеты закэшированы.
- Оставьте ИИ выключенным, пока политика и команда не согласуют провайдера.
- Закрытый удалённый репозиторий только на одобренном сервере.
- Распределение разделов между авторами и один ответственный за библиографию.
- Проверка числа страниц после каждого крупного сокращения в целях и стратегии исследования.
Пишите так, будто сотрудник комплаенса спросит, где жил черновик. Если ответ звучит как «папка на зашифрованном ноутбуке, история Git локально, закрытый удалённый репозиторий по желанию», вы в лучшей форме, чем при ответе «учётная запись в сервисе, который мы никогда не проверяли».