DSH NP-PPT 演示文稿专家插件 (dsh-np-ppt)

🌐 中文 · English

DSH（DeepSeek Harness）原生专用的全功能 PPT 演示文稿专家 插件。内置 PPTD DSL 引擎、55173 所见即所得可视化编辑器服务、Python-PPTX 高保真离线编译内核与一键导出 PPTX 功能。

✨ 核心特性

1. 🎭 9 大专业视觉风格体系

   • 👔 商务管理风（墨绿+黄铜金）
   • 💻 深浅代码风（极客终端黑/蓝灰+亮绿）
   • 🚀 高能增长风（活力橙+稳重深蓝）
   • 🔮 炫光紫绿风（暗黑底色+电光紫绿）
   • 📑 冷白调研风（瑞士极简白底+细黑线+红点缀）
   • 📱 轻拟态风（柔和浅灰白+微质感卡片+科技蓝）
   • 👑 黑金实验风（曜石黑+奢华哑光金）
   • 📊 色谱图表风（纯净白底+多维对比色谱）
   • 📖 深蓝杂志风（深海蓝底+金句引述+画册感）

2. 🛠️ 模块化 PPTD 架构与标准 16:9 画布

   • 采用清晰的 YAML 语法 DSL，解耦 OOXML 复杂逻辑，单个页面（01_cover.page ~ XX_final.page）完全独立自洽；
   • 自动添加淡入淡出（Fade）幻灯片平滑切换过渡。

3. 🖥️ 55173 所见即所得可视化编辑器

   • 内置轻量级本地 Web 编辑器（http://127.0.0.1:55173/）；
   • 支持多层嵌套富文本修改、自由拖拽对齐与实时渲染；
   • 无缝集成：点击右上角「导出」弹窗中的「下载」即可直接触发本地高保真 Python-PPTX 编译引擎下载文件；选择「图片」时保持原生图片切图下载。

4. ⚡ 高保真离线原生编译内核（Python-PPTX）

   • 基于 RichTextHTMLParser 状态机，完美支持无限层级嵌套 HTML 标签（<span>、<strong>、<b>、<em>、<i>、<u>、<br/>）与全格式颜色（#HEX、rgb()、rgba()、$theme）；
   • 微软雅黑字族锁定（Microsoft YaHei）、DrawingML 渐变背景、noAutofit 文本框防缩放。

📦 目录结构

dsh-np-ppt/
├── package.json                   # 插件元信息与导出入口
├── tsconfig.json                  # TypeScript 编译配置（输出至 lib/）
├── cordis.patch.yml               # DSH / Cordis 插件注册清单
├── src/                           # TypeScript 源码
│   ├── index.ts                   # 插件 Host 入口（Prompt 注入、服务治理、工具导出）
│   ├── service.ts                 # 55173 编辑器 Web 服务与 Python 编译桥接
│   ├── tools.ts                   # 原生 Agent Tools（ppt_export, ppt_serve 等）
│   └── client/                    # DSH Web 前端插件扩展
├── lib/                           # 预编译 ESM 代码（即装即用，无需构建）
├── compiler/
│   └── export_pptx.py             # 高保真 Python-PPTX 离线编译引擎
├── editor/                        # 55173 本地可视化编辑器静态资源
│   ├── index.html                 # 编辑器宿主页面
│   ├── app.js                     # 前端交互逻辑
│   ├── lib.js                     # 编辑器辅助库
│   └── styles.css                 # 编辑器样式
├── presets/                       # Agent 预设（Persona & System Prompt）
│   ├── preset.yml                 # 「PPT 演示文稿专家」预设定义
│   └── agent.cordis.yml           # 完整 Agent 配置（persona、工具、plan mode 等）
└── README.md                      # 本文件（中文 + English）

🧩 环境要求

💡 仅做"对话生成 + 命令行编译导出 PPTX"时，浏览器不是必须；但要在 55173 可视化编辑器中拖拽对齐、实时渲染并一键下载，建议使用 Chrome/Edge 桌面版。

🔌 安装与激活方法

