kw78/dsh-office-tools 预览 preview

kw78/dsh-office-tools

面向DeepSeek Harness的模型端Office工具:支持Word(.docx)、Excel(.xlsx)和PowerPoint(.pptx)的创建/读取/更新,使用工作区安全路径,并支持PPT图片嵌入。

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), offering eight model-facing Office file utilities for .docx, .xlsx, and .pptx formats. It supports core operations including creating new files, extracting content from existing files, and updating existing files. All tools run directly within the DSH plugin host environment, and have carried zero runtime dependencies since version 1.0.0. To install the plugin, you can use the official DSH plugin CLI command, which works for npm packages, GitHub sources, or local checkouts. After installation, you need to restart the DSH server for the tools to load.

The plugin is designed for DSH agents that need to generate and manipulate standard Office documents as part of their workflow. When a user asks the DSH agent to create reports, spreadsheets, or presentations, the agent can call the corresponding creation tool to output a valid Office file. It can also read the generated file back to confirm its content, and update the existing file with new content if required. All generated files use an ASCII-safe construction that works seamlessly with all mainstream Office suites. Users can also disable the PowerPoint tools via plugin configuration if needed.

The plugin follows the official DSH host-plugin contract, and only depends on the built-in tool registry and file system services provided by DSH. It is released under the open source MIT license, and includes multiple safety guardrails to prevent misuse. All file operations are confined to the agent's current session workspace, and input files are checked for size limits and zip bomb protections. It never spawns local Office processes, and all format parsing and generation is handled by the plugin's built-in OOXML engine. Overwrites are disabled by default to avoid accidental data loss.

这是一款专为 DeepSeek Harness(DSH)打造的原生插件,提供了八个面向模型的 Office 文件处理工具,覆盖 docx、xlsx、pptx 三类格式的创建、读取、更新操作。所有工具都运行在 DSH 插件宿主环境内,自 1.0.0 版本起就无额外运行依赖,所有文件操作都通过 DSH 官方的文件系统服务完成,不直接访问本地原始文件系统。可以通过 DSH 官方插件命令行工具快速安装。

这款插件面向需要处理 Office 文档的 DSH 智能代理,能够让大模型直接生成符合官方规范、可被所有主流办公软件打开的标准 Office 文件。在典型使用流程中,当用户向 DSH 代理提出生成报告、整理数据、制作演示文稿的需求时,代理会调用对应格式的创建工具生成文件,再读取文件内容进行验证,还可以根据需求向已有文件追加内容。

插件遵循 DSH 宿主插件标准契约,仅依赖 DSH 提供的工具注册和文件系统服务,本身无额外运行依赖,采用 MIT 许可证开源。所有文件操作都限制在代理会话工作区内,对输入文件设置了大小限制和 zip 炸弹防护,默认不覆盖已有文件,不会调用本地 Office 进程,所有格式解析生成都由插件自带的 OOXML 引擎完成。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 26 stars - an early-stage project星标 26,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-office-tools

把 kw78/dsh-office-tools 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-office-tools

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

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:

One prompt generating report.docx, budget.xlsx, and deck.pptx

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: the sanctioned ctx.fs write channel is UTF-8 text only, so a package cannot carry binary image parts. Keep image files next to the deck when moving it, and note that PowerPoint blocks external content by default — a linked picture renders as a "blocked automatic download" placeholder until you enable external content (File → Info → Enable Content, or add the folder under Trust Center → Trusted Locations). This is a PowerPoint security policy, not a package defect.
  • ppt_create echoes every element's landing position; ppt_read returns the same geometry for any deck.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-roleplay-preset 下一个 Next dsh-anchored-standard →