autos.skills.powerPoint 库模块帮助文档

autos.skills.powerPoint 成员列表 #

PowerPoint/WPS 自动化；PPTX 读取与资源导出统一复用 fsys.openXml。
不需要安装 Office 的入口：listPptxEntries,listPptxMedia,extractTextFromPptx,extractPptxMedia。

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.closePresentation(presentation,saveChanges=false) #

关闭文稿；可先保存。

autos.skills.powerPoint.createPresentation(startIfMissing=true,visible=true) #

通过 Office/WPS 创建演示文稿。

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

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，返回 Application COM 对象；失败返回 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.saveAs(presentation,path,format,overwrite=true) #

通过 Office/WPS 另存文稿；format 为名称或数值。

autos.skills.powerPoint.version #

技能包版本。

Markdown 格式 Autos 技能包提示词（skill.md）