新星DSH办公插件 Univer Office:智能体办公自动化

DeepSeek Harness（DSH）是个智能体运行框架，你用它跑任务、连工具、出活。dream-num 开源的 dsh-univer-office 插件（GitHub 全名 dream-num/dsh-univer-office）做的事很直接：给 DSH 装上一套真实的办公环境，让智能体用自然语言创建和编辑电子表格、文档、幻灯片、多维表、画布，再把成品导成 xlsx、docx、pptx 这种真文件。仓库当前 ★500（新星档）、44 forks、9 个开放 issue，Apache-2.0 协议，主语言 TypeScript，2026 年 8 月 15 日创建，最近一次更新是 2026 年 10 月 8 日，官网挂在 office.univer.ai。

这个插件的核心不是「又一个 Office 界面」，而是一套「先改草稿、你点头、再落版本」的工作流。它内置的 Univer 是一个能同时画表格、文档、幻灯片的开源办公内核，一个 .univer 文件可以同时装五类内容，公式和内嵌内容还能跨内容互相引用。智能体的每次写操作都先进隔离的改动草稿区（worktree，像 git 分支一样不直接动主干），你实时看 live 预览，采纳（approve）或丢弃（discard）由你决定。这篇文章按仓库视角讲清楚七件事：是什么、能干啥、架构、怎么装、怎么用、有什么坑、最后一点启发。

🔥 一、它是什么

（图注：DSH Univer Office 是什么的四张卡片——Univer 办公内核 / DSH 智能体宿主 / draft 审阅模型 / worktree 多智能体协作，配仓库基础信息徽章）

一句话：它不是 Office 软件，而是给 DeepSeek Harness（DSH）这个智能体宿主装上的「办公能力插件」。

拆开看，这个名字里有两个关键角色。Univer 是底层的开源办公引擎，可以理解成一个能同时画表格、文档、幻灯片、多维表、画布的内核——微软 Office 是五个独立程序，Univer 是一个内核五类内容。插件把这套内核包进 DSH 的标准插件体系，智能体就能像调工具一样调它。DSH（DeepSeek Harness） 是宿主框架，负责跑智能体、管任务、接工具，办公插件就是挂在它 web profile 上的一个 bundle。

交互模型是它区别于「AI 生成 PPT 网页版」的关键：每个写操作都先落在一个隔离的 draft 里，不会直接覆盖你正在看的版本。你在浏览器里实时看到 live 预览，觉得对就 approve（采纳），觉得不对就 discard（丢弃），智能体从头再来。想多智能体协作时，用语义级 worktree 对比——View 或 Compare 可以并排看当前草稿和主干（trunk）、或者另一个 worktree 之间，在 Sheet、Doc、Slide、Base、Board 五类内容上逐块看差异。这个模型和 git 分支的直觉一致：改动隔离、可对比、可回滚。

🔥 二、能干啥

（图注：五类内容对照——Sheet 电子表格 / Doc 文档 / Slide 幻灯片 / Base 多维表 / Board 画布，各自能建什么、能验什么、能导什么，含 draft 审阅模型说明）

它一次能覆盖五类办公内容，而且全部装在一个 .univer 文件里，公式和内嵌内容可以跨内容互引：

Sheet（电子表格）：单元格、公式、样式、表、图表、透视表、筛选、数据校验、图片，导出 .xlsx、.csv、.tsv。工资表、销售汇总这类场景直接做。

Doc（文档）：段落、富文本、列表、任务、表格、图片、页眉页脚、分页，导出 .docx。周报、正式文档这种结构化的长文走这里。

Slide（幻灯片）：页、文本、形状、图片、表格、图表、转场，导出 .pptx。教学演示稿、汇报材料。

Base（多维表，类似轻数据库）：表、字段、记录、视图、公式、筛选、排序、分组，导出 xlsx、csv、tsv。客户跟踪、按 stage 分组的销售管道这类「表+视图」的活。

Board（画布，类似白板）：形状、文本、连接线、图片、原生图表、路径，目前暂不支持导出。流程图、连线图可以画，但拿不走文件。

