dream-num/dsh-univer-office

Give DeepSeek Harness the ability to create, edit, inspect, and deliver spreadsheets, documents, presentations, databases, and canvases.

English · 简体中文

dsh-univer-office is the Univer office plugin for DeepSeek Harness (DSH). Tell the agent what you need and it can create or edit spreadsheets, documents, presentations, multidimensional tables, and canvases, or work with existing Excel, Word, and PowerPoint files. Every change is verified and stays in the conversation for you to preview, approve, or discard.

After installation, describe the result you want in natural language. The agent handles creation, editing, and verification while you follow the work live and review the result in the conversation. Deliver spreadsheets as Excel (.xlsx), documents as Word (.docx), and presentations as PowerPoint (.pptx) files when needed.

See it in action

The agent created this spreadsheet from a natural-language request, then added conditional formatting and a chart in the same conversation. The result can be previewed, revised, merged into the current version, or discarded in place.

Deliver a standard Excel file: after review, ask the agent to export the spreadsheet as .xlsx so it can be opened and edited in Excel, WPS Office, and other compatible office applications.

1. Describe the task in natural language

2. Follow the result live while the agent works

3. Approve or discard the changes in the conversation

Generate a presentation from one request

Give the agent a topic, audience, page count, content outline, and visual direction. It can build the complete presentation, verify content and layout page by page, and leave the result in the conversation for review.

Deliver a standard PowerPoint file: after review, ask the agent to export the presentation as .pptx so it can be presented and edited in PowerPoint, WPS Office, and other compatible office applications.

1. Specify the topic, audience, and page requirements

2. Follow and verify the pages while the agent works

What can it do?

• Analyze and build spreadsheets — read or create Excel data, clean fields, write formulas, apply formatting and validation, create tables, charts, pivots, filters, sparklines, conditional formatting, and images, then export the result as .xlsx, .csv, or .tsv.
• Write and lay out documents — create paragraphs, rich text, lists, tasks, tables, images, charts, headers, footers, pagination, and page layouts.
• Create and revise presentations — generate a deck from an outline, redesign selected pages, edit text, shapes, images, tables, charts, and transitions, then detect off-page, overflowing, and overlapping text.
• Build lightweight databases — create Base tables, fields, records, and views with formula fields, filters, sorting, grouping, and Sheet-backed references.
• Draw editable canvases — create shapes, text, connectors, images, native charts, and diagrams, with connector and layout analysis.
• Compose several content types — one .univer file can contain Sheet, Doc, Slide, Base, and Board Units. Formulas and embedded content can reference other Units in the same file.
• Work with Office files — import .xlsx, .csv, .tsv, .docx, and .pptx, then export the edited content in the matching format.
• Review agent changes safely — every write starts in an isolated worktree. Watch changes live, then merge or discard them from the conversation instead of letting the agent overwrite the current version.

Example requests

Analyze sales.xlsx, fix the date and currency columns, add monthly trends, a regional comparison chart, and a summary sheet, then deliver an xlsx file.

Turn brief.md into an eight-slide investor deck with a dark-blue visual system. Check every page for layout problems and export it as pptx.

Convert meeting-notes.md into a formal weekly report with an executive summary, risk table, next-week plan, headers, and footers. Deliver a docx file.

Create a customer-tracking Base with company, contact, stage, expected value, and next action fields, plus a view grouped by stage.

Create a sales Sheet and a summary Slide in the same .univer file, with the Slide chart reading the Sheet data.

Capabilities

Content	Create and edit	Verify and review	Import	Export
Sheet	Cells, formulas, styles, tables, charts, pivots, filters, validation, images, and more	Structured range inspection, recalculation, live preview	.xlsx .csv .tsv	.xlsx .csv .tsv
Doc	Paragraphs, rich text, lists, tasks, tables, images, charts, headers, footers, pagination	Document readback, live preview	.docx	.docx
Slide	Pages, text, shapes, images, tables, charts, SVG layouts, transitions	Structure inspection, text bounds/overflow/overlap lint, live preview	.pptx	.pptx
Base	Tables, fields, records, views, formulas, filters, sorting, grouping	Facade readback, live preview	—	.xlsx .csv .tsv
Board	Shapes, text, connectors, images, native charts, routing	Element and connector analysis, live preview	—	—

Every content type supports isolated worktree editing, review submission, reopening, merging, and discarding. Base and Board currently use exact Facade readback for structural verification. Board file export is not yet supported.

Get started in 3 minutes

1. Install the plugin

Install from npm:

dsh plugin --profile web add dsh-univer-office

Or install the latest version directly from GitHub:

dsh plugin --profile web add github:dream-num/dsh-univer-office

After installation, refresh DeepSeek Harness with Cmd+R / Ctrl+R.

2. Describe the result you want

Create reports/q2-review.univer. Read data/q2-sales.xlsx and build a management dashboard with summary metrics, monthly trends, and regional rankings.

The agent automatically loads the relevant skills and selects the univer_* tools. A typical task creates the file and a worktree, imports or creates a Unit, edits it, reads the result back for verification, and submits the worktree for review.

