跳到主内容

dsh-plugin-better-sidebar-plugin-office 使用指南

为 better-sidebar 文件浏览器补回 Word/Excel/PPT 预览,把臃肿的 Office 渲染库拆成独立插件按需加载,瘦身主包。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

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

快速上手

dsh-plugin-better-sidebar-plugin-office

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @huanlin/dsh-plugin-better-sidebar-plugin-office

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

— 源: plugins.install

关键要点

  • 通过 ctx.betterSidebar.registerFileViewer 注册 3 个 viewer（id 与内置一致）：
    • docx：.docx，docx-preview 保真渲染（样式/图片/表格，Alt+滚轮缩放）
    • xlsx：.xlsx，Univer sheets 预设（数据 + 公式 + 合并单元格 + 列宽/行高）
    • pptx：.pptx，@aiden0z/pptx-renderer 浏览器原生预览（翻页导航）
  • viewer 描述符形状与原内置完全一致（mediaUrl 策略、priority 0、title/icon），因此：

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后还需要做什么配置吗?

不需要,也不存在配置项;安装完成重启 dsh web 进程并硬刷新浏览器即可生效,Office 文件预览会自动接管。

和 better-sidebar 内置的 Office 预览冲突吗?

必须配合 better-sidebar >= 0.6.0 (已移除内置 docx/xlsx/pptx 的版本);低于此版本会触发 already registered 报错。

支持旧格式 .doc/.xls/.ppt 吗?

不支持,本插件只识别 .docx/.xlsx/.pptx 三种扩展名,旧二进制格式需先在 Office 中另存为新版格式。

Excel 预览能保留原来的样式吗?

v1 只还原数据、公式、合并单元格、列宽和行高;字体、填充、边框、条件格式、图表等样式不在支持范围,需要看原貌请用下载按钮。

预览失败怎么办?

渲染失败时界面会回退到一个"下载查看"链接,你可以直接下载到本地用 Office 打开;常见原因是文件损坏、加密或体积过大。

怎么单独禁用某个类型的预览?

在 better-sidebar Side card 设置页的"文件预览"清单里可以分别启用或禁用 docx/xlsx/pptx 三个 viewer 卡片。

安装后体积会不会反而变大?

主包 better-sidebar 因此瘦身近 3.8MB;只有真正需要 Office 预览的 profile 才需要承担这约 23MB 的客户端 bundle,按需安装。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 未声明 (依赖 cordis ^4.0.0-rc.7 与 dsh-better-sidebar ^0.6.0)
  • Node: >=20

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则

dsh-plugin-better-sidebar-plugin-office 使用指南