dsh-office-tools

Curated pickMaintenance: Active

kw78/dsh-office-tools

Model-facing Office tools for DeepSeek Harness: Word (.docx), Excel (.xlsx), and PowerPoint (.pptx) create/read/update with workspace-safe paths and PPT image embedding.

View on GitHub

$ dsh plugin add dsh-office-tools

Install

dsh has no central install command — add this plugin’s entry (documented in its README below) to your profile or patch config, then restart.

How installs work

stars

forks

TypeScript

Language

MIT

License

2026-08-15

Created

2026-09-18

Last push

README

dsh-office-tools

If you find this project useful, please give it a ⭐ Star — it helps others find it.

Eight model-facing Office file tools for DeepSeek Harness: create, read, and update Word (`.docx`), Excel (`.xlsx`), and PowerPoint (`.pptx`) files inside the session workspace. Zero runtime dependencies — every package is generated and parsed by the plugin's own OOXML engine, and every byte crosses the official `ctx.fs` service.

Tools

Tool	Purpose
`word_create`	Create `.docx` (title, paragraphs, bullets, one table)
`word_read`	Extract text; `format: "markdown"` renders structure
`word_update`	Append paragraphs, bullets, and/or a table
`excel_create`	Create multi-sheet `.xlsx` from cell grids
`excel_read`	Read sheets as rows; formulas return cached values or `'=…'`
`excel_update`	Replace/create sheets, or write cells by A1 address
`ppt_create`	Create 16:9 `.pptx` (slides, bullets, notes, linked images)
`ppt_read`	Extract text, notes, tables, and per-shape geometry

Strings starting with = become real Excel formulas.

Demo

One prompt, a quarterly-report trio:

Install

dsh plugin --profile web add dsh-office-tools              # npm (recommended)
dsh plugin --profile web add github:kw78/dsh-office-tools  # from source

Restart DSH after installing. Requires a profile that provides the fs service (every profile with built-in read/write tools does).

Notes

All paths are confined to the session workspace; overwrite defaults to false.
Reads accept any real package (STORE/DEFLATE) with zip-bomb guards; updates refuse packages with binary parts instead of corrupting them.
PPT images are linked, not embedded — keep image files next to the deck when moving it.
ppt_create echoes every element's landing position; ppt_read returns the same geometry for any deck.

Configuration

One option: enablePptTools (default true) — set it to false to coexist with a dedicated presentation plugin such as dsh-ppt:

- insert:
    - id: dsh-office-tools
      config:
        enablePptTools: false

Development

pnpm install && pnpm run check   # typecheck + tests + build
pnpm run test:e2e                # real-composition E2E (sandbox-policy + fs-sandbox + tools)

Compatibility: DSH >=0.1.0-rc.6; exact per-release records live in package.json (dsh.compatibility.dshReleases).

Further reading: DEVELOPMENT.md · ROADMAP.md · hub-registration.md · MIT License