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

autos.skills.excel 成员列表 #

Excel 表格自动化技能包；优先 com.excel 操作 Office/WPS。
ZIP 入口基于 fsys.openXml.xlsx 0.5.0+；仅调用时加载读取器。
COM、SQL 与 auto 优先级保持不变。

autos.skills.excel.createWorkbook(startIfMissing,visible) #

新建工作簿并返回 Workbook COM 对象。

autos.skills.excel.extractTextFromXlsx(path,options) #

抽取已保存值文本，保留稀疏空格/行列分隔与旧 sheets 字段。
默认文本展开上限16MiB，不是流式读取；失败 null,err。

autos.skills.excel.extractXlsxMedia(path,outputDir,overwrite=true,options) #

兼容旧默认覆盖；false/0 不覆盖。
成功返回文件数组，第三值为原生明细；失败 null,err,partial。
CRC/限额校验后逐文件提交，同名预检，不是整批事务。

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

获取或创建 com.excel 对象，返回值可继续使用 Excel COM / VBA API。

autos.skills.excel.listSheets(book) #

列出工作表信息数组。

autos.skills.excel.listXlsxEntries(path,pattern,options) #

识别工作簿并列真实 ZIP 条目；兼容 path,isDir,size,formattedSize。

autos.skills.excel.listXlsxMedia(path,options) #

列 xl/media/ 和实际主部件同级 media/，含子目录，不含目录项。
保留 path,name,ext,size,formattedSize；不构建完整媒体关系图。

autos.skills.excel.listXlsxSheets(path,options) #

按实际关系和顺序列 index,name,sheetId,rid,state,path 等，含隐藏页。
图表页等非 worksheet 页可列出，但不能读取单元格。

autos.skills.excel.minAutos #

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

autos.skills.excel.openWorkbook(path,startIfMissing,visible,readOnly) #

打开工作簿并返回 Excel Workbook COM 对象。

autos.skills.excel.readSheet(path,sheet,options) #

一站式读表，默认 auto 优先 COM；method 可指定 com/zip/sql。
ZIP 默认首行标题/trim/跳过空行，保留 rows.fields 与 rows.info；asMatrix=true 返回原始矩阵且遵守限额。
ZIP rows.info 含 warnings/truncated；不重算公式或还原显示格式。

autos.skills.excel.readWorkbook(path,options) #

一站式读取多个工作表，默认 auto 优先 COM；返回 path,method,sheetCount,sheets。

autos.skills.excel.readWorkbookByZip(path,options) #

基于 fsys.openXml.xlsx，一次开包读取工作簿。
旧内容限额 0 表示未指定；默认坏页返回 null,err,partial，keepErrors=true 保留错误项；查看 warnings/truncated/errorCount/complete。

autos.skills.excel.readXlsxSheet(path,sheet,options) #

不启动 Office，返回二维保存值 rows 与 cells；保留旧字段。
新增 formula,hasCachedValue,styleIndex,date1904,warnings/truncated 等信息；不计算公式，不还原格式。
支持序号/名称/实际页描述，尾部 options 透传包限额。

autos.skills.excel.rowsToTable(rows,options) #

二维数据转表数组；支持 header,fields,maxRows,maxColumns,startIndex,includeRowNumber 等。
保留 0/false；稀疏行可用普通 length 字段声明列宽。

autos.skills.excel.sheetToTable(sheet,options) #

将工作表 UsedRange 转为表数组，默认首行作字段名。

autos.skills.excel.tableToSheet(sheet,data,options) #

将二维数组或表数组写入工作表。

autos.skills.excel.version #

技能包版本

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