AI SDK

Univer Office SDK включает Web SDK для встроенных редакторов и обработки контента без интерфейса, Server SDK для совместной работы и импорта и экспорта файлов, а также AI SDK для рабочих процессов агентов.

AI SDK — TypeScript SDK для создания CLI Office. Он предоставляет AI Agent и автоматизации точку входа Node.js для загрузки, понимания, изменения и проверки Units¹ Univer.

AI SDK — набор сочетаемых возможностей, а не фиксированная продуктовая CLI. Имена команд, аргументы, цели, идентификацию и авторизацию, вывод и развёртывание определяет бизнес-приложение.

Рекомендуемая структура приложения

Руководство использует схему CLI + Web + Server:

• CLI — точка входа для AI Agent или пользователя, работающего с Unit.
• Web показывает настоящую страницу для интерактивного редактирования и проверки человеком.
• Server хранит Units, ревизии и состояние совместной работы, общие для CLI и Web.

Компоненты можно развернуть отдельно или полностью локально. Создание Web + Server с Collaboration SDK до добавления CLI — рекомендуемый порядок обучения, не ограничение развёртывания.

Организация CLI через Commander

Базовые пакеты предоставляют структурированные TypeScript API. Пресеты превращают общие возможности в нативные объекты Commander Command. Корневой программой всегда владеет бизнес-приложение:

import { Command } from "commander";const program = new Command("my-cli");program.addCommand(presetCommand);program.addCommand(applicationCommand);await program.parseAsync();

• Пресет команды задаёт стандартные аргументы, справку и текстовый или JSON-вывод.
• Команда приложения сочетает Runtime², бизнес-цели, личность, политику фиксации или файлов.
• Оба варианта — обычные Commander Command, их можно смешивать в одной корневой программе.

Каждая следующая тема сначала описывает базовую возможность, затем подключение к Commander.

Постепенное добавление возможностей

Руководство начинает с основных операций Unit, затем добавляет файлы, визуальную проверку, совместную работу и процессы:

загрузка и редактирование Unit→ импорт и экспорт файлов Office→ визуальная проверка→ изолированное редактирование и проверка Worktree→ повторное использование Runtime и Daemon

1. Загрузка и редактирование Unit

Создайте минимальный цикл AI Agent: загрузите Unit через Collaboration Runtime, изучите через Inspection, выполните код Univer Facade и при необходимости найдите API Facade.

2. Подключение границы файлов Office

Используйте Exchange для преобразования между файлами Office и UnitData. Импортированные Units остаются в Collaboration Server; экспорт сначала получает актуальные UnitData через Collaboration Runtime.

3. Визуальная проверка

Структурированный вывод не описывает макет полностью. Screenshot даёт AI Agent отрисованные изображения, а Layout Lint — структурированную диагностику расположения.

4. Изоляция изменений через Worktree

AI Agent может несколько раз редактировать и проверять черновик Worktree. Когда он готов, человек проверяет его в Web и выбирает Merge или Reopen.

5. Повторное использование дорогих сред

Начните с краткоживущих Runtime. Добавляйте пул, workers или daemon только когда важны стоимость запуска, параллелизм или повторное использование между процессами CLI.

Рекомендуемый порядок чтения

1. Загрузка документов и операции с содержимым
2. Импорт и экспорт Office
3. Визуальная проверка
4. Worktree: редактирование AI Agent и проверка человеком
5. Повторное использование Runtime и Daemon
6. Каталог пакетов
7. Примеры