dsh-better-sidebar-onlyoffice
在终端中运行以下命令:
dsh plugin install chendefine/dsh-better-sidebar-onlyoffice
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中运行 dsh plugin install chendefine/dsh-better-sidebar-onlyoffice 即可安装,插件源码详见 https://github.com/chendefine/dsh-better-sidebar-onlyoffice
插件介绍
当 DSH 驱动文档密集型工作流时,侧边栏通常只能静态预览 .docx、.xlsx 或 .pptx 文件——改一句话就得离开终端打开桌面版 Office,而 AI 在后台修改了你正在编辑的文件,刷新前也完全看不到。dsh-better-sidebar-onlyoffice 将完整的 ONLYOFFICE 编辑器(Words、Sheets、Slides)嵌入 better-sidebar 文件查看器,让编辑直接发生在侧边栏内。保存通过临时文件 + rename 原子写回磁盘,编辑器配置使用 HS256-JWT 签名,文件下载受短时效 HMAC 令牌保护,路径被限制在会话工作目录内。
两个特性尤为突出。第一,同源反向代理始终开启:Document Server 的全部浏览器端——api.js、编辑器 iframe、静态资源、协同编辑 WebSocket——都经由 dsh web 的 /sidebar/onlyoffice/ds 路径转发。DS 可以留在浏览器无法触及的私有网络上,https 前端也能透明代理 http-only 的 DS,彻底消除混合内容问题。第二,AI 编辑实时刷新:当 agent 修改了编辑器中打开的文件,通过 inotify → SSE → refreshFile 链路在约一秒内换入新版本,无需页面重载、无需重新加载 api.js。若编辑器处于脏状态(有未保存修改),绝不会自动刷新;取而代之的是顶部出现提示横幅,由用户手动确认重载,确保未保存的工作不会被静默丢弃。
适合运行文档密集型 DSH web 工作流的开发者,尤其是 Document Server 部署在内部网络、不应直接暴露给浏览器的场景。插件与社区的 office-preview 插件通过不同的 viewer ID 和优先级共存,两者可在侧边栏卡片设置中按需启停。
使用场景
- AI agent 修改了打开的文档,侧边栏约一秒内即时刷新显示新版本
- Document Server 部署在内网,浏览器无需直接访问即可完成 Office 文件编辑
- 在 DSH web 侧边栏中直接编辑 .docx/.xlsx/.pptx 并原子保存回磁盘
适合人员
- 运行文档密集型 DSH web 工作流的开发者
- ONLYOFFICE Document Server 部署在内网、不便对浏览器暴露的团队
- 希望 AI 编辑与人工编辑在侧边栏中无缝协作的 DSH 用户