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.

Bundle verified MIT TypeScript Unknown
Bundle verified

Listed

2

Docs

Bundle verified

★ 2 View on GitHub
VersionUnknown
LanguageTypeScript
LicenseMIT
View on GitHub

Preview

Preview 1 of 2: kw78/dsh-office-tools
Preview 2 of 2: kw78/dsh-office-tools

What it does

Workspace-safe Office tools for agents: create/read Word, create/read/update Excel, and create/read PowerPoint decks with PNG/JPG/GIF image placement.

Best for

  • Agents that need to create or extract text from Word documents inside the current session workspace.
  • Workflows that create, read, or update Excel workbooks using sheets, scalar grids, and A1 cell addresses.
  • Teams generating or inspecting 16:9 PowerPoint decks with text, notes, and workspace-local PNG, JPG, or GIF images.

Not ideal for

  • Office files or images located outside the calling agent's session workspace.
  • Workflows requiring rich Word editing beyond titles, paragraphs, bullets, and one table, or PowerPoint editing of an existing deck.
  • Large or unbounded documents; reads are capped at 50 MiB, image files at 20 MiB each, and text or cell output may be truncated.

README

dsh-office-tools

Seven model-facing Office file tools for DeepSeek Harness, running entirely in the plugin host half.

npm version ci License: MIT Listed on awesome-dsh-plugin

Install: dsh plugin --profile web add github:kw78/dsh-office-tools

Tool Purpose Library
word_create Create .docx (title, paragraphs, bullets, one table) docx
word_read Extract plain text from .docx mammoth
excel_create Create a multi-sheet .xlsx from scalar cell grids SheetJS (xlsx)
excel_read Read one or all sheets as scalar rows SheetJS
excel_update Replace/create whole sheets, or write cells by A1 address SheetJS
ppt_create Create a 16:9 .pptx (title slide, titles, paragraphs, bullets, notes, PNG/JPG/GIF images) pptxgenjs
ppt_read Extract per-slide paragraph text, speaker notes, and image counts jszip

Harness integration

The plugin follows the standard DSH host-plugin contract:

  • It exports name / inject / apply; inject = ['tools'] is its only runtime service dependency (@deepseek-ai/dsh-tools).
  • apply(ctx) wraps every ctx.tools.register(defineTool({...})) in ctx.effect(...) so Cordis disposes the registrations with the plugin fiber.
  • defineTool declares model-visible parameters, a validated canonical output.schema, and a pure output.render text projection.
  • execute(args, exec) resolves every path against exec.agent.session.header.cwd; relative paths stay in the session workspace and absolute paths are accepted only when still inside it. A realpath check on the nearest existing ancestor closes the symlink escape hatch.
  • Image files must live inside the session workspace (.png/.jpg/.jpeg/.gif, 20 MiB each); explicit inch coordinates x/y/w/h are supported, or omit them for automatic placement below the text.
  • Writes go through a same-directory temp file + rename; overwrite defaults to false.

Build

pnpm install
pnpm run check   # typecheck + tests + build

Artifacts: lib/index.js (ESM host bundle with Office libraries inlined; @deepseek-ai/* and cordis stay external) and lib/types/**/*.d.ts.

Install

# npm (recommended)
dsh plugin --profile web add dsh-office-tools

# GitHub source
dsh plugin --profile web add github:kw78/dsh-office-tools

# local checkout
dsh plugin --profile web add /path/to/dsh-office-tools

Restart the DSH server after installation. The seven tools appear in the next prompt assembly.

Community indexes

  • Registration blocks for awesome-dsh-plugin / dsh-market are in docs/hub-registration.md.
  • Recommended repository topics: dsh, dsh-plugin, deepseek-harness, office.

Safety

  • All file access is confined to the calling agent’s session workspace.
  • Reads are capped at 50 MiB; text/cell results are bounded and mark truncated.
  • Creates/updates are bounded by row and cell limits and refuse overwrites by default.
  • No LibreOffice/PowerPoint/Word subprocess is spawned; formats are generated and parsed with pure-JS libraries.

Frequently Asked QuestionsFAQ

Use the verified command dsh plugin --profile default add github:kw78/dsh-office-tools in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.

tt-a1i/archify#integrations/deepseek-harness★ 14,012

Generate validated, self-contained interactive architecture, workflow, sequence, data-flow, and lifecycle diagrams from repositories or system descriptions.

MIT
liustack/modlens★ 2,925

Vision bridge for text-only models: paste an image, get structured JSON evidence (OCR, layout, semantics).

MIT
GanyuanRan/Aegis★ 1,048

Software-engineering method pack for coding agents, with skills for baseline-first planning, systematic debugging, prompt hygiene, verification before completion, and repair/retirement tracking.

MIT
ysr666/dsh-vision-router★ 680

Free vision for text-only agents: built-in keyless vision chain plus pixel tools (Q&A, grounding, crop, pixel diff, colors, OCR, SVG trace, cutout, screenshots); paste an image to use it.

MIT