Начало работы

Создайте первое Office-приложение с агентом для программирования, затем подключите его к своей системе и разверните.

На этой странице представлены три рабочих примера: электронная таблица, связанная с входами страниц, настройка совместной работы с документами от двух человек и CLI, который может работать агент. Выберите один пример, дайте его вашему агенту кодирования, а затем выполните шаги интеграции и развертывания.

Выберите первое приложение

Office SDK охватывает листы, документы, слайды, реляционные таблицы, холсты и PDF-файлы. Определите путь интеграции, который соответствует вашей цели приложения:

Ваша цельС чего начатьПервый критерий успеха
Встроить Office-редакторУстановка Web SDKСоздать содержимое, изменить, сохранить и снова открыть его.
Связать содержимое с бизнес-интерфейсомFacade APIСвяжите входные данные страницы и ячейки в обоих направлениях и покажите реальные результаты расчета.
Добавить совместное редактированиеБыстрый старт Server SDKДва независимых сеанса редактируют одно содержимое и получают изменения друг друга.
Импортировать, обрабатывать и экспортировать Office-файлыКонвертация файловИмпортировать реальный файл, изменить, экспортировать и проверить результат.
Дать агенту или CLI работать с содержимымОперации AI SDKЗагрузить содержимое, проверить структуру, изменить и проверить фиксацию или вывод.
Создать пространство для людей и агентовWorktree и рецензированиеДержите изменения агента в изолированном черновике, чтобы человек мог сравнить, рассмотреть и объединить их.

Особенности перечисляет, что поддерживает каждый продукт; в трех примерах ниже представлен один полный рабочий процесс от начала до конца.

Начните с агентом

Дайте своему агенту требования и ссылку на индекс документации llms.txt. Вам не нужно копировать всю документацию SDK в подсказку. Начните с шаблона многоразового использования ниже или вставьте один из трех полных примеров.

Шаблон запроса

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

text
Создай локально запускаемое <название приложения> с Univer Office SDK.Сначала прочитай https://docs.univer.ai/ru-RU/llms.txt и полные примеры по теме.Используй одну версию всех пакетов SDK.Начальное содержимое: <немного готовых к редактированию данных или текста>.Основной эффект: <одно действие пользователя и сразу видимый результат>.Критерии приёмки: <два-три конкретных результата для проверки действиями>.Реализуй только этот сценарий с родным редактором Univer и настоящим SDK.Запусти приложение, проверь его в браузере и дай ссылку на предпросмотр.Укажи, какие обязательные настройки отсутствуют, если они нужны.
Необязательно: установить Skill для разработки приложения

Если ваш кодирующий агент поддерживает Skills, установите build-with-univer, чтобы он мог самостоятельно ознакомиться с документацией SDK и определить, как Web SDK , Server SDK и AI SDK вписываются в ваше приложение.

Bash
npx skills add dream-num/skills --skill build-with-univer

Запустите команду в проекте, которую открыл ваш агент. Подтвердите установку npx skills list, затем используйте шаблон выше или один из примеров ниже. Следуйте текущей документации и версиям SDK, которые фактически использует ваш проект.

Пример 1: связь таблицы с интерфейсом

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

text
Создай локальную одностраничную форму расчёта стоимости с Univer Office SDK.Прочитай https://docs.univer.ai/ru-RU/llms.txt и полные примеры по теме.Используй одну версию всех пакетов SDK.Встрой редактируемую таблицу с базовым пресетом Sheets.Подготовь 2 монитора по 1200, 5 клавиатур по 300 и 3 гарнитуры по 200.Суммы строк и итог рассчитай формулами таблицы.Рядом размести поле количества мониторов и карточку общей суммы.Свяжи поле с ячейкой в обе стороны. Карточка читает настоящий результат формулы;не рассчитывай сумму повторно в коде страницы. Добавь сохранение в браузереи восстановление при обновлении страницы.Проверь: начальная сумма 4500, при количестве 3 — 5700; изменение ячейкиобновляет поле и карточку; сохранение и обновление восстанавливают изменения.Реализуй только эти функции, проверь работающее приложениеи дай ссылку на предпросмотр.

