前言¶

DeepSeek Harness（dsh）把模型适配、工具、会话、循环和界面都做成可替换插件，官方仓库的口号就是「Everything is a Plugin」。开发者预览阶段里，很多人会先跑 dsh web，在浏览器里看智能体改文件、跑命令。对话旁边如果已经装了 DSH-better-sidebar，侧边栏就能当文件工作台：资源管理器、编辑器、图片 / Markdown / PDF 预览都在同一块区域。

Word、Excel、PPT 这类文件不一样。智能体经常写出 .docx、.xlsx、.pptx，但浏览器默认只会当二进制下载。better-sidebar 曾经把三套渲染库内置进客户端，体积会被撑得很夸张；从 0.6.0 起，这三套预览被拆出去，未安装时只能走代码查看或下载兜底。需要在侧边栏直接打开 Office 文件时，要另装一个独立插件：dsh-plugin-better-sidebar-plugin-office。

本文按社区插件目录页、插件 GitHub 仓库（README、package.json、LICENSE、cordis.patch.yml）以及 DSH-better-sidebar 的说明交叉核对后整理：它是什么、装在哪一层、怎么用，以及版本和许可证上需要注意的地方。社区目录 deepseek-harness-plugin.com 是独立站点，不是 DeepSeek / 幻方的官方应用商店。

这是什么¶

dsh-plugin-better-sidebar-plugin-office 是一款面向 dsh web 的界面增强插件，由 HuanLinOTO 维护，GitHub 仓库为 HuanLinOTO/dsh-plugin-better-sidebar-plugin-office。npm 包名是 @huanlin/dsh-plugin-better-sidebar-plugin-office，当前 package.json 中的版本为 0.1.0。仓库 README 里也把它写作 dsh-better-sidebar-plugin-office。

它只做一件事：通过 ctx.betterSidebar.registerFileViewer，给 better-sidebar 的编辑器注册三个文件预览器，分别对应 .docx、.xlsx、.pptx。Office 渲染库放在独立 client bundle 里，better-sidebar 本体不再内联这些依赖。GitHub 仓库创建于 2026-08-12，最近一次推送记录为 2026-08-15；本文核对当天 GitHub API 显示 18 星，社区目录页仍显示 8 星，以仓库页面为准。

许可证以仓库一手材料为准：package.json 的 license 字段是 AGPL-3.0，LICENSE 文件是 GNU Affero General Public License Version 3（版权行写的是 Copyright (C) 2026 Huanlin）。GitHub 与社区目录的 SPDX 显示为 NOASSERTION，属于未能自动识别，不能当成「无许可证」。安装前应自己读一遍 AGPL-3.0 条款。

核心功能¶

为什么要从本体拆出去¶

仓库 README 给出的背景很具体：better-sidebar 曾经内置这三个 viewer，但 docx-preview、Univer（加上 SheetJS）、pptx-renderer 会把 client bundle 撑到约 23MB。拆成独立插件后，本体不再内联 Office 渲染库，README 写的对比是全套约 5.9MB 降到压缩后约 2.2MB。不需要预览 Office 的用户可以不装；需要的人单独加这一层即可。

DSH-better-sidebar 自己的说明也互相印证：Office 三件套预览已移到「推荐插件」，未安装时这类文件走代码或下载查看兜底。设置页「添加插件」弹窗里能看到推荐目录和一键复制安装命令。

三个 viewer¶

插件注册的 id 与原先内置名称一致，描述符形状也保持一致（mediaUrl 策略、priority 0、title/icon）。因此扩展名匹配仍优先于 binary-download / code 兜底，Side card 设置页会自动出现这三个 viewer 的开关。加载或渲染失败时，回退到「下载查看」链接。客户端组件自带中/英 locale 和 CSS，不依赖 better-sidebar 的 client 内部实现。

三个预览器对应的能力，以 README 原文为准：

• docx：处理 .docx，用 docx-preview 做保真渲染，覆盖样式、图片、表格，支持 Alt+滚轮缩放。
• xlsx：处理 .xlsx，用 Univer sheets 预设展示数据、公式、合并单元格，以及列宽、行高。
• pptx：处理 .pptx，用 @aiden0z/pptx-renderer 在浏览器里原生预览，带翻页导航。

仓库没有声明对旧格式 .doc / .xls / .ppt 的支持，也没有把表格预览写成可编辑的完整 Excel。不要按「能打开 Office」去推断编辑、宏或旧二进制格式。

和 better-sidebar 的版本关系¶