3. Review it in the conversation

• Creating a .univer file, creating or reopening a worktree, writing content, and submitting for review opens a live window in the top-right. A non-terminal worktree left open in one turn stays open in the next.
• Every touched .univer file that still exists at the end of the Turn uses the same foldable, fullscreen-capable Turn card; historical Turns keep the same card collapsed by default. Temporary files created and then removed during the Turn do not leave cards behind.
• Submit, merge, and discard through the full Univer page embedded in the card instead of duplicate controls outside the Viewer.

How it works

A .univer file is a composable office container that can hold several Units of different types. The plugin puts each agent task in an isolated worktree:

Your request
   ↓
Load the matching Univer skill
   ↓
Create / import / edit in a draft worktree
   ↓
Readback + recalculation + Slide layout lint
   ↓
Live preview and in-conversation review
   ↓
Revise / merge / discard

Only merge and discard end a worktree, and both require an explicit user request plus DSH approval. ready only submits the worktree for review; it does not change the trunk.

Built-in tools

You do not need to call tools manually in normal use; DSH selects them from your request. This list shows what the plugin exposes to the agent.

Tool	Purpose
univer_new	Create an empty .univer file without overwriting an existing file
univer_status	List Units and worktrees in trunk or a selected worktree
univer_worktree	Create, submit, reopen, merge, or discard an isolated worktree
univer_unit	Create or remove a Sheet, Doc, Slide, Base, or Board Unit
univer_import	Import an Office file as a new Unit
univer_inspect	Read document structure or a selected Sheet range
univer_execute	Read or modify content with the exact Univer Facade API
univer_export	Export a Sheet, Doc, Slide, or Base Unit
univer_lint	Detect off-page, overflowing, and overlapping Slide text
univer_compile_svg	Compile SVG into an explicit Slide page with real font metrics
univer_api	Search the exact Univer Facade API bundled with this plugin

The plugin also ships eight version-matched, lazily loaded skills: core orchestration, Sheet, Doc, Slide, Base, Board, Embed, and cross-Unit formulas.

Preview and review experience

• Live Univer window — file creation plus worktree creation, reopening, writing, and submission open it automatically. Drag, resize, fold, or maximize it; non-terminal windows left open carry into the next Turn.
• Unified Turn cards — every touched .univer file that still exists has its own full Univer card, later reads do not erase a lifecycle result already produced in that Turn, and deleted temporary files do not leave loading cards behind.
• Historical review — draft, ready, merged, and discarded results all remain in the same card layout at their original Turn, with historical cards collapsed by default.
• Session isolation — each DSH session shows only its own windows, cards, and review state.
• English and Chinese UI — the plugin shell and every open Viewer follow the DSH locale.

Requirements and current limits

• DeepSeek Harness and Node.js >=22.19.0.
• Slide layout lint and real SVG text measurement require a local Chrome/Chromium executable. Set UNIVER_RENDER_BROWSER to use a specific browser path.
• The plugin does not currently expose screenshots to the model. Structural and layout checks are not a substitute for pixel-level visual approval; you can still inspect the result in the live Viewer.
• Slide master pages, layout pages, and speaker notes are outside the current editing scope.
• Board mind maps, tables, ink, advanced editing, and file export are not yet supported.

Configuration

The defaults are designed for local use: the Gateway starts on the first file-state request at 9080. If that port is occupied, it tries 9081, then continues upward one port at a time. Configure the bundle's Cordis layer when you need different values:

Field	Default	Purpose
gatewayPort	9080	Initial loopback port for the bundled Gateway; occupied ports advance by one
autoStartGateway	true	Start the Gateway on first use
gatewayStartupTimeoutMs	10000	Gateway startup timeout
gatewayRequestTimeoutMs	3000	State-read timeout
gatewayMutationTimeoutMs	60000	Gateway mutation timeout
unitContentOperationTimeoutMs	120000	Import, export, inspection, and execution timeout
tools	true	Register the univer_* tools
skills	true	Register the bundled Univer skills

See src/host/config.ts for the remaining cache and commit-confirmation options.

Uninstall

dsh plugin --profile web remove dsh-univer-office

Development

This project is a standard DSH bundle. Its Host composes the Univer Service Provider, Tools Consumer, webServer Consumer, and Skill Provider. The bundle includes its Gateway, Viewer, headless Unit Content Worker, and Slide render machine. See the architecture document for dependency directions and runtime boundaries.

pnpm install
pnpm run build
pnpm run test

Build the npm tarball and zip distribution:

bash scripts/build-dist.sh

lib/, artifacts/, dist/, *.tgz, and univer-dsh-plugin.zip are generated and are not committed.

Official package name

Install only dsh-univer-office. The following similar names are deprecated npm placeholders reserved by this project to prevent impersonation; they contain no plugin code:

• dsh-univer-plugin
• dsh-univer-office-suite
• dsh-univer-suite
• univer-office-suite
• univer-office

License

Apache-2.0