🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
视觉能力·0 次阅读·Univer 办公套件 插件页

引进第三方办公套件要过问的三件事:许可、数据去向、包从哪来

Univer 办公套件进入 DSH 之后,许可与遥测怎么处理 Univer 办公套件( dsh-univer-office ,作者 dream-num)是这个生态里少见的「重型」插件:446★、综合分 67.5、周下载 11,709,许可 Apache-2.0 ,把电子表格、文档、幻灯片、多维表格(Base)和画布(Board)放进同一个 DSH 运行时。

Univer 办公套件(dsh-univer-office,作者 dream-num)是这个生态里少见的「重型」插件:446★、综合分 67.5、周下载 11,709,许可 Apache-2.0,把电子表格、文档、幻灯片、多维表格(Base)和画布(Board)放进同一个 DSH 运行时。它是一个标准 DSH bundle,Host 侧组合了 Univer Service Provider、Tools Consumer、webServer Consumer 和 Skill Provider。本文不聊怎么用,只聊引进一个第三方办公套件时真正要过问的三件事:许可能不能用、数据会去哪、包从哪来。

许可:Apache-2.0,上游是 Univer

Apache-2.0 是宽松许可里对企业最友好的一档:可商用、可修改、可再分发,并附带明确的专利授权条款。对「能不能放进公司内部工具链」这个问题,许可本身不构成障碍。

真正需要区分的是上游与集成层:办公内核来自 Univer 项目,本插件做的是把它接进 DSH 的运行时。同一个作者还维护另一个 univer-workspace 插件(★70.8),定位更偏工作区形态。选型时把「我依赖的是 Univer 的能力」和「我依赖的是这个 DSH 集成」分开看——前者是内核,后者是接入方式,升级节奏和出问题时的定位范围都不一样。

读到这里,如果对你有帮助
不解锁内容

遥测:默认开启,但不上报文件内容

README 原文:「插件激活后默认发送匿名使用统计(不含文件内容与路径),发布包不声明 postinstall 脚本。」对应到配置表,就是 telemetry 默认 true。

三点值得记住:上报的是匿名使用统计;README 明确不含文件内容与路径;发布包不声明 postinstall 脚本——也就是说安装环节不会额外执行一段安装期脚本。要关掉它,两条路任选:设环境变量 DO_NOT_TRACK=1,或者把配置项 telemetry 改成 false。合规敏感的环境建议在引入前就把这条定下来,而不是等审计时再回头找。

供应链:官方包名与仿冒占位

生态安全角度值得单独提一句:这个项目为防仿冒,刻意占住了若干相似包名并标记为 deprecated——dsh-univer-plugin、dsh-univer-office-suite、dsh-univer-suite、univer-office-suite、univer-office。它们不包含插件代码,作用是把容易混淆的名字握在自己手里,避免有人抢注后投毒。README 同时说明,本包的 npm 发布者账号已与仓库 dream-num/dsh-univer-office 校验一致。这两条合起来,是一套相当克制的供应链防护。

引进前值得先知道的四个坑

坑一:站点档位是「仅索引」,别当成已验证。 现象。 详情页挂着「✓ 可直接安装」的徽章,很容易顺手理解成「已经验证过能用」。

原因。 站点对它的信任档位写的是「仅索引 —— 本站尚未对其实装验证,仅收录元数据」;「装得上吗」区块的结论是静态安装检查通过(未做真实安装);风险分级也标注为本站尚未覆盖,而未覆盖不等于无风险。

解决。 把「静态检查通过」和「实装验证」当成两件事看。它证明的是清单能被解析、依赖声明成立,不证明运行时一定顺;要上生产,就自己按官方步骤真实装一遍再下结论。

坑二:遥测默认开启。 现象。 装完不清楚插件到底有没有往外上报数据。

原因。 配置项 telemetry 默认 true,插件激活后默认发送匿名使用统计。很多人默认「开源插件默认干净」,但默认值就是开着的。

解决。 设 DO_NOT_TRACK=1 或配置 telemetry: false 关闭。顺带确认一点:README 说明上报不含文件内容与路径,发布包也不声明 postinstall 脚本——这两条决定了它的风险面主要在「用量统计」而非「内容外泄」。

坑三:装了 dsh-better-sidebar 之后预览入口会变。 现象。 文件树里点 .univer 文件的预览行为,与插件文档描述的不完全一致。