package.json 把 dsh-better-sidebar 写成 peerDependency ^0.6.0，README 写得更硬：需要 better-sidebar >= 0.6.0（已经移除内置 office viewer 的版本）。版本过低会与内置的 docx/xlsx/pptx 注册冲突，报 already registered。

这是 Web 侧插件。package.json 的 dsh.client.platform 为 web，并声明注入 @deepseek-ai/dsh-client-runtime；cordis.patch.yml 插入的插件 id 是 dsh-better-sidebar-plugin-office。engines.node 要求 >=20。它不能替代 better-sidebar 本身，也不是给 headless profile 用的预览器。

安装与启用¶

先确认当前环境已经能跑 dsh web，并且已经安装、启用 DSH-better-sidebar（>= 0.6.0）。社区目录给本体的安装命令是：

dsh plugin add github:omdsh-dev/DSH-better-sidebar

安装本插件时，以社区目录页原文为准：

dsh plugin add github:HuanLinOTO/dsh-plugin-better-sidebar-plugin-office

dsh CLI 会从 GitHub 解析插件并装进当前配置。需要可复现安装时，目录页给出的写法是固定 commit 哈希：

dsh plugin add github:HuanLinOTO/dsh-plugin-better-sidebar-plugin-office#commit

把末尾的 commit 换成实际哈希。不要用插件名自己拼接仓库地址。

仓库 README 另外推荐从 npm 装到 web profile（dshfind 页面给出的命令与此相同）：

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

--profile 后面换成你正在用的 profile 名。本地开发可以用 link: 指向源码目录做热更新，README 里的示例路径是维护者本机路径，不能直接照抄。

装完后按 README 做两步：重启 dsh web 进程，再在浏览器里硬刷新（Ctrl+Shift+R）。只装插件、不重启、不刷新，侧边栏里的 viewer 不会出现。

社区目录有一条固定提示：插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装前请检查源代码仓库和许可证。

典型用法¶

安装并硬刷新之后，不需要再配一套路由。按 README 的操作即可：

1. 打开侧边栏，在文件资源管理器里点任意 .docx / .xlsx / .pptx，对应预览器会按扩展名自动命中。
2. 打开 Side card 设置页，在「文件预览」清单里可以看到 docx / xlsx / pptx 三张卡片，能单独启用或禁用。
3. 某个文件渲染失败时，界面回退到「下载查看」，把文件拿到本地用桌面 Office 打开。

Word 预览里可以用 Alt+滚轮缩放；PPT 预览带翻页。表格侧能看到公式、合并单元格和行列尺寸，具体保真程度以 Univer sheets 预设为准，仓库没有提供对照截图或兼容性矩阵。

如果你是从 better-sidebar 的设置页「添加插件」弹窗进来的，复制命令后效果与上面相同：装的仍是这一份 Office 预览插件，而不是改 better-sidebar 源码。

适用场景与注意事项¶

适合已经在用 dsh web + better-sidebar >= 0.6.0，并且经常要在对话旁边查看智能体产出的 Word / Excel / PPT 的人。不需要 Office 预览时，可以只保留瘦身后的 better-sidebar，不必装本插件。

使用前注意这几条已经核实的边界：

• 依赖 better-sidebar >= 0.6.0。更旧版本会注册冲突。
• 只覆盖 .docx / .xlsx / .pptx。旧格式、密码保护文档、宏、复杂 SmartArt 等，仓库没有承诺。
• 运行平台是 web client。headless 或纯终端流程装了也不会在浏览器里多出一个预览器。
• Node.js 需要 >= 20。
• 许可证是 AGPL-3.0。社区目录写「可免费安装使用」指的是开源可获取，不等于可以忽略 copyleft 义务；二次分发或网络提供修改版本时，应自行核对 AGPL。
• 插件与当前 dsh 进程同权限。安装前读源码和 LICENSE，需要可复现环境时固定 commit，不要只凭目录页的简介安装。

DeepSeek Harness 本身仍是 developer preview，核心插件和 API 还会变。本插件仓库创建于 2026 年 8 月，版本号 0.1.0，接口或 bundle 体积数字以当时 README 为准，后续更新请回仓库核对。

小结¶

dsh-plugin-better-sidebar-plugin-office 把 Office 三件套预览从 better-sidebar 本体拆成独立 web 插件：需要时再装，不需要时让侧边栏保持较小的 client bundle。装好 better-sidebar >= 0.6.0 之后，用目录页命令或 npm 包加到 web profile，重启并硬刷新，就可以在文件树里直接打开 .docx / .xlsx / .pptx。

目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-plugin-better-sidebar-plugin-office/

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