dsh-office-tools

編輯精選維護狀態: 活躍

kw78/dsh-office-tools

面向模型的 Office 工具集：Word/Excel/PPT 建立、讀取與更新，支援工作區安全路徑和 PPT 圖片嵌入。

前往 GitHub

$ dsh plugin add dsh-office-tools

安裝

dsh 沒有統一的安裝指令 —— 把該外掛 README（見下方）中的設定行加入你的 profile / patch 設定，然後重啟即可。

查看安裝教學

星數

Fork

TypeScript

語言

MIT

授權條款

2026-08-15

建立於

2026-09-18

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