deepseekplugins

DeepSeek Harness plugin

dsh-plugin-better-sidebar-plugin-office

DSH web plugin: Office file previewers (.docx/.xlsx/.pptx) for the better-sidebar editor. Registers the docx/xlsx/pptx file viewers through ctx.betterSidebar.registerFileViewer, keeping the heavy.

Tools & Capabilities
Jump to install

Source facts

Repository
HuanLinOTO/dsh-plugin-better-sidebar-plugin-office
Latest update
Aug 15, 2026
Category
Tools & Capabilities
GitHub stars
23
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/HuanLinOTO/dsh-plugin-better-sidebar-plugin-office
Plugin: dsh-plugin-better-sidebar-plugin-office
Author: HuanLinOTO

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

![dshfind](https://dshfind.com/zh/plugins/huanlinoto/dsh-plugin-better-sidebar-plugin-office?ref=badge)

> 📌 本插件已收录于 dshfind 插件超市，点击上方徽章直达主页。

dsh-better-sidebar-plugin-office

![npm version](https://www.npmjs.com/package/@huanlin/dsh-plugin-better-sidebar-plugin-office)

DSH web 插件：为 better-sidebar 的编辑器提供 Office 三件套文件预览（.docx / .xlsx / .pptx）。

背景

better-sidebar 曾内置这三个 viewer，但 docx-preview / Univer（+ SheetJS）/ pptx-renderer 会把 client bundle 撑到约 23MB。本插件把它们拆成独立 bundle，better-sidebar 本体不再内联 Office 渲染库（约 5.9MB 全套 → 2.2MB 压缩），需要 Office 预览的用户单独安装本插件即可。

功能

  • 通过 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），因此：

- 既有文件路由行为不变（扩展名匹配优先于 binary-download / code 兜底） - Side card 设置页自动显示这三个 viewer 的启用开关 - 加载/渲染失败回退到「下载查看」链接

  • 客户端组件自包含：自带 locale（中/英）与 CSS，不依赖 better-sidebar 的 client 内部实现

依赖 better-sidebar 版本

需要 better-sidebar >= 0.6.0（已移除内置 office viewer 的版本），否则会与内置 docx/xlsx/pptx 注册冲突（already registered）。

开发

pnpm install
pnpm run typecheck   # 类型门禁（需先构建 DSH-better-sidebar 的 lib/types）
pnpm test            # vitest（xlsx→Univer 转换 + 注册描述符）
pnpm run build       # tsdown 双产物（lib/index.js + lib/client.js）

> tsdown.config.ts 含 jszip / xlsx 的 browser-entry alias（SheetJS/JSZip 在 CJS 降级后残留 Node builtin 引用）与 import.meta.resolve 空定义（pptx-renderer 的 PDF.js 探测）。改动这些库版本时需一并验证 client bundle 不含 Node builtin。

安装（profile）

# 从 npm 安装（推荐）：
dsh plugin --profile web add @huanlin/dsh-plugin-better-sidebar-plugin-office

# 本地开发（link: 热更新）
dsh plugin --profile web add "link:D:/Projects/deepseek-harness/dsh-better-sidebar-plugin-office"

安装后重启 dsh web 进程并浏览器硬刷新（Ctrl+Shift+R）。

运行

  • 打开侧边栏 → 在文件资源管理器中打开任意 .docx / .xlsx / .pptx，预览器自动命中。
  • Side card 设置页 →「文件预览」清单中可见 docx / xlsx / pptx 三张卡片，可单独启用/禁用。

检查

检查项命令预期
类型门禁pnpm run typecheck0 错误
单元测试pnpm test全部通过
构建pnpm run buildlib/client.js 生成，window.__ModuleLoader__.load({ id: '@huanlin/dsh-plugin-better-sidebar-plugin-office', ... }) 包裹
bundle 纯度产物中搜索 node: 或 require("fs")不应出现 Node builtin 引用
profile 可见Test-Path ~/.dsh/profiles/web/node_modules/@huanlin/dsh-plugin-better-sidebar-plugin-office/lib/client.jsTrue
插件加载重启 dsh web + 硬刷新后侧边栏打开 Office 文件预览正常渲染
Back to searchOpen GitHub repository

More related plugins

View category