| name | dsh-office |
| description | 生成、读取、编辑 Office 文档（xlsx 电子表格 / PDF / pptx 演示文稿 / docx 文档）——原生渲染，中文友好，适合报告、合同、数据表、演示文稿等交付场景 |
| triggers | ["excel","xlsx","表格","电子表格","spreadsheet","pdf","报告","合同","文档","export","pptx","ppt","演示","幻灯片","presentation","slide","docx","word"] |
dsh-office（Office 文档工具）
@huiliyi37/dsh-office 为 DeepSeek Harness 提供 14 个 Office 文档工具。参考 anthropics/skills（Apache 2.0）提炼。
工具总览
| 工具 | 用途 |
|---|
xlsx_write | 二维数组 → 新 .xlsx（公式单元格、表头加粗、列宽、数字格式） |
xlsx_read | 列出工作表 / 读指定表为 markdown 表格（range 分页、max_rows 截断带续读提示） |
xlsx_edit | 增表、改单元格（值或公式）、追加行 |
xlsx_recalc | 公式重算门禁：纯 TS 引擎求值全部公式，扫描 #REF!/#DIV/0!/#VALUE!/#N/A/#NAME?/#NUM! 并给位置；不支持的函数列为 warning |
xlsx_audit | 公式结构审计：静态启发式查"值扫描看不到"的问题（数组公式陷阱、SUM 漏行、公式被硬编码覆盖、同列公式不一致、自引用、字面除零） |
pdf_create | 内容块数组 → PDF（标题/段落/表格/列表/代码块，CJK 自动字体，页码可选） |
pdf_read | 按页提取 PDF 文本（--- Page N --- 标记，start_page/end_page 分页） |
pdf_merge | 多个 PDF → 一个（按给定顺序） |
pdf_split | PDF 拆分/抽取：默认每页一个文件，或按 "1,3,5-7" 抽取指定页 |
pptx_create | 幻灯片定义 → .pptx（7 种版式 + 主题 + 演讲者备注） |
pptx_read | 幻灯片文本 → markdown；include 可选附加结构（summary/layouts/images/tables：shape 名与 cm 坐标、图片目标、表格行列） |
pptx_edit | 现有 .pptx 文本查找替换（find/replace/slide，保留全部版式样式，适合改错字/更新数字） |
docx_create | 内容块数组 → .docx（标题/段落/表格/列表/代码块；可选条纹表格、页面背景色、对角文字水印） |
docx_read | 提取 .docx 文本进上下文 |
何时使用
- 用户要可交付文件（.xlsx/.pdf/.pptx/.docx），不是 Markdown 就够的场景
- 数据适合表格/图表呈现，或需要正式排版（报告、合同、演示）
- 需要从已有 Office 文件中提取内容进上下文（读回自查、审查导出结果）
纯文本/Markdown 能交付时不用——更轻、可 diff。
大文件读取纪律（重要）
xlsx_read 单次最多 500 行（默认 200），超出会截断并在末尾给出
Continue with range_start: "A{n}"——照提示继续读下一页，不要猜测范围；
需要更多行时显式传 max_rows（如 500）pdf_read 输出带页码标记且 8000 字符截断，超长时按
Continue with start_page: {n} 提示继续；只想看某几页时直接传 start_page/end_page- 不要为"读完整个文件"重复调用——按需读，读完相关部分就停
生成纪律
- 结构先行：数据用表格/列表呈现，不写流水句；PPT 每页一个主题
- 生成后自查：用
xlsx_read/pdf_read/pptx_read 读回产出，确认内容完整、无占位符（lorem / xxx / TODO）、中文渲染正常
- PDF 中文：系统无 CJK 字体时会显式警告——告知用户，建议装 Noto Sans CJK 或改用英文
- 正式交付：PDF 默认带
page_numbers: true；PPT 大演示加演讲者备注（notes 字段）
- DOCX 增强：机密/草稿文档用
watermark（如 {text:"机密", opacity:0.3}）；深色封面用 background_color；对比表格用 stripe:true（表头深蓝 + 交替行浅色）
公式纪律（xlsx 交付前必读）
写公式的交付物必须过两道门禁，不满足即视为未完成：
- 公式优先，不硬编码：合计、百分比、比率、差值一律用公式（
=SUM(B2:B9)），
不要用 Python/推理把结果算好写成数值——表格才能在源数据变化时自动重算
xlsx_recalc 至 status: success：每次写/改公式后运行
xlsx_recalc，errors_found 时按 error_summary 的 locations 修复后重跑xlsx_audit 处理每条 warning：修掉或确认是有意设计，禁止无说明整批放行。
常见类型：
array_formula_risk：MEDIAN(IF(区域>0, 区域)) 这类"聚合(IF(区域))"在 Excel 普通模式下会 #VALUE!（recalc 引擎与 Excel 语义不同）——改写成 MEDIAN(区域) / AVERAGEIF / AGGREGATE 等原生支持区域的写法range_gap：SUM(B3:B4) 漏了上方紧邻的数值 B2——把范围补上possible_overwrite：同列公式块首尾紧邻的裸数字可能是被覆盖的公式——确认或改回公式inconsistent_formula：同列多数公式是结构 A，少数行是结构 B——对齐self_reference / division_by_zero：直接修复
PPT 编辑纪律（pptx_edit）
- 先读后改：编辑现有 PPT 前先
pptx_read（含 include 结构信息）了解版式，再定位要改的文本
- 每个 op 用
find/replace，需要定点修改时传 slide（1-based）；默认输出回原文件，想保留原版用 output_path
pptx_edit 只改文本节点（<a:t>），不触碰布局、字体、配色——样式零破坏
PPT 生成方法论（重要）
- 一页一核心信息：能讲透一个想法就保留，讲不透拆页；"少字是叙事选择，空白是设计失误"
- 密度跟随目的：告知型可以信息密集（听众既听又读）；说服/激励型压低密度（听众主要听你说，幻灯片是广告牌不是文档）
- 先结构后视觉：动笔前先定叙事（现状→问题→方案 或 钩子→主体→回报），再谈配色排版
- 编辑已有 PPT：先读后改，保留模板的字体、配色、布局，不做无根据的风格变更
组合示例
- 周报：
xlsx_write 数据表 → xlsx_recalc + xlsx_audit 验证公式 → pdf_create 排版成报告
- 演示：
pptx_create 生成 → pptx_read 自查 → 修正再生成
- 合同/长文：
pdf_create 生成 → pdf_read 抽查关键页
