DeepSeek Harness (DSH) × Univer Plugin

Create, inspect, edit, and review Univer files inside DeepSeek Harness.

English · 中文

Create and preview Univer office files (sheets, docs, slides, bases) directly inside DeepSeek Harness. After a turn uses a structured univer_* tool, a preview card appears at the turn tail; click it to expand fullscreen in-app. Worktree work gets a live window, and session-end review stays inside the conversation.

┌────────────────────────────────────────┐
│ 📊 sales.univer  [wt-xxx]  [Expand ▾]  │  ← card at the turn tail
│ /Users/.../sales.univer                │
└────────────────────────────────────────┘

┌──────────────────────────────┐
│ ● agent-draft · sales.univer │  ← floating live window (draft worktree)
│ [in progress]  [−] [⤢] [✕]  │
│ ┌──────────────────────────┐ │
│ │   live worktree Viewer   │ │     double-click to maximize,
│ │   (read-only, real-time) │ │     drag / resize / fold anytime
│ └──────────────────────────┘ │
└──────────────────────────────┘

┌────────────────────────────────────────┐
│ 🧾 Merge preview「agent-draft」 [Ready] ▾ │  ← session-end merge panel
│ ┌────────────────────────────────────┐ │
│ │   merge preview page (embedded)    │ │
│ └────────────────────────────────────┘ │
└────────────────────────────────────────┘

Features

• Inline preview cards — a card appears at the end of turns that use the structured univer_* tools.
• In-app fullscreen viewer — click the card to open the sheet in an in-app iframe; close with ✕ / mask / Esc.
• Live floating worktree window — when the agent creates or updates a worktree, a small window pops up in the top-right corner embedding the live read-only worktree page. Edits appear in real time. When one worktree touches several units (e.g. a sheet plus a deck), the window and the review panel show unit chips that list ONLY changed units (＋ added / ✎ modified / － deleted / ⚠ conflict) with status icons, defaulting to the first one.
• Window interactions — drag the title bar to move and double-click it to maximize; use the dedicated fold, maximize/restore, and close controls; drag any edge or corner to resize. Folding keeps the loaded Viewer mounted for instant restoration. Movement, resizing, and viewport changes keep the full window reachable on screen.
• Ready + session end → close, then merge panel — once the session goes idle, every non-terminal worktree moves into the review dock below the conversation: ready shows the merge preview (scope=mergePreview) plus Discard / Merge into current version actions; draft shows up too, with the live worktree page plus Submit for confirmation / Discard actions (so a modification the agent forgot to submit is still reviewable). While the session is still running, non-terminal worktrees stay as top-right windows. Merged or discarded worktrees (terminal states) show nothing — no window, no panel.
• Bundled Gateway management — the plugin ships the collaboration Gateway and Viewer; green dot = running, yellow dot = stopped, click to start the plugin-owned Gateway.
• Multi-session — each session shows its own turn's cards, windows, and merge panels.
• Bilingual UI — the plugin shell and every open Viewer follow the app locale (zh / en).

Requirements

• DeepSeek Harness and Node.js 22.19 or newer; platform-native dependencies are installed from the registry for the current machine. Slide layout lint and SVG text measurement require a local Chrome/Chromium executable or UNIVER_RENDER_BROWSER.
• No global Univer CLI installation is required. The plugin bundles its Gateway, Viewer, headless Unit Content Worker, machine render page, Office converter, Univer license, platform-native dependencies, and eight version-matched lazy Univer skills: core orchestration, five Unit guides, Embed, and cross-Unit formulas. Their workflows track Univer CLI except where DSH tools or the client preview replace CLI commands, and where the plugin does not yet expose a capability. The plugin registers univer_new, univer_status, univer_worktree, univer_unit, univer_import, univer_inspect, univer_execute, univer_export, univer_lint, univer_compile_svg, and univer_api.
• Model screenshot capture is intentionally not included yet. The bundled skill reports when appearance remains unverified instead of claiming visual confirmation.