Попробуй: Изменить количество монитора с 2 до 3, а общее идет с 4500 до 5700. Редактирование листа также напрямую обновляет страницу. После сохранения и обновления данные восстанавливаются. Продолжайте с Установка Web SDK и Фасад APIs.

Пример 2: совместное редактирование документа

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

text
Создай локальное демо совместного редактирования для двух человек с Univer Office SDK.Прочитай https://docs.univer.ai/ru-RU/llms.txt и актуальные примеры изhttps://github.com/dream-num/univer-collaboration-examples.Версии SDK на клиенте и сервере должны совпадать.Размести рядом родные редакторы современных документов для Alice и Bob.Используй независимые среды и онлайн-сеансы с настоящим сервисом совместной работыServer SDK. По официальному примеру явно загрузи один документ, созданный сервером.Добавь несколько коротких предложений.Ввод слева появляется справа и наоборот через протокол совместной работы SDK.Используй двух фиксированных пользователей, хранение в памяти и один локальный сервисдля клиента и сервера. Не добавляй вход, управление файлами или ИИ-чат.Читай Pro License из окружения; без неё сохрани стандартное поведение и сообщения SDK.Проверь совпадение текста после ввода с обеих сторон, фиксацию изменений сервероми восстановление после обновления страницы. Объясни сброс памяти при перезапуске сервиса.Реализуй только эти функции, проверь работающее приложениеи дай ссылку на предпросмотр.

Попробуй: Введите предложение слева, затем продолжайте вводить справа. Обе стороны получают обновления. Обновите страницу, и текст останется. Эта демо-версия хранит все данные в памяти, поэтому сервисный перезапуск очищает ее; подключите постоянную базу данных перед развертыванием. Продолжайте с Сотрудничество Server SDK быстрое.

Пример 3: создайте собственный you-cli

Создайте свой собственный инструментарий Office и предоставьте его агенту, которого вы уже используете. Инструментарий должен охватывать лист, док, слайд, реляционный стол и холсты, но начните с одного документа, чтобы попробовать рабочий процесс «генерировать → предварительный просмотр → пересмотреть через разговор».

text
Создай локальный для проекта you-cli и Web-предпросмотр с Univer Office SDK.Прочитай https://docs.univer.ai/ru-RU/llms.txt и полные примеры работы с содержимым:https://github.com/dream-num/univer-cli-examples.Согласуй версии frontend, сервера и AI SDK; сверяй API с установленными типами.Поддержи Sheet, Doc, Slide, Relational Table, Canvases; начни с Doc.Добавь ./you-cli create <type> --name <name>, inspect --unit <id>,execute --unit <id> --file <path>, open --unit <id> и --help.Оставь инструмент в проекте и дай текущему агенту инструкции или Skill для чтения.Возвращай JSON с соответствующими unitId, типом, результатом фиксации и URL.CLI и Web работают с одним настоящим совместным документом и открытым родным редактором.Дождись подтверждения записи, прочитай результат и сохраняй содержимое и каталог постоянно.open возвращает URL; агент открывает его в панели предпросмотра, если среда это поддерживает.Язык понимает текущий агент. Лицензии читай из окружения, сохраняя необходимые сообщения.Проверь в диалоге: создать недельный отчёт и открыть предпросмотр;добавить риск и ответственного в тот же unitId с обновлением открытого предпросмотра.После обновления страницы и перезапуска данные должны восстанавливаться. Проверь это,дай ссылку и инструкции. Запускай только сервис этого примера.

Использование через диалог

После того, как инструмент существует и агент прочитал инструкции по проекту, введите следующее в том же разговоре:

text
Создай через you-cli недельный отчёт с прогрессом, рисками и планами.Открой его Web-предпросмотр.

После того, как вы просмотрели результат, продолжайте:

text
Добавь в тот же отчёт риск задержки поставки и назначь ответственной Alice.Обнови уже открытый предпросмотр.

Агент повторно использует unitId того же документа.Если хост предоставляет панель предварительного просмотра, страница появляется рядом с разговором; другие среды используют обратную ссылку браузера.

Справочник команд you-cli

Ниже приведены проектно-локальные команды, которые указывает подсказка. Замените UNIT_ID на unitId, который возвращает create. Агент пишет edit.js с помощью API Facade.