注意一个逻辑：每个写操作先进隔离 draft，你看 live 预览，approve 之后才落版本，导出 xlsx、docx、pptx 是从定稿版本出成品，两者不矛盾。也别把它当全功能 Office：Slide 的母版页、版式页、演讲者备注不在编辑范围；Board 的思维导图、表格、墨迹、高级编辑和文件导出目前都不支持。

🔥 三、架构是怎样的

（图注：DSH bundle 内 Univer 四件套——Gateway（仅 loopback，端口 9080）/ Viewer（同源浏览器预览）/ headless Unit Content Worker（后台渲染）/ Slide 渲染机，配依赖方向与遥测说明）

架构上它是标准 DSH bundle（来自 deepseek-ai/deepseek-harness 的插件体系），一个 TypeScript 包（pnpm@11.23.0 开发），由四个角色组合：Univer Service Provider + Tools Consumer + webServer Consumer + Skill Provider。里面真正干活的是四块：

Gateway（服务入口）：默认监听 9080 端口，被占用就 9081 逐位上探。它只在本机回环地址（loopback）上监听，不对外网开放——远程协作靠的是智能体侧，不是把端口开出去。

Viewer（浏览器端）：你在浏览器里看到的实时预览，挂在 DSH WebServer 同源下（/univer-viewer/、/uf/），HTTP API 和 WebSocket 都走同一条路，浏览器 Cmd/Ctrl+R 刷新即生效。draft 的 live 预览、approve、discard 全在这完成。

headless Unit Content Worker（后台渲染进程）：不占屏幕、在后台跑，负责执行写操作、生成内容，以及给截图、PDF、版式检查出图。

Slide 渲染机：幻灯片逐页渲染，配合本地 Chromium 系浏览器做越界、溢出、重叠文本的检查。

仓库结构是 packages/（monorepo 分包）、src/、skills/（内置任务指导）、docs/architecture.md、test/，中英文双 README（README.zh-CN.md 可查中文）。

🔥 四、怎么装

（图注：安装四步——① 查 Node.js ≥22.19 与 DSH 版本（跑着先 Ctrl+C）② dsh plugin --profile web add dsh-univer-office ③ dsh web 重启 + 浏览器刷新 ④ 一行命令卸载，含 5 个占位空壳包警示）

安装前提两样：Node.js 不低于 22.19，以及 DSH 的 0.1.5-rc.3、0.1.7-rc.1 或 0.2.0-rc.1 三个受支持版本之一。如果 DSH 正在跑，先 Ctrl+C 停掉再装。

装就一条命令：

dsh plugin --profile web add dsh-univer-office

然后重启：

dsh web

浏览器里 Cmd/Ctrl+R 刷新，Viewer 就带上了 Univer 办公能力。卸载也是一行：

dsh plugin --profile web remove dsh-univer-office

两个容易踩的点。第一，npm 包名认准 dsh-univer-office，另外还有 5 个同名占位包（比如 dsh-univer-plugin 等）是防冒名的空壳，装上等于没装，别手滑装错。第二，需要截图、PDF、版式检查、SVG 文字测量时，本机得有 Chrome、Chromium 或 Edge，系统会自动检测，Windows 上可以设 browserExecutablePath 或 UNIVER_RENDER_BROWSER 指到具体路径。旧版本打开的 .univer 文件会自动升级到 v3 格式并备份，不用担心数据丢。

🔥 五、怎么用

（图注：使用流程——自然语言下达任务（工资表示例 / 6 页冒泡排序 PPT 示例），15 个工具由 DSH 自动选，重点几个：univer_new、univer_execute、univer_inspect、univer_lint、univer_export、univer_screenshot）

日常使用就是对人说话，不用你手写调用工具。插件自带 15 个工具，DSH 按任务自动选，一般用不着手动调，其中几个值得认识：univer_new 和 univer_status（新建、看状态）、univer_execute（执行编辑，落进 draft）、univer_inspect 和 univer_export（检查内容、导出文件）、univer_lint（查 Slide 越界、溢出、重叠文本）、univer_screenshot 和 univer_print_pdf（截图、出 PDF）、univer_compile_svg（画布编译）、univer_worktree 和 univer_unit（切 worktree、切内容单元）、univer_import（导入）、univer_api（按关键词查内置 Univer API 符号）、univer_resources（查内置图标、logo、emoji、插画）。

