CLI
Добавьте локальный Office к своему агенту: установите, откройте пример и создавайте редактируемые, вычисляемые и проверяемые результаты.
Univer CLI — локальное Office-приложение на Univer Office SDK. Оно даёт вашему агенту команды и Skills для работы с Excel, Word и PowerPoint или создания электронных таблиц, документов, презентаций, реляционных таблиц и холстов. Результаты остаются на вашем компьютере.
Основной способ работы с Univer сейчас — CLI (Command-Line Interface, интерфейс командной строки), который заменяет прежний подход к интеграции агентов через MCP. Univer CLI предоставляет команду univer и Skills: агенты редактируют, проверяют и передают результаты через свои средства выполнения команд, а локальный Viewer позволяет просматривать и рецензировать их.
Установка и проба · Как работают Skills · Каталог Skills
Используйте привычного агента
Univer CLI можно использовать с этими агентами:
OpenCode · Claude Code · OpenClaw · Hermes · Codex · WorkBuddy · Kimi Work
Общий интерфейс — команда univer и инструкции для установленной версии. Хосты с Agent Skills загружают официальную Skill; агенты с исполнением команд могут вызывать CLI через свои инструменты. Карточки предпросмотра и другие возможности хоста описаны в проектах интеграции.
Увидеть первый результат
Используйте Node.js 24 или новее и установите в окружении агента:
npm install --global univer-cli@latestnpx skills add dream-num/skills -s univer-cli -guniver doctoruniver doctor проверяет локальную среду. Skill помогает агенту находить команды, загружать инструкции нужного продукта, проверять содержимое и передавать результат.
Открыть официальный пример
В новом пустом каталоге отправьте агенту:
Открой официальный пример через Univer CLI.Скачай https://univer.ai/cli-assets/hello.univer как hello.univer в текущий каталог.Перечисли содержимое, дай ссылку на локальный Viewer и объясни, что можно попробовать.Готовое содержимое позволяет сразу увидеть настоящие редакторы. Затем запросите изменения или попробуйте задачу создания ниже.
Skills: руководства для агентов
Skills объединяют описание модели содержимого, порядок редактирования, поиск Facade API и требования к проверке в руководства, которые может прочитать агент. Они помогают найти нужные возможности для задачи — от редактирования до проверки и передачи результата.
Точка обнаружения: Установленный в агенте Skill univer-cli помогает распознать задачи Office и загрузить полные инструкции из локального CLI.
Skills среды выполнения: Поставляются вместе с CLI и соответствуют командам и Facade API установленной версии. Сначала загрузите core, затем нужный продукт, а для встраивания и формул между разными объектами — соответствующую тему.
Загружайте инструкции под задачу
Обычно агент читает инструкции самостоятельно, но разработчик также может посмотреть их напрямую:
univer skills listuniver skills get coreuniver skills get sheetuniver skills path sheetlist выводит установленные Skills, get читает руководство, а path возвращает локальный каталог. Команда univer skills get core --full также включает справочные материалы и шаблоны. Нужные API можно найти с помощью univer api find и univer api show.
Каталог Skills
Нажмите на название, чтобы открыть руководство в исходном коде. Для реальных задач используйте версию, которую возвращает локальная команда univer skills get <name>.
| Skill | Когда использовать |
|---|---|
core | Общий процесс: понимание Unit и Worktree, поиск содержимого, редактирование, проверка и передача на ревью. |
sheet | Электронные таблицы (Sheet): данные, формулы, форматирование, диаграммы и проверка результатов. |
doc | Документы (Doc): абзацы, форматированный текст, таблицы, диаграммы и разметка страницы. |
slide | Презентации (Slide): слайды, фигуры, текст, изображения и визуальная проверка. |
base | Relational Table: таблицы, поля, записи и представления. |
board | Canvases: элементы холста, диаграммы и проверка расположения. |
embed | Встраивание: размещение содержимого одного Unit внутри другого и подключение источников данных диаграмм. |
cross-unit-formula | Формулы между объектами: чтение диапазонов Sheet или полей Relational Table для вычислений в ячейках Sheet или фигурах с формулами. |
Например, чтобы встроить таблицу в документ, загрузите core → doc + sheet → embed. Добавьте cross-unit-formula, если ячейка Sheet или фигура ссылается на данные другого объекта. Загружать все руководства заранее не нужно. После обновления CLI повторно загрузите core и Skills нужных продуктов и тем.
Что можно создавать
- От данных к результату: Очищайте таблицы, создавайте формулы, диаграммы и сводные таблицы, отчёты с колонтитулами или презентации по плану.
- Связанное содержимое: Один файл
.univerможет содержать разные типы материалов, соединённые формулами, ссылками диаграмм и встроенными блоками. - Проверка результата: Читайте реальную модель через Facade и используйте снимки и проверку макета презентаций для обнаружения переполнения, наложения и выхода текста за страницу.
- Проверка до передачи: Агент работает в изолированном Worktree и возвращает ссылку на локальный Viewer. Изучайте различия, запрашивайте исправления, объединяйте или отклоняйте изменения и экспортируйте поддерживаемые Office-форматы. Импорт и экспорт файлов холста пока недоступны.
Попробуйте такую задачу
Через Univer CLI создай месячную таблицу расходов с датой, категорией, суммой и пятью строками примера. Добавь формулу итога и диаграмму по категориям. Проверь данные и отображение, дай ссылку Viewer и не объединяй изменения до моей проверки.
Роль Office SDK
Office SDK предоставляет Headless-среду, Facade API, расчёты, рендеринг, версии и Worktree. CLI объединяет их в команды и согласованные с версией Skills, управляя локальными .univer, Gateway и Viewer. Содержимое, созданное агентом, можно просмотреть в редакторе и передать в стандартном формате.
Попробовать и изучить исходный код
Связанные возможности
Насколько полезно это руководство?