SuperAPI AI 工具集

apple-flow-numbers

办公与效率

查看项目

更新于 10-15 21:10

技能介绍

用途:通过本地 CLI 可靠地创建和更新 Apple Numbers 文档,替代临时拼凑的 AppleScript。所有命令基于 python3 skill/apple-flow-numbers/scripts/numbers_tools.py,常用子命令包括 numbers_preflight、numbers_create、numbers_create_workbook、numbers_add_sheet、numbers_append_rows、numbers_style_apply。

主要能力:numbers_create 自动扩展列以容纳全部表头;numbers_create_workbook 依单份 JSON 规格构建多工作表文件;numbers_add_sheet 向已有工作簿新增已初始化工作表;numbers_append_rows 依最宽新行自动扩展列。插入模式有 after-data(追加到最后一条非空数据行之后,适合日志与追踪表)、after-headers(插入首条数据行并下移原数据)、at-end(追加到表格物理末尾)。样式支持背景色、文字色、字体名与字号、对齐(left|center|right|justified|natural)、数字格式(automatic|currency|percentage|scientific|fraction|text)、文本换行及行高列宽。

用法:先运行 numbers_preflight 确认返回 ok:true。路径必须为绝对路径且扩展名 .numbers。表头须为 JSON 字符串数组,行数据须为 JSON 数组,推荐数组套数组形式。样式操作的目标与样式参数均为 JSON 对象,目标索引从 1 开始。numbers_create_workbook 需 {"sheets":[...]} 且 sheet_name 唯一;numbers_add_sheet 需含 sheet_name 与非空 headers 的对象。追加后应校验返回 JSON 中的 ok、start_row、insert_after_row,并核对首尾行。

限制与排错:路径非绝对、目标文档不存在、sheet 或 table 名称不匹配会报错。连接无效或 AppleScript 失败时先跑 preflight;目标解析顺序为 NUMBERS_APP_TARGET、NUMBERS_APP_BUNDLE_ID、Numbers Creator Studio 候选、旧版 Numbers 回退,必要时显式导出环境变量或脱离严格沙箱重试。行位置异常时改用 --position after-data。本技能面向 macOS 上的 Apple Numbers,其他平台或非 .numbers 格式暂未提供支持。