Install

This is a standard DSH bundle: it declares dsh.bundle and ships its own cordis.patch.yml, so it installs through the canonical loader:

From a git checkout

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

From npm

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

From a local checkout (development)

dsh plugin --profile web add /path/to/dsh-univer-office

The first use of a profile initializes it; dsh appends the bundle to dsh.profile.bundles and pnpm links the package, so the loader resolves the plugin's cordis.patch.yml layer automatically. Verify with dsh --profile web --dump-config (you should see a # == dsh-univer-office layer).

After any install: refresh DeepSeek Harness (Cmd+R / Ctrl+R).

Usage

1. Create an empty .univer file, then create an isolated worktree
2. Create a typed Unit or import an Office file into that draft worktree
3. The model proactively loads the core and matching Unit skill; Embed and cross-Unit formulas load their topic skills as well. Use univer_api when an exact Facade or method is needed
4. Modify with univer_execute; verify content with univer_inspect, and run univer_lint for Slide text layout
5. Use univer_compile_svg when an SVG should replace or overlay one explicit Slide page; export only when requested
6. Submit with ready; use reopen when the same task needs another edit
7. Merge or discard only on an explicit request and after DSH approval; the in-app review panel provides the same decisions
8. Preview cards, the live worktree window, and the session-end review panel reflect the structured tool results

Uninstall

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

Architecture

The package is one installable DSH bundle with several internal Cordis roles:

• the root Host plugin composes the Univer Service Provider, webServer Consumer, Tools Consumer, and bundled lazy Skill Provider;
• ctx.univer is the only Host domain API used by the consumers;
• host/webServer exposes GET /univer-api/status, POST /univer-api/gateway/start, GET /univer-api/state, and POST /univer-api/worktree-action;
• the Tools Consumer exposes domain tools instead of a generic CLI passthrough;
• host/processes/gateway owns the bundled Gateway process and Viewer assets; host/adapters/unit-content starts an isolated one-shot Unit Content Worker from workers/unit-content for import, inspect, execute, export, and render-source reads; the machine render page supplies Slide layout facts and SVG text metrics without exposing screenshots;
• the Client recovers structured targets from durable tool events, polls state through its API layer, and renders preview, live-window, and review components.

src/ contains the Host, Client, Gateway, Unit Content Worker, and Viewer sources. The Viewer application and its local rendering support were copied from univer-cli so this repository builds every application it ships. See the architecture decision for directories, dependencies, and trust boundaries.

Development

lib/, artifacts/, dist/, and the archives (univer-dsh-plugin.zip, *.tgz) are generated and never committed. pnpm run build compiles the Host, Client, Gateway, Unit Content Worker, machine render page, and Viewer from src/.

pnpm run build
pnpm run test

Then build the release artifacts:

bash scripts/build-dist.sh

This regenerates dist/univer/ (the shipped package contents), the npm tarball dist/univer-office-<version>.tgz, and the zip distribution univer-dsh-plugin.zip (package contents).

Individual smoke tests:

node test/host-smoke.mjs
node test/client-smoke.mjs
node test/skills-smoke.mjs
npm run test:integration

Publish the package with npm publish (respects the files allowlist); attach the zip/tgz to a GitHub Release for end users.

Reserved npm names

The following unscoped names are reserved by this project as typosquatting guards — each redirects/<name>/ directory holds a placeholder package (deprecated, pointing to the official name) that contains no code:

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

Always install the official package:

dsh plugin --profile web add github:dream-num/dsh-univer-office   # from git
dsh plugin --profile web add dsh-univer-office                    # from npm

Metadata

• Topic: dsh-plugin
• Bundle manifest: dsh.bundle.patch → ./cordis.patch.yml
• Client manifest: dsh.client (platform: "web" + inject)

License

Apache-2.0