Agent Skill 核验档案

Office Transform

office-transform 是 cherryhq/cherry-studio 仓库提供的文档处理 Skill：用户指向 Office/PDF 文档中的结构化选区（xlsx 单元格范围、docx 段落、pdf 页面、pptx 幻灯片/形状/表格单元格），即可提取、转换或编辑，结果始终是派生的新文件，源文件只读、绝不修改。支持 xlsx 范围提取为 csv/markdown/xlsx、docx 段落提取与文本替换、pdf 页面提取、pptx 幻灯片/形状/表格单元格提取与编辑，以及 xlsx 定点单元格编辑。

适用任务

把 xlsx 工作表中的 A1:C10 范围提取为新的 csv 文件（office_extract.py --out 扩展名推断格式）
用 patch-copy 修改 xlsx 单元格 B2=42、C3='hello'，生成 report-updated.xlsx，源文件不变
提取 pdf 第 3 页为新的 pdf/txt/md 文件
用 python-pptx 逐 run 编辑幻灯片文本并保存到新路径（禁止整体赋值 .text）
从选区提取数据后用 openpyxl/python-pptx/python-docx 生成全新工作簿、演示文稿或文档

输入

xlsx/docx/pdf/pptx 源文件的绝对路径（相对路径会被拒绝）
结构化锚点 JSON：xlsx 的 {format,sheet,range}、docx 的 {format,paragraph,paraId,charRange}、pdf 的 {format,page,charRange}、pptx 的 {format,slide,nodeId,paragraph/tableCell}
聊天界面提供的 fenced selection-ref 块（含 path、anchor、excerpt、fileStamp）
用户用文字描述的区域（如 'sheet 2, columns A through C'）
xlsx 编辑的 cells 值（数字、字符串、布尔）、docx 编辑的整段新文本 text 及推荐 expectText 旧文本
XML 可存储的文本：单元格/段落文本中除制表符、换行、回车外的控制字符被拒绝（docx 段落连这三者也拒绝）

输出

派生的新文件，源文件从不被修改；脚本拒绝写入源路径或覆盖已存在文件
xlsx 提取可输出 xlsx/csv/md；docx 提取输出 docx/txt/md；pdf 提取输出 pdf（页副本）/txt/md；pptx 提取输出 txt/md
编辑后的副本，如 report.xlsx → report-updated.xlsx，按源名加操作后缀命名，写入会话工作区或用户指定位置
输出先暂存、成功后改名，失败运行不留残余文件，可在同一路径重试
脚本成功后打印写入的路径，需报告给用户；生成的新文档需重开验证后再报告成功

限制与检查

xlsx 提取读取计算值（data_only），公式单元格只给出上次保存的结果
docx 提取为 docx 只保留文本，不保留 run 样式
patch-copy 不重算公式，引用被编辑单元格的公式仍读旧缓存值（写入 fullCalcOnLoad 让 Excel 打开时重算）；替换公式会丢弃 calcChain.xml
共享/数组/数据表公式组的成员单元格拒绝编辑，需改用 openpyxl；超出网格（XFD 列或 1048576 行之后）的坐标也被拒绝
docx 段落编辑必须给出完整新段落文本，charRange 不收窄替换范围；段内额外 run 样式被展平；含书签、批注锚、域、图片、脚注/尾注引用、超链接、修订、内容控件、公式等超出允许形状的段落被拒绝；分页/分栏符被拒绝，纯换行 <w:br/> 可通过
pptx 编辑不经过 office_patch_copy.py，须逐 run 编辑，禁止在段落或形状级赋值 .text
anchor 的 excerpt 截断于 2000 字符，expectText 应取自不带 charRange 的整段提取；xlsx 的 excerpt 为制表符分隔而提取写 csv/md，需按单元格值比较，数字/日期格式差异不算锚点漂移
编辑前执行 fileStamp 新鲜度检查：用 os.stat 以整毫秒（st_mtime_ns//1_000_000）比较大小与 mtime，容差 2ms；文件已变则告知用户重新选择，绝不静默重锚

Office Transform

适用任务

输入

输出

限制与检查

AI 搜索

项目详情