以下示例中 <项目路径> 表示本插件在你本机的目录路径，安装时请按实际位置替换。

方式一：通过 DSH 命令行挂载（推荐）

在终端中指定 --profile web 执行安装挂载：

dsh plugin --profile web add link:<项目路径>

在 pnpm workspace 根目录下添加时可能需要附加 -w/--workspace-root 参数，例如： dsh plugin --profile web add -w link:<项目路径>

方式二：手动配置到 DSH 配置文件

在 ~/.dsh/profiles/web/cordis.patch.yml 中添加：

- insert:
    - id: dsh-np-ppt
      name: 'dsh-np-ppt'

并在 ~/.dsh/profiles/web/node_modules/ 下建立指向 <项目路径> 的符号链接（Windows 用 Junction / mklink /J，macOS·Linux 用 ln -s）。

安装完成后，重启当前 web profile（在运行 dsh web 的终端按 Ctrl+C 后重新执行 dsh web）即可加载插件。

🚀 使用指南

插件装载成功后，DSH Web GUI 中会新增一个自定义 Agent 预设 —— 「PPT 演示文稿专家」。该预置内置了完整的 PPTD DSL 编写规范、9 大风格主题说明、本地编译与 55173 编辑器联动指引，并自动注入到系统提示词，使 AI 直接具备演示文稿创作能力；脚本同时把预设文件复制到 ~/.dsh/.agent-presets/np-ppt/ 以便离线复用。

1. 对话驱动生成

在 DSH Web GUI 中切换到 PPT 演示文稿专家 预设，直接与 AI 对话：

"帮我用科技蓝风格做一份 8 页的《微服务架构重构技术方案》"

2. 本地可视化编辑与导出

1. 在浏览器中打开 http://127.0.0.1:55173/；
2. 点击「打开 PPTD 文件夹」，授权选择包含 deck.pptd 的项目目录；
3. 直接在页面中进行文字修改、排版调整；
4. 点击右上角「导出」-> 选择 PPT -> 点击「下载」，即可下载高保真 PPTX 幻灯片。

3. 命令行直接编译

在 PPTD 项目目录下直接运行内置编译器：

py -3 <项目路径>/compiler/export_pptx.py deck/deck.pptd --output deck/deck.pptx --force

macOS / Linux 下请使用 python3： python3 <项目路径>/compiler/export_pptx.py deck/deck.pptd --output deck/deck.pptx --force 首次运行若无 pyyaml / python-pptx，脚本会自动通过 pip 安装。

English

⬆️ 中文

A native full-featured Presentation & Slide Design Expert plugin for DSH (DeepSeek Harness). Built-in PPTD DSL engine, 55173 WYSIWYG visual editor service, Python-PPTX high-fidelity offline compiler, and 1-click PPTX export.

✨ Key Features

1. 🎭 9 Preset Professional Visual Design Systems

   • 👔 Business Management (Emerald + Brass Gold)
   • 💻 Geek / Code Theme (Terminal Slate + Bright Green)
   • 🚀 High-Energy Growth (Vibrant Orange + Deep Navy)
   • 🔮 Electric Violet (Cyber Dark + Neon Violet/Cyan)
   • 📑 Swiss Minimalist (Pure White + Fine Black Line + Red Accent)
   • 📱 Neomorphic Tech (Soft Light Gray + Card Glass + Tech Blue)
   • 👑 Obsidian & Gold (Matte Black + Luxury Satin Gold)
   • 📊 Metric Spectrum (Pure White + Multidimensional Spectrum)
   • 📖 Deep Blue Pictorial (Deep Sea Blue + Quote Callouts + Editorial Feel)

2. 🛠️ Modular PPTD DSL Architecture (16:9 Canvas)

   • Clean YAML DSL abstracting OOXML, self-contained modular slides (01_cover.page ~ XX_final.page).
   • Automatic slide-level fade transitions.

