Introduction

DeepSeek Harness (DSH) aims to achieve functional coverage through plugin-based extension. In the scenario of generating editable PPTX documents, handling complex template rendering, validation logic, and interaction with external PPT runtimes is typically required. dsh-workbuddy-ppt, as a DSH plugin, provides a self-contained solution that allows local generation of editable PPTX files and offers deterministic PPTD validation capabilities.

Plugin Overview

dsh-workbuddy-ppt is a DSH workflow plugin maintained by SuperstructureJH. Its core value lies in:
* Editable PPTX generation for DSH: generates editable PPTX files directly within DSH.
* Bundled Kimi-compatible authoring Skill: includes a Kimi-compatible authoring skill that can be used without additional configuration.
* Deterministic PPTD v2 checks: provides a deterministic PPTD v2 validation mechanism to ensure structural consistency of generated content.
* Local PowerPoint renderer: uses a local PowerPoint renderer to process output without relying on external presentation runtimes.
* Shared workspace: supports shared workspace images, session storage, approvals, audits, and delivery previews.
* CLI tools: provides the dsh-pptd command-line tool for conversion, checking, rendering, and screenshots.

The plugin is open-sourced under the MIT License.

Core Features

  1. Dual-mode support:
    • PPT mode: generates editable PPTX files using the local renderer, with bundled Kimi skills and PPTD validation.
    • Slides mode: an optional mode that uses Tencent PPT skills, SlideP, and Tencent Docs runtime artifacts.
  2. CLI toolset: provides a complete set of command-line tools supporting conversion from PPTX to PPTD project, automatic validation, code checking, screenshot preview, and rendered output.
  3. Shared infrastructure: both modes share governed workspace images, session storage, approval workflows, audit logs, and delivery preview capabilities.

Installation and Activation

Installing the plugin requires satisfying the Node.js version requirement (^22.19.0 or >=24.0.0). Use the following command to install:

dsh plugin --profile web add dsh-workbuddy-ppt

After installation, DSH will automatically load the bundled kimi-ppt Skill and PPTD validation logic included in the package.

CLI Tool Usage

The plugin provides the dsh-pptd command-line tool for processing local PPTD projects. The following are common commands:

# 转换：将 PPTX 转换为可编辑的 PPTD v2 项目
dsh-pptd convert <input>.pptx --output <project-directory> --

# 检查：检查指定页面，指定严重级别
dsh-pptd check <project> --page 1,3-5 --severity error,warning --level keep --

# 检查自动：应用确定性修复（如类型转换、删除无效节点）
dsh-pptd check <project> --level auto --

# 检查：列出所有问题
dsh-pptd inspect <project> --

# 截图：生成项目内页面的本地预览
dsh-pptd screenshot <project> --page 1-3 --output <screenshots> --scale 2 --

# 渲染：将 PPTD 项目编译为可编辑的 PPTX
dsh-pptd render <project> --output <output>.pptx --

CLI Tool Feature Notes

  • Diagnostic conversion: the convert command converts PPTX to PPTD. This process is diagnostic rather than a lossless conversion. If the source file contains unsupported features or resource violations, the CLI returns a detailed JSON receipt.
  • Atomic publishing: file publishing is atomic. If the output file already exists, the --force parameter is usually required.
  • No external dependencies: the CLI does not execute or rely on external presentation runtimes; all rendering logic is completed locally.
  • Network restrictions: the loader disables network resources during the loading process.

Notes

  • Node.js version: ensure the environment satisfies Node.js ^22.19.0 or >=24.0.0.
  • PPTD v2: the generated PPTD v2 file is the renderer’s source file, not a parallel diagnostic export.
  • Security and audit: because the plugin involves file rendering and permission control, it is recommended to review the source code and license before installation.
  • Use cases: suitable for technical teams that need to generate structured, editable PPTX documents in DSH workflows and require strict control over the rendering environment and output quality.

Summary

dsh-workbuddy-ppt lowers the barrier to generating high-quality PPTX documents in a DSH environment by providing built-in authoring skills, deterministic validation mechanisms, and localized CLI tools. Its modular design (PPT mode and Slides mode) also provides flexible choices for different scenarios. More details can be found in the GitHub repository.