原因。 README 原文:文件树预览是在 DSH 自带右侧栏注册一个 tab 类型,认领以 .univer 结尾的 dsh-resource://file/ 地址;而安装 dsh-better-sidebar(^0.19.0)期间,它会以同档位、更宽的模式接管文件地址,此时预览改为注册成它的文件预览器。两种宿主形态都覆盖,且任一时刻只有一条生效**。

解决。 把它当成预期中的接管,而不是插件装坏了。想判断当前走哪条路径,看右侧栏预览器的归属即可。

坑四:旧 .univer 文件会被自动升级到 v3,并留下备份。 现象。 打开一个旧版 .univer 文件后,旁边多出一个备份文件,第一反应是「被改坏了」或「怎么多了一份」。

原因。 README 原文:打开旧版文件时会自动升级到 v3——先在原文件旁保存备份,在临时副本中完成迁移和验证,成功后才替换原文件;升级失败时原文件保持不变。再次打开同一份未变化的文件会复用这份备份,不会再复制一份;文件优化则仅升级输出副本,不修改源文件。

解决。 备份是设计的一部分,正常保留即可。真正要留意的是它在磁盘上会额外占一份空间——这是可预期的成本,不是异常。

总结

许可这一层,Apache-2.0 基本不需要纠结;真正需要主动决策的是遥测默认值和引入前的自验动作,以及理解文件树预览会和 dsh-better-sidebar 动态换位。把这三件事想清楚,比读十页功能列表更有用。想横向对照同类插件的许可、语言支持与安装形态,可以从 DeepSeek Harness Hub 插件清单 入手。

适合与不适合

适合:需要在本公司工具链里内置表格、文档、幻灯片能力、并会先过一遍许可与遥测的团队;接受 Apache-2.0 并愿意按需关闭遥测的合规敏感环境;已经装或打算装 dsh-better-sidebar、想弄清预览接管关系的人。

不适合:把「✓ 可直接安装」当成「已验证可用」的人——站点档位是「仅索引」,静态检查通过不等于实装验证过,未做风险分级也不等于无风险;介意默认遥测、又不打算逐个环境设 DO_NOT_TRACK=1 或 telemetry: false 的团队;指望办公内核与 DSH 集成同节奏演进的人——两者不是一个项目,出问题时定位范围不同。

标签:dsh-univer-office、DeepSeek Harness、开源生态、许可合规、遥测

本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。

读 dsh-univer-office 的源码:Viewer 挂载与草稿隔离

dsh-univer-office(Univer 办公套件,dream-num,446★、综合分 67.5、周下载 11,709、Apache-2.0)的 README 里,真正值得逐字看的是两段:一段讲 Host 组合,一段讲部署与网络。前者说明它怎么接进 DSH 插件模型,后者说明 Viewer 与鉴权边界画在哪里。

站点对它的信任档位是「仅索引」——本站尚未对其实装验证,仅收录元数据;「装得上吗」区块是静态安装检查通过(未做真实安装)。所以下文读的是公开架构描述与源码组织,不是运行时实测结论。

形态:一个标准 DSH bundle

README 原话是:「本项目是一个标准 DSH bundle。Host 组合 Univer Service Provider、Tools Consumer、webServer Consumer 和 Skill Provider;插件自带 Gateway、Viewer、无头 Unit Content Worker 与 Slide render machine。」

信息量在组合方式:它没有自建服务栈,而是把能力拆成「向 DSH 提供的」和「向 DSH 索取的」两类。Service Provider 对外提供 Univer 能力;Tools Consumer 消费工具注册能力(那十几个 univer_* 工具就挂在这里);webServer Consumer 消费 WebServer 的挂载点;Skill Provider 提供任务指引。自带四件里,Gateway 是本地服务进程,Viewer 是浏览器界面,无头 Unit Content Worker 负责没有 UI 时的内容计算,Slide render machine 专做幻灯片渲染。

挂载与鉴权:挂在 DSH origin 上,不另开端口

README 原文:「Viewer 页面、HTTP API 与 WebSocket 协作流量由插件直接挂载在 DSH WebServer origin 上(/univer-viewer/... 与 /uf/...),远程部署沿用现有 DSH 访问入口即可,无需额外反向代理配置。每个浏览器请求先通过 connection 服务完成 DSH 浏览器鉴权,再限定到指定 live session 的范围;Gateway 始终只监听 loopback,不对外暴露。(原 viewerBaseUrl 配置已随本次变更移除,保留时会被忽略。)」

要点就三条:路径在 DSH 自己的 origin 下,不需要按插件单独配反向代理;鉴权由 DSH 的 connection 服务统一做,之后还把请求限定到某个 live session;真正监听网络的 Gateway 只在 loopback。即浏览器可见的都从 DSH 入口进,插件自己的服务不出本机。

