Office 文档预览 JohnGD/dsh-office-preview

dsh-office-preview

EN · 中文

为 DeepSeek Harness 侧边栏文档窗格提供 Word（.docx）和 Excel（.xlsx）预览——只读，无需安装 Office，无需网络。

没有此插件时，在侧边栏中打开 .docx 或 .xlsx 会落到纯文本渲染器，并显示“不是文本文件，暂时无法预览。”

渲染内容

| 扩展名 | 渲染结果 |
| .docx .docm .dotx .dotm | 标题、保留缩进和项目符号的段落、粗体 / 斜体 / 下划线、表格（包括嵌套表格） |
| .xlsx .xlsm .xltx .xltm | 工作表标签、行和列标题、合并单元格、列宽、数字和日期格式、缓存的公式结果 |

旧版二进制格式（.doc、.xls）不由此插件接管，仍会回退到纯文本。.pptx 目前不在支持范围内。

工作原理

- 无依赖，无服务。 该插件在官方扩展点 ctx.documentPreviews 和 sidebar.right.tab.document 槽位上注册两个渲染器。它不修改任何 Harness 源码，不调用任何外部服务，唯一的导入是 react。
- OOXML 在浏览器中解析。 lib/client.js 包含一个 ZIP 中央目录读取器（通过 DecompressionStream 进行原始 DEFLATE 解压）和一个小型 XML 读取器；不使用 JSZip、SheetJS 或 mammoth。
- 宿主端为空。 lib/index.js 的存在只是为了让 Cordis 加载器携带一个客户端入口；所有可见行为都位于浏览器包中。

安装

从插件市场安装（推荐）。 在 Harness 中：设置 → 插件市场 → 发现 → 搜索 dsh-office-preview → 安装 → 在提示时重启 Harness。

从预构建的 tarball 安装（无需市场，无需 npm）。

dsh plugin --profile web add https://github.com/JohnGD/dsh-office-preview/releases/latest/download/dsh-office-preview.tgz

手动、离线安装——Windows 上使用 install.ps1，macOS 和 Linux 上使用 install.sh：

powershell -ExecutionPolicy Bypass -File install.ps1

该脚本做三件事：

1. 将包复制到 \plugins\dsh-office-preview；
2. 将 \profiles\node_modules\dsh-office-preview 链接到它——这是 Cordis 加载器解析插件入口名称所依据的根目录；
3. 向配置文件自身的补丁层 \profiles\web\cordis.patch.yml 追加一行 insert，并先备份该文件。

补丁层受到监视（patchReload: live），因此刷新页面（Ctrl+R）通常即可激活插件；如果没有任何变化，请重启 DSH Desktop。

此包未发布到 npm：npm 会将发布者的账户电子邮件写入每个已发布包的公开元数据（maintainers[].email）。在 GitHub Release 上提供预构建的 tarball 可完全避免这一点。

显示位置

- Harness → 设置 → 插件清单会将 dsh-office-preview 列为活动插件，与内置插件并列。
- 插件市场 → 已安装 仅当它作为配置文件依赖项安装时（dsh plugin add，或 link: 依赖）才会列出它。在那里它被标记为“本地开发”，并且可以被启用、禁用或卸载。install.ps1 形式——补丁层加回退链接——不会出现在该列表中；它的优势在于不触及任何配置文件依赖、锁文件或生成投影。这两种形式不能同时启用：挂载同一个条目 id 两次会发生冲突。

卸载

powershell -ExecutionPolicy Bypass -File uninstall.ps1 # 保留已复制的文件 powershell -ExecutionPolicy Bypass -File uninstall.ps1 -RemoveFiles # 同时删除它们

如果该插件是作为配置文件依赖项安装的，请改为从市场中移除它：市场 → 已安装 → 卸载。

自检

$node = "$env:APPDATA\dsh-desktop\harness\.desktop-bin\node.cmd" # 或任意 Node >= 20 & $node test\parse.mjs samples\sample.xlsx samples\sample.docx # 解析器 & $node test\render.mjs samples\sample.xlsx samples\sample.docx # 渲染路径，包含边界情况 & $node test\plugin.mjs # 客户端注册契约

每个脚本在成功时都会打印 ALL CHECKS PASSED。samples/ 包含一个小型工作簿和一个小型文档，因此这些检查无需任何外部文件即可运行。

限制

- 只读：预览永远不会写入文档。
- 图像、批注、修订、图表和宏不会被渲染；它们的文本仍会显示。
- 每个文件的读取上限来自 Harness 的 workspaceFiles.readAll——默认 32 MiB。
- 大型工作表会在 4000 行 × 160 列处截断，并附有提示。

