Установка F1

Что именно устанавливается, как скачать сборку, сверить контрольную сумму, подпись и нотаризацию, где найти процессор.

Что именно устанавливается

F1 — табличный редактор. Внутри установленного приложения находится Rust-процессор compute_contract_cli. Он принимает JSON-запросы, держит открытую книгу в памяти текущего процесса и возвращает JSON-ответы.

Объект	Роль	Граница
F1.app	Пользовательский интерфейс табличного редактора	Открытие и редактирование книг человеком
`compute_contract_cli`	Контракт операций в ядре на Rust	Открытие, чтение, изменение, история, вычисление и сохранение
`subsetId`	Идентификатор открытого сеанса книги	Живёт только внутри одного процесса программы командной строки
`sheetKey`	Стабильный ключ листа	Берётся из activeSheet.path; не заменять именем листа
`viewport`	Окно просмотра: наружу уходит только видимый участок листа	Книга не разворачивается в память целиком
`result.xlsx`	Физический OOXML-пакет	Результат save_workbook_subset

Сильная сторона

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

Ограничение

Это процессный API, а не HTTP API. Браузер не может запускать локальный бинарный файл напрямую. Для сервера или Web UI поверх него нужен контролируемый service host; схема — на странице Интеграция в приложение.

В каталоге релиза имя файла содержит номер версии, собранный по схеме «год.квартал.патч.сборка»: F1-<год>.<квартал>.<патч>.<сборка>-mac-arm64.zip и так же для остальных систем. Точный номер берите из каталога релиза — в командах ниже он заменён многоточием или подстановкой, чтобы их можно было выполнить как есть, не сверяя цифры.

Установленная версия видна в самом приложении: меню F1 → О F1. Каталог установки от номера версии не зависит, поэтому пути в примерах остаются верными и после обновления.

Скачать F1

Откройте каталог релиза. В браузере откройте dl.plantype.ru.
Выберите пакет под свою систему.

Файл вида F1-…-mac-arm64.zip для компьютеров на Apple Silicon и F1-…-mac-x64.zip для Mac на процессоре Intel.

Файл вида F1-…-x64-setup.exe — обычный установщик.

Файл F1-….deb для Debian и Ubuntu, F1-….rpm для Fedora и RHEL, либо F1-….AppImage, который работает без установки.

Скачайте список контрольных сумм. В том же каталоге лежат файлы latest.yml, latest-mac.yml и latest-linux.yml — в них указаны суммы sha512 для каждой сборки, в кодировке base64.

То же одной командой

mkdir -p ~/Downloads/f1-first-run
cd ~/Downloads/f1-first-run

base=https://dl.plantype.ru/f1/release/latest
curl -fsSLO $base/latest-mac.yml
# имя файла с номером версии берём из того же списка
curl -fLO $base/$(awk '/mac-arm64.zip/ {print $3; exit}' latest-mac.yml)

mkdir $HOME\Downloads\f1-first-run -Force
cd $HOME\\Downloads\\f1-first-run

$base = "https://dl.plantype.ru/f1/release/latest"
Invoke-WebRequest "$base/latest.yml" -OutFile latest.yml
# имя файла с номером версии берём из того же списка
$name = (Select-String -Path latest.yml -Pattern 'x64-setup\.exe').Line.Trim().Split(' ')[-1]
Invoke-WebRequest "$base/$name" -OutFile $name

mkdir -p ~/Downloads/f1-first-run
cd ~/Downloads/f1-first-run

base=https://dl.plantype.ru/f1/release/latest
curl -fsSLO $base/latest-linux.yml
# имя файла с номером версии берём из того же списка
curl -fLO $base/$(awk '/amd64.deb/ {print $3; exit}' latest-linux.yml)

Проверка контрольной суммы

cd ~/Downloads/f1-first-run
# суммы лежат в latest-mac.yml рядом со сборкой, в виде sha512
curl -fsSLO https://dl.plantype.ru/f1/release/latest/latest-mac.yml
openssl dgst -sha512 -binary F1-*-mac-arm64.zip | base64
grep -A1 'mac-arm64.zip' latest-mac.yml

cd $HOME\Downloads\f1-first-run
# суммы лежат в latest.yml рядом со сборкой, в виде sha512
$yml = Invoke-WebRequest `
  "https://dl.plantype.ru/f1/release/latest/latest.yml" -UseBasicParsing
$hex = (Get-FileHash .\F1-*-setup.exe -Algorithm SHA512).Hash
$b64 = [Convert]::ToBase64String(($hex -split '(..)' -ne '' | ForEach-Object { [byte]('0x' + $_) }))
$yml.Content -split "`n" | Select-String -Pattern $b64

