前言¶
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 的操作即可：
- 打開側邊欄，在文件資源管理器裏點任意
.docx/.xlsx/.pptx，對應預覽器會按擴展名自動命中。 - 打開 Side card 設置頁，在「文件預覽」清單裏可以看到
docx/xlsx/pptx三張卡片，能單獨啓用或禁用。 - 某個文件渲染失敗時，界面回退到「下載查看」，把文件拿到本地用桌面 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
