Back to directory

dsh-plugin-better-sidebar-plugin-office

Curated pickMaintenance: Active

huanlinoto/dsh-plugin-better-sidebar-plugin-office

为 better-sidebar 编辑器提供 .docx/.xlsx/.pptx 三件套文件预览(docx-preview / Univer / pptx-renderer)。

View on GitHub
$ dsh plugin --profile web add @huanlin/dsh-plugin-better-sidebar-plugin-office

36

stars

2

forks

JavaScript

Language

NOASSERTION

License

2026-08-12

Created

2026-09-03

Last push

Native DSH web plugin that previews Word / Excel / PowerPoint files inside the better-sidebar editor, shipped as a separate bundle so the core stays small.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-09-03

License

NOASSERTION

01What can it help you accomplish?

  • Preview Office documents (.docx/.xlsx/.pptx) inside the better-sidebar file explorer

    In-browser rendered viewers — docx-preview for Word, Univer sheets for Excel, @aiden0z/pptx-renderer for PowerPoint — auto-matched by file extension

    better-sidebar users who receive Office attachments and want to preview them without leaving the editor

  • Keep the better-sidebar core client bundle small while still offering Office preview

    Office renderers shipped as a separate plugin bundle instead of inlined into better-sidebar (~5.9MB full set → 2.2MB compressed)

    better-sidebar operators/maintainers who want a slim core and let users opt into heavy viewers on demand

02How to install into DeepSeek Harness

Prerequisites

  • better-sidebar `>= 0.6.0` (the release that removed the built-in office viewer); on older versions the plugin's `docx/xlsx/pptx` registration collides with the built-in one
  • A DeepSeek Harness `web` profile — the plugin is added to `--profile web` and served by the `dsh web` process

Installation steps

  1. 01

    Run `dsh plugin --profile web add @huanlin/dsh-plugin-better-sidebar-plugin-office` to install the plugin into the web profile

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

  2. 02

    Restart the `dsh web` process and hard-refresh the browser (`Ctrl+Shift+R`)

    $ dsh web

Verify the integration

  • Confirm the plugin file exists: `Test-Path ~/.dsh/profiles/web/node_modules/@huanlin/dsh-plugin-better-sidebar-plugin-office/lib/client.js` should return True
  • After restarting `dsh web` + hard refresh, open a `.docx`/`.xlsx`/`.pptx` from the sidebar — the preview should render normally

03DSH integration and capability boundaries

DSH integrationNative runtime

Native DSH web plugin: installed with `dsh plugin --profile web add` and registers file viewers through the `ctx.betterSidebar.registerFileViewer` API in the better-sidebar editor.

  • Word (.docx) viewer

    `.docx` file opened in better-sidebarFaithful in-browser render via docx-preview (styles / images / tables, Alt+wheel zoom)

  • Excel (.xlsx) viewer

    `.xlsx` file opened in better-sidebarUniver sheets preset (data + formulas + merged cells + column width / row height)

  • PowerPoint (.pptx) viewer

    `.pptx` file opened in better-sidebarBrowser-native preview via @aiden0z/pptx-renderer with page navigation

  • Self-contained client component

    registered viewer descriptor (mediaUrl strategy, priority 0, title/icon)Viewers matching the original built-in descriptor shape, so existing file routing and the Side card toggle UI work unchanged

    loads/renders failures fall back to a download link

04Who is it for? When not to use it?

Good for

  • better-sidebar users who receive Office attachments and want to preview them without leaving the editor
  • better-sidebar operators/maintainers who want a slim core and let users opt into heavy viewers on demand

Not for

  • Requires better-sidebar `>= 0.6.0` (the release that removed the built-in office viewer); on older versions the plugin's `docx/xlsx/pptx` registration collides with the built-in one (`already registered`).
  • Changing the versions of jszip / xlsx / pptx-renderer can reintroduce Node builtin references (SheetJS/JSZip CJS fallbacks, pptx-renderer's PDF.js probe); the client bundle must be verified to contain no Node builtin.

05Compatibility, maintenance and safety notes

  • Requires better-sidebar `>= 0.6.0` (the release that removed the built-in office viewer); on older versions the plugin's `docx/xlsx/pptx` registration collides with the built-in one (`already registered`).
  • Changing the versions of jszip / xlsx / pptx-renderer can reintroduce Node builtin references (SheetJS/JSZip CJS fallbacks, pptx-renderer's PDF.js probe); the client bundle must be verified to contain no Node builtin.
  • When a viewer fails to load or render, better-sidebar falls back to a download link instead of showing the preview.
2026-08-122026-09-03Not specified by the author

NOASSERTION · not released as a git tag yet (latest_release: null); README references the npm package @huanlin/dsh-plugin-better-sidebar-plugin-office

06Frequently asked questions

How do I install this plugin in DeepSeek Harness?

Run `dsh plugin --profile web add @huanlin/dsh-plugin-better-sidebar-plugin-office` to add it to your `web` profile, then restart the `dsh web` process and hard-refresh the browser (`Ctrl+Shift+R`).

Which file types does it preview?

It registers three viewers via `ctx.betterSidebar.registerFileViewer`: `docx` (docx-preview), `xlsx` (Univer sheets), and `pptx` (@aiden0z/pptx-renderer). Opening any of these from the sidebar auto-matches by extension.

What better-sidebar version do I need?

better-sidebar `>= 0.6.0` — the release that removed the built-in office viewer. On older versions the plugin's `docx/xlsx/pptx` registration collides with the built-in one and fails with `already registered`.

Why is this a separate plugin instead of built into better-sidebar?

docx-preview / Univer / pptx-renderer inflated the client bundle to about 23MB. Splitting them into this plugin lets the better-sidebar core stay at ~2.2MB compressed, and users who need Office preview install it separately.

What happens if a viewer fails to render?

On load/render failure the plugin falls back to a download link instead of showing the preview, and the three viewers appear as toggleable cards in the Side card settings page so you can enable/disable each one.

08Data and sources

  • Author-claimedgithub.comfbafdc6f8b1b…

    DSH web 插件:为 better-sidebar 的编辑器提供 Office 三件套文件预览(`.docx` / `.xlsx` / `.pptx`)。

  • Author-claimedgithub.comfbafdc6f8b1b…

    通过 `ctx.betterSidebar.registerFileViewer` 注册 3 个 viewer(id 与内置一致):

  • Author-claimedgithub.comfbafdc6f8b1b…

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

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-03. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.