Строка найдена — сумма совпала.

cd ~/Downloads/f1-first-run
# суммы лежат в latest-linux.yml рядом со сборкой, в виде sha512
curl -fsSLO https://dl.plantype.ru/f1/release/latest/latest-linux.yml
openssl dgst -sha512 -binary F1-*-amd64.deb | base64
grep -A1 'amd64.deb' latest-linux.yml

Установить и проверить F1

Распаковка

cd ~/Downloads/f1-first-run
mkdir -p unpacked
ditto -x -k F1-*-mac-*.zip unpacked
ditto unpacked/F1.app ~/Applications/F1.app

Запустите скачанный F1-…-setup.exe и пройдите установщик. Установка идёт на всю машину, поэтому потребуются права администратора. Каталог по умолчанию — C:\Program Files\F1, в самом установщике его можно изменить.

cd ~/Downloads/f1-first-run

# Debian, Ubuntu и производные
sudo apt install ./F1-*.deb

# Fedora, RHEL и производные
sudo dnf install ./F1-*.rpm

Пакет ставится в /opt/F1.

Проверка подписи и нотариального заверения

Подписано и заверено у Apple само приложение F1.app — оно лежит в архиве .zip. Образ .dmg из того же каталога подписи не несёт, и система его отклоняет. Проверки ниже рассчитаны на приложение из архива.

В сертификате стоит имя юридического лица, а не название продукта: Developer ID Application: HEALTH INFORMATIC SECURITY SYSTEM SL (K58GV7E7X4). Так и должно быть — сверяйте с этим идентификатором команды.

На Windows издатель другой: установщик подписан сертификатом на FastOffice, выпущенным DigiCert. Это имя и покажет система при запуске.

APP="$HOME/Applications/F1.app"
codesign --verify --deep --strict --verbose=2 "$APP"
spctl -a -vv "$APP"

Ожидается успешная проверка codesign и строка accepted с Notarized Developer ID от spctl.

Get-AuthenticodeSignature "C:\Program Files\F1\F1.exe" |
  Format-List Status, SignerCertificate

Ожидается Status: Valid. Значение NotSigned означает, что файл получен не из каталога релиза — такой пакет запускать не нужно.

Целостность пакета проверяет менеджер пакетов при установке: apt и dnf отвергнут пакет с испорченным содержимым. Отдельной команды не требуется — достаточно сверки контрольной суммы на предыдущем шаге.

Рядом с пакетом .deb лежит отделённая подпись — файл .asc; у пакета .rpm её в каталоге выпуска нет. Открытый ключ к ней в каталоге выпуска F1 пока не публикуется, поэтому проверить происхождение файла этой подписью нельзя: сверяйте контрольную сумму из latest*.yml, а если проверка подписи обязательна по вашим правилам, запросите ключ у нас.

Ожидается успешная проверка codesign и строка accepted / Notarized Developer ID от spctl.

Первый запуск интерфейса

open ~/Applications/F1.app

/opt/F1/f1

Откройте любую XLSX-книгу и убедитесь, что видна сетка. После этого F1 можно закрыть: следующий раздел использует встроенный Rust-процессор напрямую.

Найти процессор

F1_CLI="$HOME/Applications/F1.app/Contents/Resources/runtime/native/compute_contract_cli"
file "$F1_CLI"
test -x "$F1_CLI" && echo "процессор готов"

$F1_CLI = "C:\Program Files\F1\resources\runtime\native\compute_contract_cli.exe"
Test-Path $F1_CLI

Ответ True означает, что процессор на месте.

F1_CLI="/opt/F1/resources/runtime/native/compute_contract_cli"
file "$F1_CLI"
test -x "$F1_CLI" && echo "процессор готов"

Что дальше

Процессор установлен — дальше четыре пути:

Проверить, что API отвечает. Быстрый старт: открыть книгу, записать значение и формулу, сохранить результат.
Понять устройство сеанса. Как устроен сеанс API: транспорт, состав ответа и обработка отказов.
Посмотреть разбор вызовов. Запросы из примера — что именно отправляется на каждом шаге.
Увидеть готовый код. Примеры — двадцать три маленьких проекта, каждый показан целиком.

Если что-то не запускается — диагностика.