草稿隔离:写入不落到当前版本

README 的工作流是:描述目标并给出源文件 → Agent 创建隔离草稿并在其中编辑 → 实时预览 → 确认后更新当前版本,或放弃草稿而不影响当前版本。工具面对应 univer_worktree(创建、提交、继续修改、确认或放弃隔离草稿);审阅时还能把草稿或已提交 worktree 从「查看」切到「比较」,与固定的主线版本或另一个活跃 worktree 并排看。

关键句是:「确认和放弃都必须由用户明确提出。」 Agent 不会直接把改动覆盖到当前版本——这条把「AI 改了办公文件」从「不可逆」变成「可审阅」,是设计意图最清晰的一处。

读源码时容易读错的四个点

坑一:文件树预览依赖 DSH 自带右侧栏的注册机制。 现象。 关掉「自动实时预览」后,以为文件树里也就看不了 .univer 文件了。

原因。 README 原文:文件树预览「整个过程不需要 Agent 执行任何操作,因此在关闭自动实时预览后依然可用」;它的实现是在 DSH 自带右侧栏注册一个 tab 类型,认领以 .univer 结尾的 dsh-resource://file/** 地址,是一条独立注册路径。

解决。 把「文件树预览」和「实时 Univer 窗口」当两条入口分开理解:一个走宿主侧栏注册,一个走会话内窗口组件。

坑二:三个预览开关彼此独立,旧版 DSH 的设置路径还不同。 现象。 关掉一个开关,另一个还在弹,以为开关串了。

原因。 README 原文:文件树预览、实时 Univer 窗口、会话审阅卡片由各自的开关独立控制;后两者的开关在侧边栏「插件」页面中的 dsh-univer-office 详情页,而 0.1.6-alpha.2 之前的 DSH 版本在「设置 → 插件 → 插件配置」。

解决。 按版本找对设置路径,再逐个关——它们是三处独立开关,不是一处总闸。

坑三:SVG 资源缓存目录跟着 DSH_HOME 走。 现象。 找资源缓存位置、或磁盘占用冒出来时对不上号。

原因。 默认 resourceCacheRoot = $DSH_HOME/cache/dsh-univer-office/resources;未设置 DSH_HOME 时使用 ~/.dsh。相关超时是 resourceDownloadTimeoutMs = 15000(单个 SVG 下载)与 resourceOperationTimeoutMs = 120000(一次资源库工具操作)。

解决。 显式设置 DSH_HOME,或直接改 resourceCacheRoot;排查磁盘先看这里,而不是翻插件安装目录。

坑四:多会话隔离,窗口和卡片不跨会话共享。 现象。 在会话 A 打开的预览窗口,切到会话 B 就看不到了,以为窗口丢了。

原因。 README 原文:「每个 DSH 会话只展示属于自己的窗口、卡片和审阅状态。」这是刻意隔离,不是渲染丢失。

解决。 回原会话查看即可;历史审阅卡片默认折叠,需要时展开。

总结

放一起看,这套架构的取向是两个「收敛」:入口收敛到 DSH(Viewer 挂在 DSH origin、鉴权交给 connection 服务、Gateway 只监听 loopback),写入收敛到草稿(隔离草稿 + univer_worktree,确认与放弃都由用户明确提出)。读源码时先抓住这两个收敛,再去看那十几个 univer_* 工具,会比按功能列表读顺畅得多。更多同类插件的架构形态,见 DeepSeek Harness Hub 插件清单。

适合与不适合

适合:想弄清 DSH bundle 的 Host 组合方式、拿它当参考实现的插件开发者;关心 Viewer 挂载点与鉴权边界、要评估远程部署形态的架构人员;想理解「隔离草稿 + worktree 比较」这套写入防护的人。

不适合:想要运行时实测结论的人——站点档位是「仅索引」,本文读的是公开架构描述,未做真实安装验证;想找 viewerBaseUrl 配置的人,它已随本次变更移除,保留也会被忽略;把三个预览开关当成一个总开关的人,按版本找错设置路径会一直原地打转;需要在会话之间共享预览窗口的人,多会话隔离是设计而非缺陷。

标签:dsh-univer-office、DeepSeek Harness、源码解读、插件架构、草稿隔离

本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。

本文同步发布于

这篇内容有帮助吗
赞赏随意,不解锁任何内容,也不必留个人信息。
扫码用
查看 Univer 办公套件 插件详情
安装命令 · 中文 README · 兼容性报告
前往插件页 →
回到顶部