前言¶
DeepSeek Harness (DSH) 采用插件化架构。在 Web 界面中直接处理 Word 文档文件时，通常缺乏原生的编辑体验。dsh-sidebar-superdoc-docx 插件通过集成 SuperDoc，在 DSH 的 better-sidebar 中提供了浏览器原生的 DOCX 编辑能力。
是什么¶
这是一个 DSH Web 插件，允许用户在侧边栏中打开并编辑 .docx 文件。
- 维护者：chendefine
- 核心能力：
- 浏览器原生 DOCX 编辑（支持批注和修订）
- 保存回磁盘（原子性写入）
- 跟随外部编辑（支持 AI 上下文同步）
- 完全自托管 & 离线可用
- 下载后备功能
- 侧边栏自适应布局
- 强制依赖：
dsh-better-sidebar >= 0.13.0。该插件仅作为文件查看器注册到此组件中，缺少它则查看器不会出现。
安装与启用¶
在安装前，请确保环境满足以下先决条件：
* Node.js >= 20
* DSH Web GUI 及其 web 配置文件
* dsh-better-sidebar >= 0.13.0 已安装在同一个配置文件中
使用官方安装命令：
dsh plugin --profile web add dsh-better-sidebar dsh-sidebar-superdoc-docx
安装完成后，重启 dsh web 服务并刷新浏览器即可使用。
典型用法¶
-
打开文档
在侧边栏文件树中点击任意.docx文件，系统会调用“DOCX (SuperDoc)”查看器替代内置的代码或下载查看器。 -
切换编辑模式
在设置页面的 Side cards → File preview → DOCX (SuperDoc) 中，齿轮图标暴露了“打开模式”选择：编辑 / 建议 / 查看。选择“查看”会隐藏保存按钮。 -
保存与状态
- 顶部工具栏为 SuperDoc 原生工具栏，随侧边栏宽度自动折叠。
- 编辑完成后点击 Save，系统会将文档导出并通过专用路由原子性覆盖磁盘上的原文件。
- 未保存的更改会在标题栏显示
● Unsaved changes。
-
跟随外部编辑
如果 AI 代理或其他进程修改了磁盘上的文件，插件通过 3 秒轮询检测变更：- 干净编辑器：自动替换为新版本。
- 脏编辑器：仅显示横幅，需手动点击 Reload 才能加载新版本（当前未保存的编辑不会被静默丢弃）。
适用场景¶
- 人机协作：AI 修改文件，用户在侧边栏即时查看并微调，实现无中断的双向循环。
- 内网 / 离线 / 合规环境：部署环境禁止访问 CDN 或 SaaS 文档服务。插件通过同源自托管（same-origin）提供所有资源，
pnpm install后即可完全离线运行。 - 快速预览：提供分页文档预览，替代内置的代码/下载查看器。
注意事项¶
- 许可证：插件代码本身为 MIT 协议，但运行时集成了 AGPL-3.0 的
superdoc和专有的@superdoc/docx-engine。安装即表示接受这些第三方协议。 - 权限限制：插件在当前 DSH 进程的权限下运行，保存操作依赖于该进程对目标文件路径的读写权限。
结语¶
该插件实现了 DSH 生态中零服务依赖的文档编辑功能，适合需要在本地环境或严格合规场景下处理 Word 文件的开发者。
