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

autos.skills.word 成员列表 #

Word 文档自动化技能包：Office/WPS COM 实现保持独立；
OpenXML 读取、结构化生成与受控编辑统一委托 fsys.openXml.docx，按调用时加载。

autos.skills.word.editDocx(path,options) #

打开原生 DOCX 受控编辑会话，转发 fsys.openXml.docx.editor.open；不启动 Office/WPS，返回会话，需 close。

autos.skills.word.extractDocxMedia(path,outputDir,options) #

委托原生安全媒体导出；旧入口仍默认覆盖（overwrite=false 才跳过）。
返回已导出文件数组，第三返回值为 outputDir/files/skipped/truncated 明细；失败 null,err,partial。
maxMedia 限制成功导出数，跳过不计数；逐文件提交，不是整批事务。

autos.skills.word.extractTextFromDocx(path,options) #

委托原生 DOCX 文本读取；保留 path,method,paragraphCount,paragraphs,text。
字节截取不切断 UTF-8 字符，额外返回 warnings/truncated。

autos.skills.word.getApp(startIfMissing,visible,alerts) #

获取或创建 com.doc 对象，返回值可继续使用 Word/WPS COM 与 VBA 对象模型。

autos.skills.word.getDocxCoreProperties(path,options) #

按真实包关系读取核心与扩展属性，保留 path,method="zip"；错误不再吞掉。

autos.skills.word.listDocxEntries(path,pattern,options) #

委托原生 ZIP 清单；保留 path,isDir,size,formattedSize，含真实目录项。

autos.skills.word.listDocxMedia(path,options) #

委托原生媒体清单；保留包内 path,name,ext,size,formattedSize，不含目录项。

autos.skills.word.minAutos #

技能包支持的最小 AA(aardio autos) 版本

autos.skills.word.openDocument(path,options) #

打开 Word 文档并返回 Document COM 对象与 com.doc 包装对象。

autos.skills.word.readDocument(path,options) #

一站式读取 Word 文档，默认优先 COM，失败后对 docx 使用 ZIP/Open XML 降级。

autos.skills.word.readDocumentByZip(path,options) #

委托 fsys.openXml.docx.read；保留 method="zip"、info/paragraphs/tables/media 等字段。
不启动 Office；新增 warnings/truncated 与原生明细，损坏包返回 null,err 而非空成功。
兼容旧 keepEmptyParagraphs=false、表格 trim=true、内容限额 0 表示未指定。

autos.skills.word.readDocxParagraphs(path,options) #

委托原生 DOCX 段落读取；返回数组，成功第三返回值为 warnings。

autos.skills.word.readDocxTables(path,options) #

委托原生 DOCX 表格读取，保留 path/source/rows/rowCount/columnCount。
firstRowAsHeader/asObjects 仍由既有 rowsToTable 适配，成功第三返回值为 warnings。

autos.skills.word.readWord(path,options) #

readDocument 的别名；COM/ZIP 分流策略保持原样。

autos.skills.word.version #

技能包版本

autos.skills.word.writeDocx(path,document,options) #

原生结构化生成，转发 fsys.openXml.docx.builder.write；成功返回完整路径,null,report，默认不覆盖。

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