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

autos.skills.excel 成员列表 #

Excel 读取、查询、有限原生生成与既有普通 XLSX 受控编辑；保存值/结构/查询可用原生，精确显示/重算/复杂写入走 COM。
inspectXlsx/queryXlsx/findXlsxCells 需要 fsys.openXml 0.15.0+；writeXlsx 仅在调用时加载 builder；openXlsxEditor 仅在调用时加载受控 editor，支持 getCell/getRange/setCell/setRange/save/close，不计算公式。
旧 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.findXlsxCells(path,sheet,options) #

原生按保存值/公式正文查找，target=value/formula，op/value结构化匹配。
只扫描已存储c节点，不枚举不存在的空格；maxScanCells与limit分开。

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

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

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

原生结构与有界预览，默认20表/20行/20列；含全页存储格统计、表头候选、合并/隐藏/表/名称。
直接转发 fsys.openXml.xlsx.inspectWorkbook，数字限额0为不取。

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.openXlsxEditor(path,options) #

打开普通 .xlsx 的受控编辑会话；提供 getCell/getRange/setCell/setRange/save/close。源文件只读、默认拒绝覆盖公式/合并非主格/特殊公式/保护目标；内容改变会清除全簿公式缓存、删除 calcChain 并请求应用重算，不计算公式。失败不提交。

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

原生结构化条件查询，不依赖 Office/ACE，不解析 SQL/eval。
range、columns、where(all/any)、orderBy、offset/limit、aggregates；返回原行号/refs。
maxScanRows/maxScanCells 与 limit 分开；统计仅针对扫描匹配行；见 XLSX 查询指南。

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；保留旧字段。
支持 range、includeStructure、includeStyles、parseDates；日期解释只附加 interpretation，原始值不变。
不计算公式，不提供最终显示文本；旧 maxRows/maxColumns=0 仍表示未指定。

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 #

技能包版本

autos.skills.excel.writeXlsx(path,document,options) #

原生生成普通.xlsx并原子保存；支持多表、二维/显式单元格、字符串/数值/布尔/time、稀疏数据、显式公式及可选缓存；支持有限命名样式、行列/合并/冻结和 autoFilter 区域声明。普通字符串不因=前缀变公式；无缓存不写伪造0。失败不改目标；复杂样式/筛选条件/表对象/图表/重算仍走COM。

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