wps-presentation

用 PowerShell + COM 驱动 WPS 演示。零依赖：除了 WPS Office 本身什么都不需要，免费个人版可用。

前置：先读 powershell-windows skill（5.1 / BOM / 32-64 位 COM 规则）。

何时用 / 何时不用

用：目标机器装的是 WPS（金山办公），要新建 / 改写 .pptx / .dps、插图、转 PDF。 不用：目标是 Microsoft PowerPoint（用通用 powerpoint skill）；云文档（COM 只碰本地文件）；Windows 服务 / Session 0（WPS 需要已登录的交互式桌面）。

⚠️ 先看这条：演示必须亮着窗口跑

$wpp.Visible = $false 在 WPS 演示上会直接报 HRESULT E_FAIL（2026-09-28 真机验证）。 没有隐藏运行的办法——动手前先告诉用户："WPS 会弹出来一下，跑完自动关。" scripts/Invoke-WpsSession.ps1 已经处理了这点（它永远不碰 Visible）。

先跑脚本，不要手拼 COM

scripts/ 里是可直接运行的脚本，输出 OK: / FAIL: 行。优先调它们：

路径规则：Agent 的 cwd 通常是用户项目，不是 skill 目录——永远用绝对路径调脚本。 先按 Claude → Codex → Cursor 的顺序探测实际安装位置（不要用相对路径 scripts/...，会找不到文件）：

$skillDir = @(
    "$env:USERPROFILE\.claude\skills\wps-presentation",
    "$env:USERPROFILE\.codex\skills\wps-presentation",
    "$env:USERPROFILE\.cursor\skills\wps-presentation"
) | Where-Object { Test-Path "$_\scripts\Invoke-WpsSession.ps1" } | Select-Object -First 1
if (-not $skillDir) { throw "wps-presentation skill 未安装：请先跑仓库里的 install.ps1" }

自定义逻辑示例：

$sb = {
    param($wpp)
    $pres = $wpp.Presentations.Add()
    try {
        $pres.PageSetup.SlideWidth = 960    # 16:9（单位：磅）
        $pres.PageSetup.SlideHeight = 540
        $s = $pres.Slides.Add(1, 1)
        $s.Shapes.Title.TextFrame.TextRange.Text = "你好"
        Release-WpsObject $s               # 倒序释放：先业务对象
        $pres.SaveAs("$env:TEMP\a.pptx")
    } finally {
        $pres.Close()
        Release-WpsObject $pres            # …最后释放文稿；$wpp 由包装器释放
    }
}.GetNewClosure()
$skillDir = @(
    "$env:USERPROFILE\.claude\skills\wps-presentation",
    "$env:USERPROFILE\.codex\skills\wps-presentation",
    "$env:USERPROFILE\.cursor\skills\wps-presentation"
) | Where-Object { Test-Path "$_\scripts\Invoke-WpsSession.ps1" } | Select-Object -First 1
if (-not $skillDir) { throw "wps-presentation skill 未安装：请先跑仓库里的 install.ps1" }
& "$skillDir\scripts\Invoke-WpsSession.ps1" -Script $sb

Release-WpsObject 由包装器提供。释放顺序永远是获取的逆序（Shape → Slide → Presentation → App），最后 [GC]::Collect()。

参考表

• references/layout-ids.md — 版式 ID、空白版式回退策略
• references/recipes.md — 插图、备注页、按页导出 PNG 降级、表格出图→贴进 PPT

真机验证过的坑（2026-09-28，Win11 + WPS 个人版）

• ProgID 用 KWPP.Application，老版本回退 Wpp.Application；永远不要用 PowerPoint.Application 碰运气。
• 禁止 $wpp.Visible = $false（E_FAIL）。想低调可以试 $wpp.WindowState = 2 最小化（⚠️ 未验证）。
• DisplayAlerts=0 照设，弹窗（图片路径不存在 / 保存冲突）不屏蔽会卡死。
• 版式 ID 在 WPS 模板下可能和 PowerPoint 不一致：拿不准就用空白版式 + 手写形状。
• Placeholders.Item(2) 在某些模板上会抛：try/catch 包住，失败回退到文本框。
• wpp.exe 退出干净（同机器上 wps.exe / et.exe 会残留，wpp.exe 不会），但 PID 快照清理照做。
• 用户已经开着 WPS 演示时：跳过 Quit()，只关自己打开的文稿。

安全硬规则

• 默认只写 $env:TEMP 或用户点名的路径；不扫描、不遍历 C:\Windows、桌面等用户没提到的位置。
• AddPicture 前先 Test-Path 确认图片存在。
• Stop-Process 只杀 PID 快照差集。

待验证 ⚠️

• Slide.Export 导出 PNG（对象模型里有，真机未确认）：先试单页，失败则整份 SaveAs PDF 降级。
• 免费版导出 PDF 是否带 "WPS Office" 水印（社区传闻，未第一手确认）。