Univer 办公套件（dsh-univer-office，作者 dream-num）把电子表格、文档、幻灯片、多维表格（Base）和画布（Board）放进同一个 DSH 运行时：446★、综合分 67.5、周下载 11,709，许可 Apache-2.0，运行要求 Node.js >= 22.19.0，支持的 DSH 版本是白名单三档------0.1.5-rc.3、0.1.7-rc.1、0.2.0-rc.1。日常用法是「告诉 Agent 你想要什么」，DSH 会自动在十几个内置工具之间做选择。
先说清一件事：站点对它的信任档位是「仅索引 」------本站尚未对其实装验证，仅收录元数据；「装得上吗」区块写的是静态安装检查通过（未做真实安装） 。所以下面的顺序是整理出来的排查路径 ，不是「我们装完踩过一遍」的现场记录。想先横向对照同类插件的中文清单与安装形态，见 完整插件清单与汉化避坑指南。
排查顺序：四层，从最常见的往下走
- 命令跑完了，但界面里根本找不到办公套件 → 坑一。
- 装的时候包名选错，装了个空壳 → 坑二。
- 编辑都正常，一截图或一打印 PDF 就失败 → 坑三。
- 小文件无事，几十页的大文档必挂 → 坑四。
每层都先确认上一层，跳层最容易把「没重启」误判成「插件坏了」。
坑一 装完没反应：是没重启 DSH
现象。 在终端跑完 dsh plugin --profile web add dsh-univer-office，命令正常返回，回到 DSH 浏览器页面，侧边栏「插件」里找不到 Univer 办公套件，Agent 也不调用任何办公工具。
原因。 README 原文写得很直白：运行中可以执行安装命令，但当前 DSH 进程不会自动加载新插件。写盘成功不等于正在跑的进程挂载了新插件------你看到的界面状态属于旧进程，和「到底装没装上」无关。
解决。 固定顺序：先在启动 DSH 的终端按 Ctrl+C 停止进程 → 执行安装命令 → 用 dsh web 重启 → 在浏览器页面按 Cmd+R / Ctrl+R 刷新。刷新别省。卸载对称：dsh plugin --profile web remove dsh-univer-office。
坑二 装到了仿冒占位包
现象。 换了个「看起来更像官方」的包名去装，命令能跑完，但装完什么功能都没有；或者干脆报包不存在。
原因。 README 有一段官方包名警告：以下相似名称是本项目为防止仿冒而保留的 deprecated npm 占位包，不包含插件代码 ------dsh-univer-plugin、dsh-univer-office-suite、dsh-univer-suite、univer-office-suite、univer-office。这五个名字都占着位置，但里面没有实现。把「名字像」当成「就是它」，装到的就是空壳。
解决。 只装 dsh-univer-office ，别的一个都别碰。README 说明本包 npm 账号已与仓库 dream-num/dsh-univer-office 校验一致，装前顺手核对。已装错的用 remove 卸掉重来。
坑三 截图 / PDF 打印 / Slide 布局检查失败
现象。 纯编辑流程一路顺畅，一旦 Agent 调用 univer_screenshot、univer_print_pdf、univer_lint 或 univer_compile_svg，就报错、卡住或直接超时；同样的任务在别人机器上却能跑通。
原因。 README 原文：「截图、PDF 打印、Slide 布局检查和 SVG 文字度量需要本机 Chromium 系浏览器。」这几类工具不是纯计算，要真的把内容渲染进浏览器再出图或出 PDF。机器上既没有 Chrome/Chromium 也没有 Edge 时，这条链路就没有可用的执行体------编辑能用、审阅渲染不能用，正是典型症状。
解决。 装一个 Chromium 系浏览器即可：Chrome/Chromium 与 Microsoft Edge 会被自动探测 ，通常不需要额外配置。如果浏览器装在非默认位置，或你用的是 Edge 而探测不到，走两条显式途径之一指定可执行文件路径------配置项 browserExecutablePath（设置后优先于 环境变量），或者环境变量 UNIVER_RENDER_BROWSER（例如 Windows 上指向 Edge）。
坑四 大文档撞上截图与操作上限
现象。 十几页的表格或幻灯片处理得很顺，换成几十页的 Doc 就必挂：截图只出一部分、导 PDF 超时，或者导入很大的 Office 文件时直接失败。
原因。 默认配置里有一组上限，超了是失败而不是降级：一次 Doc 或 Slide 截图最多渲染 screenshotMaxPages = 30 页；每张截图允许的最大像素数是 screenshotMaxPixels = 16777216；此外有三个 120000 ms 的总超时------screenshotOperationTimeoutMs（一次浏览器截图操作）、printPdfOperationTimeoutMs（一次浏览器 PDF 打印操作）、unitContentOperationTimeoutMs（导入、导出、检查和执行）。
解决。 优先分批处理 ：几十页的文档拆成几段交给 Agent，比一次性喂进去稳得多。确实要整本一次渲染时，再考虑调大 screenshotMaxPages、screenshotMaxPixels 和对应的超时项------你调大的是上限，不是把渲染成本变没了。
排查之外的两个提醒
Agent 明明改过文件、你却觉得「没生效」时，先别怀疑插件：所有写入都是先进隔离草稿 的，需要你明确提出确认 才会更新当前版本。另外本地服务从 gatewayPort 默认的 9080 起，被占用时逐次加一（9081、9082），Gateway 只监听 loopback、不对外暴露。
总结
这套顺序背后的判断很朴素：先确认进程与包名（坑一、坑二），再确认运行环境（坑三），最后才怀疑规模与超时（坑四）------前三层都是环境问题，真正属于插件的反而最少。同类插件的信任档位与安装形态，见 完整插件清单与汉化避坑指南。
适合与不适合
适合：需要在同一个运行时里同时处理表格、文档、幻灯片的团队；愿意用隔离草稿加实时预览审阅 Agent 改动的使用者；本机已装 Chrome/Chromium/Edge、能跑通截图与 PDF 打印的人。
不适合 ：把「✓ 可直接安装」当成「已验证可用」的人------站点档位是「仅索引」，静态检查通过不等于实装验证过，上生产前必须自己跑一遍；介意默认遥测的人（telemetry 默认 true）；Linux 服务器上不打算装 Chromium 系浏览器的人，截图、PDF 打印和布局检查会直接不可用；需要编辑 PPT 母版、版式页或演讲者备注的人；要用画布（Board）导出文件的人，Board 目前只支持打印。
标签：dsh-univer-office、DeepSeek Harness、排错速查、插件配置、Univer
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。