ДействиеКомандаРезультат
Создать./you-cli create doc --name "Недельный отчёт"Создаёт документ и возвращает unitId; другие типы: sheet, slide, base, board.
Проверить./you-cli inspect --unit UNIT_IDПрочитайте реальный контент и текущий обзор.
Изменить./you-cli execute --unit UNIT_ID --file edit.jsВыполните изменения, дождитесь совершения и верните результат.
Показать./you-cli open --unit UNIT_IDВозвращает Web-URL того же документа, который открывает агент.

./you-cli --help печатает полный интерфейс. Для API, стоящих за этими командами, см. Содержание AI SDK и полный Примеры CLI SDK.

Подключите первый сценарий к приложению

Web SDK обеспечивает совместное время выполнения контента. Добавить Server SDK, когда несколько человек должны редактировать вместе, и AI SDK когда агент должен управлять контентом. См. Обзор Office SDK для роли каждого пакета.

ШагЧто подключить в приложенииПодробнее
Встроить редакторСоберите предустановленный набор, подключите деловые взаимодействия через API Facade, сохраните снимки и удалите экземпляры.Интеграция Web SDK
Подключить серверПовторное использование существующих идентификаторов и разрешений, настройка базы данных для общих документов и добавление импорта и экспорта файлов по мере необходимости.Совместная работа, конвертация
Подключить агентаЭкспонировать операции с контентом, вычисления и проверки в качестве инструментов или CLI; добавить Worktree, когда требуется обзор.Операции AI SDK, Worktree

Архитектура приложения

Ваше приложение и агент, которым вы уже управляете, могут работать на одном и том же контенте Office. Интерфейс обрабатывает взаимодействие, агент вызывает инструменты, а ваш бэкэнд сохраняет право собственности на личность, разрешения и хранилище.

Синие узлы поставляются и управляются вами: ваш интерфейс, ваш существующий агент, бизнес-API с идентификатором и разрешениями, база данных и хранилище файлов. Узлы, помеченные SDK, - это возможности Univer, которые вы интегрируете в приложение.

100%

Если вы встраиваете только редактор, достаточно локальных снимков; для совместного редактирования требуется бэкэнд. Сохраните модель и оркестровку, которые уже использует ваш агент, позвольте AI SDK обрабатывать операции с контентом и добавьте Worktree, когда вам нужны отдельные изменения, сравнение и обзор.

Сборка и развёртывание на примере Workspace

Рабочее пространство Univer объединяет все три SDK в полном рабочем пространстве офиса. Запустите следующие команды из корня репозитория Workspace и следуйте его ЧИТАТЬ для предварительных условий.

  1. Развивайте локально. Установите зависимости, запустите pnpm workspace:dev:server и pnpm workspace:dev:web в двух отдельных терминалах и откройте http://127.0.0.1:5173. Прокси-сервер веб-разработки API и запросы WebSocket на бэкэнд.
  2. Сборка и запуск. Соберите только приложение Workspace и запустите production-вход:
Bash
pnpm --filter @univerjs/univer-workspace buildpnpm workspace:start

Сборка размещает веб-активы в dist/public и серверный код в dist/server; один процесс Node.js обслуживает как статические страницы, так и API.

  1. Подготовьте развертывание. Настройка лицензий, идентификационных данных и каталогов данных. Сохраняйте данные о продукте, данные о совместной работе и загруженные активы, затем перезапустите сервис и подтвердите, что данные восстановлены. См. Развертывание Docker и архитектура.

Когда одного процесса уже недостаточно, Руководство по развертыванию Server SDK объясняет, как разделить услуги.

Другие открытые проекты

  • Univer CLI: Создавайте, редактируйте и проверяйте контент Office от агента или терминала в локальном рабочем пространстве, а затем просматривайте изменения в Viewer.
  • DeepSeek Harness: Добавьте инструменты Office, предварительные просмотры в реальном времени и черновик обзора к разговору, который уже есть у вашего агента.

Все примеры собирает демо-версии проекта и ссылки на их репозитории.

Насколько полезно это руководство?

© 2026 DreamNum Co., Ltd.