dsh-office-preview
DeepSeek Harness 侧边栏文档面板的 Word (.docx) 和 Excel (.xlsx) 预览 — OOXML 在浏览器本地解析，无需安装 Office，也无需网络。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:JohnGD/dsh-office-preview#cf6fc80a1460a18bc6f551ac908029fd14520c69Office Preview 以 dsh-office-preview 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →Word (.docx) and Excel (.xlsx) previews for the DeepSeek Harness sidebar document pane — read-only, no Office installation, no network.
Without this plugin, opening a .docx or .xlsx in the sidebar falls through to the plain-text renderer and shows "Not a text file, preview is unavailable for now."
| Extension | Rendered |
|---|---|
.docx .docm .dotx .dotm | Headings, paragraphs with indentation and bullets kept, bold / italic / underline, tables including nested ones |
.xlsx .xlsm .xltx .xltm | Sheet tabs, row and column headers, merged cells, column widths, number and date formats, cached formula results |
Legacy binary formats (.doc, .xls) are not claimed by this plugin and still fall back to plain text. .pptx is out of scope today.
ctx.documentPreviews and the sidebar.right.tab.document slot. It patches no Harness source, calls no external service, and its only import is react.lib/client.js contains a ZIP central-directory reader (raw-DEFLATE through DecompressionStream) and a small XML reader; no JSZip, SheetJS or mammoth.lib/index.js exists only so the Cordis loader carries a client entry; all visible behaviour lives in the browser bundle.From the plugin market (recommended). In Harness: Settings → Plugin Market → Discover → search dsh-office-preview → Install → restart Harness when asked.
From the prebuilt tarball (no market, no npm).
dsh plugin --profile web add https://github.com/JohnGD/dsh-office-preview/releases/latest/download/dsh-office-preview.tgz
Manual, offline — install.ps1 on Windows, install.sh on macOS and Linux:
powershell -ExecutionPolicy Bypass -File install.ps1
The script does three things:
<home>\plugins\dsh-office-preview;<home>\profiles\node_modules\dsh-office-preview at it — a root the Cordis loader resolves plugin entry names through;insert row to the profile's own patch layer <home>\profiles\web\cordis.patch.yml, backing that file up first.The patch layer is watched (patchReload: live), so a page refresh (Ctrl+R) usually activates the plugin; if nothing changes, restart DSH Desktop.
This package is not published to npm: npm writes the publisher's account e-mail into every published package's public metadata (maintainers[].email). Shipping a prebuilt tarball on a GitHub Release avoids that entirely.
dsh-office-preview as an active plugin, next to the built-in ones.dsh plugin add, or a link: dependency). There it is labelled "local development" and can be enabled, disabled or uninstalled. The install.ps1 form — patch layer plus fallback link — does not appear in that list; its advantage is that it touches no profile dependency, lockfile or generation projection. The two forms must not be enabled at once: mounting one entry id twice collides.powershell -ExecutionPolicy Bypass -File uninstall.ps1 # keeps the copied files
powershell -ExecutionPolicy Bypass -File uninstall.ps1 -RemoveFiles # removes them as well
If the plugin was installed as a profile dependency, remove it from the market instead: Market → Installed → Uninstall.
$node = "$env:APPDATA\dsh-desktop\harness\.desktop-bin\node.cmd" # or any Node >= 20
& $node test\parse.mjs samples\sample.xlsx samples\sample.docx # parsers
& $node test\render.mjs samples\sample.xlsx samples\sample.docx # render path, edge cases included
& $node test\plugin.mjs # client registration contract
Each script prints ALL CHECKS PASSED on success. samples/ carries a small workbook and a small document, so the checks run without any external file.
workspaceFiles.readAll — 32 MiB by default.MIT
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。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
脚本只做三件事：
<home>\plugins\dsh-office-preview；<home>\profiles\node_modules\dsh-office-preview 联结指向它 —— 这是 Cordis loader 解析插件条目名所用的回退根目录；<home>\profiles\web\cordis.patch.yml 追加一条 insert 行，改前自动备份该文件。补丁层被 live 监听（patchReload: live），通常刷新页面（Ctrl+R）即可生效；若界面无变化，重启一次 DSH Desktop。
本包不发 npm：npm 会把发布者的注册邮箱写进每个已发布包的公开元数据（maintainers[].email）。改为把预构建包挂在 GitHub Release 上，可以完全避开这一点。
dsh-office-preview 处于活动状态，与内置插件并列。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/ 里带了一个小工作簿与一个小文档，不需要外部文件就能跑。
workspaceFiles.readAll，默认 32 MiB。MIT