本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-office

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @huiliyi37/dsh-office

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• • id: dsh-office
• • id: dsh-office

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装上以后能用多少个工具？分别在哪些领域？

默认装载全部 14 个工具，分为四族：xlsx（read/write/edit/recalc/audit）、pdf（create/read/merge/split）、ppt（create/read/edit）、docx（create/read）。如果不需要某个族，可以在 profile 的 cordis.patch.yml 里把对应开关设为 false。

安装在旧版 dsh 上为什么会所有工具都报 "Cannot read properties of undefined (reading 'prepare')"？

本插件要求 dsh ≥ 0.1.0-rc.5（对应 @deepseek-ai/dsh-tools ≥ 0.1.0-rc.5）。如果宿主核心的 dsh-tools 是 0.0.1 系列，npm 会重复装一份 dsh-tools，所有工具调用都会因工具工厂缺失 prepare 而崩溃。升级宿主到 0.1.0-rc.5+ 再装即可。

生成的中文 PDF 出现方框或空白怎么办？

pdfkit 自带字体不含中文字形。本插件会按顺序探测 PingFang、微软雅黑、Noto Sans CJK 等系统字体并自动注册；找不到时会在返回内容里给出 ⚠ 警告，但不会自动装字体，请手动安装 Noto Sans CJK 或改用英文内容。

写完带公式的 .xlsx 之后还需要做什么？

必须跑两次门禁才算完成：先跑 xlsx_recalc 让纯 TS 引擎重算并扫描 #REF!/#DIV/0!/#VALUE!/#N/A/#NAME?/#NUM! 等错误值，按 error_summary 位置修复直到 status 为 success；再跑 xlsx_audit 静态扫描公式结构（数组公式陷阱、SUM 漏行、公式被硬编码覆盖、同列公式不一致、自引用、字面除零），每条 warning 必须确认或修复，禁止批量放行。

pptx_edit 改文本会破坏原版式吗？

不会。该工具只替换 <a:t> 文本节点，不触碰布局、字体、配色与图形，适合改错字、改数字；批量替换可省略 slide 参数只改当前页或全部幻灯片；想保留原文件可指定 output_path 输出到新路径。

pdf_merge 和 pdf_split 支持加密 PDF 吗？

不支持。当前实现基于纯 JS 的 pdf-lib，加密/解密被有意省略（pdf-lib 尚未提供加密 API，引入系统 qpdf 会破坏零原生依赖）。如需处理加密 PDF 请先用其他工具解密后再传入。

大文件读取会被截断吗？怎么续读？

会被截断并给出续读提示。xlsx_read 单次默认 200 行（最多 500），超过会在末尾返回 Continue with range_start: "A{n}" 提示；pdf_read 输出带 --- Page N --- 标记且 8000 字符截断，超长时返回 Continue with start_page: {n}。按提示分页调用即可，不要循环重试读完整个文件。

怎么卸载？

执行 dsh plugin --profile <名称> remove @huiliyi37/dsh-office 即可。如果是通过手动方式把包放到 node_modules 并在 cordis.patch.yml 中 - insert 引用的，从 patch 文件里删掉 dsh-office 那条即可。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.5+
• Node: 未声明
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则