3. 🖥️ 55173 WYSIWYG Visual Editor

   • Integrated lightweight local Web editor at http://127.0.0.1:55173/.
   • Multi-level nested rich-text editing, free drag-and-drop alignment, real-time rendering.
   • Seamless export interception: clicking "Download" inside the top-right "Export" dialog directly triggers the local high-fidelity Python-PPTX compiler; choosing "Image" keeps the native image-slice download.

4. ⚡ High-Fidelity Python-PPTX Native Compiler

   • Integrated RichTextHTMLParser supporting infinite nesting HTML tags (<span>, <strong>, <b>, <em>, <i>, <u>, <br/>) and CSS colors (#HEX, rgb(), rgba(), $theme).
   • Microsoft YaHei font locking, DrawingML gradient backgrounds, and noAutofit text frames.

📦 Directory Structure

dsh-np-ppt/
├── package.json                   # Plugin metadata & export entry
├── tsconfig.json                  # TypeScript build config (outputs to lib/)
├── cordis.patch.yml               # DSH / Cordis plugin registration manifest
├── src/                           # TypeScript sources
│   ├── index.ts                   # Plugin Host entry (prompt injection, service, tools export)
│   ├── service.ts                 # 55173 editor web service & Python compiler bridge
│   ├── tools.ts                   # Native Agent Tools (ppt_export, ppt_serve, etc.)
│   └── client/                    # DSH Web front-end plugin extension
├── lib/                           # Pre-compiled ESM (ready to use, no build needed)
├── compiler/
│   └── export_pptx.py             # High-fidelity Python-PPTX offline compiler
├── editor/                        # 55173 local visual editor static assets
│   ├── index.html                 # Editor host page
│   ├── app.js                     # Front-end interaction logic
│   ├── lib.js                     # Editor helper library
│   └── styles.css                 # Editor styles
├── presets/                       # Agent presets (Persona & System Prompt)
│   ├── preset.yml                 # "Presentation Expert" preset definition
│   └── agent.cordis.yml           # Full agent config (persona, tools, plan mode, etc.)
└── README.md                      # This file (中文 + English)

🧩 Requirements

💡 A browser is not required for "conversation + CLI export"; it's recommended only for the 55173 visual editor (drag-align, real-time render, 1-click download).

🔌 Installation

Replace <plugin-path> below with your actual local plugin directory.

Option 1: Mount via the DSH CLI (recommended)

dsh plugin --profile web add link:<plugin-path>

In a pnpm workspace root you may need the -w/--workspace-root flag: dsh plugin --profile web add -w link:<plugin-path>

Option 2: Manual config

Add to ~/.dsh/profiles/web/cordis.patch.yml:

- insert:
    - id: dsh-np-ppt
      name: 'dsh-np-ppt'

Then create a symlink in ~/.dsh/profiles/web/node_modules/ pointing to <plugin-path> (Windows: mklink /J; macOS/Linux: ln -s).

After installing, restart the web profile (Ctrl+C in the dsh web terminal, then run dsh web again) to load the plugin.

🚀 Usage

Once the plugin is loaded, a custom Agent preset — "Presentation Expert" — is added to the DSH Web GUI. It bundles the full PPTD DSL authoring spec, 9 visual style themes, and local compiler / 55173 editor orchestration guidance, and is auto-injected into the system prompt so the AI can draft presentations out of the box; the preset files are also copied to ~/.dsh/.agent-presets/np-ppt/ for offline reuse.

1. Conversation-driven generation

Switch to the Presentation Expert preset in the DSH Web GUI and just talk to the AI:

"Make an 8-page Microservice Refactoring proposal in Tech-Blue style."

2. Local visual editing & export

1. Open http://127.0.0.1:55173/ in your browser.
2. Click "Open PPTD folder" and authorize the directory containing deck.pptd.
3. Edit text and layout directly on the page.
4. Click the top-right "Export" → choose PPT → "Download" to get a high-fidelity PPTX.

3. CLI compilation

Run the built-in compiler inside your PPTD project directory:

py -3 <plugin-path>/compiler/export_pptx.py deck/deck.pptd --output deck/deck.pptx --force

On macOS/Linux use python3. First run auto-installs pyyaml / python-pptx via pip.