dsh-ppt-composer

DeepSeek Harness 的 AI PPT 生成助手 Cordis 插件。在对话中完成 PPT 的创作全流程：内容确认 → 多页结构生成 → 媒体（图片/视频/图表）→ 主题 v2（每页独立配色/字体/SVG 装饰/入场动画）→ 实时浮动预览 → 独立 HTML 导出。

• Host 端：按会话存储 PPT、12 个模型工具（ppt_*）、ppt/state / ppt/export RPC、独立 HTML 导出器、工作流系统提示词。
• Client 端：shell.overlay 中的可拖拽浮动预览面板（可调大小、翻页、缩略图、导出、toast 提示）、全屏演示层、会话头部开关按钮。

功能特性

目录结构

dsh-ppt-composer/
├── package.json            # dsh 插件包元数据（exports、dsh 字段、Cordis peer 依赖）
├── README.md
├── LICENSE                 # MIT
├── .gitignore
├── src/
│   ├── host.js             # Host 插件体（权威源码，即 code.host 原文）
│   ├── client.js           # Client 插件体（权威源码，即 code.client 原文）
│   └── index.js            # 入口：读取两份源码并以字符串导出，供 cordis_define 使用
└── examples/
    ├── sample-slides.json  # 示例幻灯片结构（含时间线 decor 与每页主题）
    └── demo/               # 测试导出的 HTML（gitignore，可再生成）

安装与加载

本仓库以 动态 Cordis 插件 形式分发：src/host.js 与 src/client.js 就是 cordis_define 所需的 code.host / code.client 原文（已验证可运行），单一事实来源。

方式一：动态加载（推荐，开箱即用）

在 DSH 会话中让模型执行 cordis_define：

import { definePayload } from './src/index.js'   // 或直接读取 src/host.js / src/client.js

definePayload()
// => { code: { host: <src/host.js 内容>, client: <src/client.js 内容> } }

把 definePayload() 的返回传给 cordis_define({ plugin: { kind: 'new', idPrefix: 'pptco' }, …, code })， 随后 cordis_run 激活并批准运行。激活后当前会话即可使用全部 ppt_* 工具与预览面板。

重装（DSH 重启后）： 动态插件注册表是进程内内存，重启即失。仓库已预生成 install-payload.json（cordis_define 的完整载荷，含 code.host / code.client 原文， 与 src/ 字节级一致）。重装时读取该文件、把 plugin / name / purpose / code 原样传入 cordis_define 即可，无需转写源码。修改过 src/ 之后，重新生成载荷：

npm run make-payload   # 或 node scripts/make-payload.mjs

方式二：静态挂载（需少量适配）

DSH 部署通过 profile 的 cordis.patch.yml 挂载插件。src/host.js / src/client.js 目前使用动态运行器的全局 harness（defineTool / registerTool / handle）与 host.call 桥。静态挂载时需将：

• harness.defineTool / harness.registerTool → ctx.tools.register(toolDefinition)；
• harness.handle('ppt/state'|'ppt/export') → 通过会话/客户端 RPC 服务暴露；
• Client 的 host.call('ppt/…') → 替换为对应静态 RPC 通道。

（后续版本可提供静态适配层；欢迎 PR。）

使用流程（模型工作流，已内置系统提示词）

1. 用户表示要制作 PPT 或粘贴文案 → AI 确认主题/受众/结构，并确认 长宽比 与是否需要 页间过渡动画。
2. 确认后 ppt_create 一次性创建（空白默认主题、基础排版，不上色）。
3. ppt_slide_add / ppt_slide_update / ppt_slide_remove 微调，ppt_get 复核。
4. 内容确认后询问配色 → ppt_theme_create → ppt_theme_apply；不满意 ppt_theme_update 微调。
5. 满意后 ppt_export 导出独立 HTML 到会话工作区。

工具参考

数据结构

幻灯片 slide

{
  id: 's1',                       // 可选，唯一标识
  layout: 'cover',                // cover | title | content | two-column | section | closing | blank
  title: '…', subtitle: '…',
  bullets: ['…'],                 // 要点（content）
  paragraphs: ['…'],              // 段落（content）
  columns: [{ heading: '…', bullets: ['…'] }],  // 双栏
  quote: '…', quoteAuthor: '…',   // 引言
  code: '…',                      // 代码块
  image: 'https://… | data:…',    // 图片（content）
  imageAlt: '…',
  video: 'https://…',             // 视频（content）
  chart: { labels: ['Q1'], values: [42] },      // 柱状图（content）
  decor: '<path …/><text …/>…',   // SVG 内联装饰，整页下层
  theme: { colors?: {…}, fontFamily?: '…', fonts?: { heading?, body? }, radius?: 8 },  // 本页主题覆盖
  entrance: 'fade',               // fade | rise | zoom | none
  align: 'center',                // center | top（带 decor 默认 top）
  note: '演讲备注'                 // 不渲染
}

主题 theme

{
  id: 'slate', name: '石板夜',
  colors: {
    background: '#0f172a',   // 背景
    foreground: '#f1f5f9',   // 主文字
    accent: '#60a5fa',       // 强调色
    muted: '#94a3b8',        // 次要文字
    surface: '#1e293b',      // 卡片底色
  },
  fontFamily: '',                      // 可选，正文默认
  fonts: { heading: '…', body: '…' },  // 可选，标题/正文分开
  radius: 8,
}

所有颜色必须为十六进制。文档主题 + 每页 slide.theme 合并后渲染；预览与导出 （1920×1080 / 1920×1440 固定画布）共用同一套排版规则，所见即所得。

导出文件说明

ppt_export 生成的 HTML：

• 与预览完全相同的 1920×1080（16:9）/ 1920×1440（4:3）画布与排版；
• 自包含（无外部依赖），<img>/<video> 引用外部 URL 时需联网，data URI 则完全离线；
• 键盘翻页：← → 空格 PgUp/PgDn Home End；
• 右下角「上一页 / 下一页」翻页按钮组；窗口缩放自适应居中；
• 主题/装饰/入场动画与预览一致。

开发与测试

• 纯 JavaScript + React（React.createElement），无需构建步骤。
• 修改 src/host.js / src/client.js 后，重新通过动态加载即可生效（更新时用 cordis_run mode:"update"）。
• 快速自测：按上文「使用流程」走一遍 创建 → 读取 → 主题 → 导出，并在预览面板核对翻页/缩放/主题。
• 示例结构见 examples/sample-slides.json（含折线时间线 decor 与每页独立主题）。

许可

MIT © 2026 dsh-ppt-composer contributors