# autos.skills.powerPoint 库模块帮助文档 ## autos.skills.powerPoint 成员列表 # PPT/PPTX 任务优先原生生成、读取、预检与有限编辑，统一复用 fsys.openXml。 Office/WPS COM 可按需用于制作、嵌入媒体及渲染导出；原生优先，不限制混合使用。 ### autos.skills.powerPoint.addBlankSlide(presentation,index) # 添加空白页；index 默认在末尾。 ### autos.skills.powerPoint.addTextBox(slide,text,left=60,top=60,width=600,height=80,options) # 添加文本框，坐标单位为 point；options 可设置字体、颜色与对齐。 ### autos.skills.powerPoint.addTitleSlide(presentation,title,subtitle,index) # 添加含标题与副标题的页面。 ### autos.skills.powerPoint.checkPptx(slides,options,checkOptions) # 生成前版式预检，转发 builder.check；参数同 writePptx，不启动 Office、不写文件。 返回 {ok,issues,counts,errors,warnings,missingFonts}；code: overflow/tableGrow/offSlide/overlap。输入不合法 null,err。 ### autos.skills.powerPoint.closePresentation(presentation,saveChanges=false) # 关闭文稿；可先保存。 ### autos.skills.powerPoint.createPresentation(startIfMissing=true,visible=true) # 通过 Office/WPS 创建演示文稿。 ### autos.skills.powerPoint.editPptx() # [返回对象:openXmlPptxEditorObject](#openXmlPptxEditorObject) ### autos.skills.powerPoint.editPptx(path,options) # 打开有限编辑会话，转发 pptx.editor.open；文本替换、页序/复制/删除、表格填值/合并、图片及显式动画/切换替换。另存并 close，不改源件；不是任意已有图表数据编辑器。 ### autos.skills.powerPoint.exportAsPdf(presentation,path,overwrite=true) # 通过 Office/WPS 导出 PDF。 ### autos.skills.powerPoint.exportSlidesAsImages(presentation,dir,format="png",width=0,height=0) # 通过 Office/WPS 导出各页图片。 ### autos.skills.powerPoint.extractPptxMedia(path,outputDir,overwrite=true,options) # 统一调用 fsys.openXml.pptx.extractMedia，返回本次已导出的文件数组。 旧入口默认允许覆盖；overwrite=false 跳过已有文件。同名平铺冲突报错。 CRC、长度、限额或写入失败返回 null,err,partial，不把半成品当成功；partial.files 为已提交文件。 仅复制原始字节，不执行或转码。options 可指定读取限额。 ### autos.skills.powerPoint.extractTextFromPptx() # [返回对象:openXmlPresentationObject](#openXmlPresentationObject) ### autos.skills.powerPoint.extractTextFromPptx(path,includeNotes=true,options) # 统一调用 fsys.openXml.pptx.read；按实际页序读取正文、基本表格与备注。 旧字段保留；notes 逐页对齐，noteCount 为实际含备注部件的页面数；增加 pages,warnings。 ### autos.skills.powerPoint.getActivePresentation(startIfMissing=false) # 获取活动演示文稿 COM 对象。 ### autos.skills.powerPoint.getActivePresentationInfo(startIfMissing=false) # 获取活动演示文稿信息。 ### autos.skills.powerPoint.getApp(startIfMissing=false,visible=true) # 连接或启动 Office/WPS，返回 com.powerPoint 透明代理，继承 Application 的全部方法/属性；仅 COM 编组时需要 .Application。失败返回 null,err。 ### autos.skills.powerPoint.getAppInfo(startIfMissing=false) # 返回应用名称、版本、文稿数与活动文稿名。 ### autos.skills.powerPoint.getPresentationInfo(presentation) # 返回 name,fullName,path,slideCount,saved。 ### autos.skills.powerPoint.isRunning() # 检查 PowerPoint/WPS 是否已运行。 ### autos.skills.powerPoint.listPptxEntries(path,pattern,options) # 使用 fsys.openXml.pptx 列举真实 ZIP 条目，包含目录。 保留 path,isDir,size,formattedSize；增加 name,compressedSize,contentType；pattern 为 aardio 模式串。 options 可传 fsys.openXml 读取限额；并非整包内容校验。 ### autos.skills.powerPoint.listPptxMedia(path,options) # 列出标准 ppt/media/ 及主部件同级 media/ 下的文件，含子目录；不含目录项。 保留 path,name,ext,size,isDir,formattedSize；增加 partName,contentType,compressedSize。 不是按页引用分析，不保证发现任意路径的媒体。 ### autos.skills.powerPoint.openPresentation(path,startIfMissing=true,withWindow=true,readOnly=false) # 通过 Office/WPS 打开演示文稿。 ### autos.skills.powerPoint.quitApp(app,owned,timeout=15000) # 只退出 startApp 启动的实例；仍有打开的文稿时拒绝，不替调用方关闭。 只等待自然退出，不处理加载项或退出对话框，不自动点击、不强制结束进程。 为保持返回结构兼容，dismissed 始终为 0。 成功返回 true,{exited,dismissed,ms}；失败 null,err。 ### autos.skills.powerPoint.saveAs(presentation,path,format,overwrite=true) # 通过 Office/WPS 另存文稿；format 为名称或数值。 ### autos.skills.powerPoint.startApp(visible=false) # 启动验收/导出专用的新 PowerPoint 实例，返回 app,owned；失败 null,err。 已有任何 PowerPoint 进程时拒绝：COM 激活可能复用已有进程，后台实例也可能注册 ROT，不能据此判断归属。 owned.pid 为创建前后新增的进程号；只把 owned 交给 quitApp。 ### autos.skills.powerPoint.version # 技能包版本。 ### autos.skills.powerPoint.writePptx(path,slides,options) # 声明式生成 PPTX，转发 builder.write；支持文本/形状/PNG或JPEG/表格与合并/二维图表/备注/整形状及逐段落动画、Morph（fade 回退）、标准版式、页码和链接。默认不覆盖；成功完整路径，失败 null,err。