许可证

MIT

中文说明

EN · 中文

dsh-office-preview —— DeepSeek Harness 右侧栏文档面板的 Word（.docx）与 Excel（.xlsx）预览插件：只读、不依赖 Office、不联网。

没有这个插件时，在右侧栏点开 .docx / .xlsx 会落到纯文本渲染器，显示「非文本文件，暂时无法预览」。

渲染能力

| 扩展名 | 渲染内容 |
| .docx .docm .dotx .dotm | 标题层级；段落（保留缩进与项目符号）；加粗 / 斜体 / 下划线；表格（含嵌套表格） |
| .xlsx .xlsm .xltx .xltm | 工作表分页签；行列号表头；合并单元格；列宽；数字与日期格式；公式的缓存值 |

旧二进制格式（.doc、.xls）本插件不接管，仍走官方纯文本回退；.pptx 目前不在范围内。

实现方式

- 零依赖、无外部服务。 插件只在官方扩展点 ctx.documentPreviews 与插槽 sidebar.right.tab.document 上注册两个渲染器；不修改 Harness 任何源码，不调用外部服务，唯一引入的模块是 react。
- OOXML 在浏览器内解析。 lib/client.js 内置 ZIP 中央目录读取器（用 DecompressionStream 解 raw-DEFLATE）与一个小型 XML 读取器，不引入 JSZip、SheetJS 或 mammoth。
- 宿主半是空的。 lib/index.js 的唯一作用是让 Cordis loader 里存在这个条目，全部可见行为都在浏览器半。

安装

从插件市场安装（推荐）。 在 Harness 里：设置 → 插件市场 → 发现 → 搜索 dsh-office-preview → 安装 → 按提示重启 Harness。

用预构建包安装（不用市场、不用 npm）。

dsh plugin --profile web add https://github.com/JohnGD/dsh-office-preview/releases/latest/download/dsh-office-preview.tgz

离线手动安装 —— Windows 用 install.ps1，macOS 与 Linux 用 install.sh：

powershell -ExecutionPolicy Bypass -File install.ps1

脚本只做三件事：

1. 复制包到 \plugins\dsh-office-preview；
2. 建立 \profiles\node_modules\dsh-office-preview 联结指向它 —— 这是 Cordis loader 解析插件条目名所用的回退根目录；
3. 在 profile 自己的补丁层 \profiles\web\cordis.patch.yml 追加一条 insert 行，改前自动备份该文件。

补丁层被 live 监听（patchReload: live），通常刷新页面（Ctrl+R）即可生效；若界面无变化，重启一次 DSH Desktop。

本包不发 npm：npm 会把发布者的注册邮箱写进每个已发布包的公开元数据（maintainers[].email）。改为把预构建包挂在 GitHub Release 上，可以完全避开这一点。

它出现在哪里

- Harness → 设置 → 插件清单：会列出 dsh-office-preview 处于活动状态，与内置插件并列。
- 插件市场 → 已安装：只有把它装成 profile 依赖（dsh plugin add，或 link: 依赖）时才会出现，标记为「本地开发」，可在市场里启用 / 禁用 / 卸载。用 install.ps1 装的形式（补丁层 + 回退目录链接）不在该列表中；它的好处是完全不触碰 profile 依赖、锁文件与代际投影。两种形式不能同时启用：同一条目 id 挂两次会冲突。

卸载

powershell -ExecutionPolicy Bypass -File uninstall.ps1 # 保留已复制的文件 powershell -ExecutionPolicy Bypass -File uninstall.ps1 -RemoveFiles # 连文件一起删除

若插件是以 profile 依赖装的，请在市场 → 已安装 → 卸载里移除它。

自检

$node = "$env:APPDATA\dsh-desktop\harness\.desktop-bin\node.cmd" # 或用任意 Node >= 20 & $node test\parse.mjs samples\sample.xlsx samples\sample.docx # 解析器 & $node test\render.mjs samples\sample.xlsx samples\sample.docx # 渲染路径（含边界用例） & $node test\plugin.mjs # 客户端注册契约

三个脚本成功时都会打印 ALL CHECKS PASSED；samples/ 里带了一个小工作簿与一个小文档，不需要外部文件就能跑。

边界

- 只读：预览不会写回文档。
- 图片、批注、修订痕迹、图表、宏不渲染，其文字内容仍会显示。
- 单文件读取上限取决于 Harness 的 workspaceFiles.readAll，默认 32 MiB。
- 大表格最多渲染 4000 行 × 160 列，超出部分给出提示。

许可

MIT