DeepTutor XLSX 技能

这个 Skill 能做什么，适合哪些场景？

这是 DeepTutor 内置的办公技能之一，教模型用 Python 的 openpyxl 库处理 .xlsx/.xlsm 文件和 .csv/.tsv 表格。它可以读取、创建或编辑工作簿，包括单元格数据、公式、样式、图表、合并单元格和多表工作簿。技能的核心价值在于把 openpyxl 的常见陷阱（尤其是公式不会被计算的缓存值问题）写成了明确的操作规则，让模型在沙箱里一次跑对。它要求运行环境提供可执行 Python 代码的沙箱（DeepTutor 各部署形态默认都带），可选配合 LibreOffice 做公式重算。

• 用 openpyxl 读取 .xlsx/.xlsm：逐行流式读取大文件，或用 data_only=True 读取公式缓存的计算结果
• 从零创建工作簿：写入数据、公式、字体/填充/对齐样式、数字格式、冻结窗格、多表结构，并可立即重新打开校验输出
• 编辑已有工作簿时保留原有样式、公式、合并单元格和图表，不经过 pandas 全量重写
• 创建柱状图/折线图/饼图/散点图，并用 write-only 模式流式导出大数据量
• 处理 .csv/.tsv 的批量转换与清洗，对脏数据先取样再规范化
• 写入真实公式时通过 LibreOffice (soffice) 重算缓存值，或改写为 Python 计算出的静态数字，并扫描 #REF!/#DIV/0! 等错误值验证输出

如何安装这个 Skill？

该技能是 DeepTutor 仓库内置技能（deeptutor/skills/builtin/xlsx/SKILL.md），随主程序安装，无需单独安装。先装好 DeepTutor 运行环境：

DeepTutor（PyPI 完整安装）

pip install -U deeptutor
deeptutor init
deeptutor start

DeepTutor（源码安装）

git clone https://github.com/HKUDS/DeepTutor.git
cd DeepTutor
python3 -m venv .venv && source .venv/bin/activate
python -m pip install -e .
deeptutor init
deeptutor start

DeepTutor（Docker）

docker run --rm --name deeptutor -p 127.0.0.1:3782:3782 -v deeptutor-data:/app/data ghcr.io/hkuds/deeptutor:latest

注意：技能运行依赖代码执行沙箱（默认开启），若在 data/user/settings/system. 中把 sandbox_allow_subprocess 设为 false，本技能将无法产出文件。

如何使用这个 Skill？

技能由模型按需读取（SKILL.md 是按需加载的 playbook），在聊天中给出涉及 Excel/CSV 的任务即会触发。执行时模型通过 exec 工具提交完整的 Python 源码（openpyxl），要求一次调用内完成创建、保存、重开和校验，后续调用可引用同一相对文件名继续修改。关键选项：若交付物只需正确数值，写 Python 计算出的静态数字；若需要活公式模型，写真实公式并尽量用 soffice 重算缓存值；读取公式计算结果用 data_only=True，且切勿对以该模式加载的工作簿调用 save()（会永久丢失公式）。产物以下载链接形式交回。

这个 Skill 有哪些优点和局限？

这个 Skill 与同类方案有什么区别？

与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。

常见问题