dsh-office

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
• 不要为"读完整个文件"重复调用——按需读，读完相关部分就停

生成纪律

1. 结构先行：数据用表格/列表呈现，不写流水句；PPT 每页一个主题
2. 生成后自查：用 xlsx_read/pdf_read/pptx_read 读回产出，确认内容完整、无占位符（lorem / xxx / TODO）、中文渲染正常
3. PDF 中文：系统无 CJK 字体时会显式警告——告知用户，建议装 Noto Sans CJK 或改用英文
4. 正式交付：PDF 默认带 page_numbers: true；PPT 大演示加演讲者备注（notes 字段）
5. DOCX 增强：机密/草稿文档用 watermark（如 {text:"机密", opacity:0.3}）；深色封面用 background_color；对比表格用 stripe:true（表头深蓝 + 交替行浅色）

公式纪律（xlsx 交付前必读）

写公式的交付物必须过两道门禁，不满足即视为未完成：

1. 公式优先，不硬编码：合计、百分比、比率、差值一律用公式（=SUM(B2:B9)）， 不要用 Python/推理把结果算好写成数值——表格才能在源数据变化时自动重算
2. xlsx_recalc 至 status: success：每次写/改公式后运行 xlsx_recalc，errors_found 时按 error_summary 的 locations 修复后重跑
3. 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 抽查关键页