前言¶
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 文件的開發者。