举两个仓库 README 里的示例感受一下。第一个：「做个工资表，列是 employee、base salary、bonus、deduction，gross 和 net 自动求和」——智能体建 Sheet、写公式、做校验，落进 draft，你预览确认后导 xlsx 或 csv。第二个：「做 6 页冒泡排序教学 PPT，逐页检查版式」——智能体建 Slide、逐页过 univer_lint 查溢出，导 pptx。还有几个典型：做一份正式周报（执行摘要、本周进展、风险表、下周计划、页眉页脚，导 docx）；做客户跟踪 Base（company、contact、stage、expected value、next action，按 stage 分组视图）；同一个文件里既有销售 Sheet 又有摘要 Slide，Slide 的图表直接读 Sheet 的数据——这就是「一个 .univer 文件装五类内容、跨内容互引」的实际用法。

🔥 六、需要注意什么 / 风险

（图注：四类注意点——① 截图/PDF/版式检查/SVG 测量需本地 Chromium 系浏览器（纯编辑不一定需要）② Board 与 Slide 母版/备注的边界 ③ 5 个同名占位包是空壳别装错 ④ 遥测默认开（匿名），DO_NOT_TRACK=1 可关）

四类事想清楚再用。

第一，浏览器依赖有范围。截图、PDF、Slide 版式检查、SVG 文字测量这四件事需要本机的 Chromium 系浏览器（Chrome、Chromium、Edge 自动检测，Windows 可显式指定 browserExecutablePath 或 UNIVER_RENDER_BROWSER）。纯编辑、导入导出 xlsx、docx、pptx 不一定需要它，看你要做什么。

第二，别超边界用。Board 目前不支持思维导图、表格、墨迹、高级编辑，也不支持文件导出；Slide 的母版页、版式页、演讲者备注不在编辑范围内。它是「智能体办公自动化」，不是「全功能 Office 替代」。

第三，装包时核对包名。npm 上 dsh-univer-office 之外有 5 个同名占位包（dsh-univer-plugin 等），是防冒名的空壳，装错了等于没装。

第四，遥测默认开。是匿名遥测，不含文件内容、不含路径；介意的话设 DO_NOT_TRACK=1 或在配置里写 telemetry:false 就关掉。Gateway 只在本机回环上，不对外网暴露。

🔥 七、启发

（图注：启发总结——智能体办公自动化的可行路径 + 关键数字（★500 / forks 44 / issues 9 / 15 工具）+ 适合 / 不适合判断 + 仓库信息（2026-08-15 创建 / 2026-10-08 更新 / Apache-2.0 / TypeScript））

它给「智能体办公自动化」指了一条工程上说得通的路：把「建 → 验 → 采纳」做成标准动作（draft + live 预览 + approve/discard），用 worktree 做隔离协作，变更是版本化的、可对比、可回滚的。对习惯 git 工作流的人来说，这套模型零心理负担——智能体改错了，丢草稿重来，你的正式文件一动没动。

它不是全功能 Office（Board 导出、Slide 母版和备注是明确边界）；它不是独立软件，是挂在 DSH 宿主上的插件，离开 0.1.5-rc.3 / 0.1.7-rc.1 / 0.2.0-rc.1 这三个 DSH 版本就转不起来；它也不是要你手写调 15 个工具——那是 DSH 自动完成的事，你只管说需求。

适合：日常要「自然语言 → 办公文件」的团队——数据表、周报、演示稿、客户跟踪；想要多智能体隔离协作、变更可回溯的场景。不适合：需要全功能 Office 细节（母版、备注、思维导图）的人，以及没有 DSH 环境的人。仓库才 500 颗星、44 个 fork、9 个开放 issue，属于新星档，想看现在多少星，直接打开 dream-num/dsh-univer-office 看右上角的数字，比任何转述都准。