dsh-univer-office Skills体系揭秘:univer-sheet与univer-slide如何教会AI写专业办公文档
dsh-univer-office Skills体系揭秘:univer-sheet与univer-slide如何教会AI写专业办公文档
📊 dsh-univer-office 是 DeepSeek Harness(DSH)的 Univer 办公插件。它内置了一套 Skills 技能体系,教会 AI 像真正的办公专家一样创建 Excel 表格、Word 文档和 PPT 幻灯片。这篇文章就带你拆解其中的 univer-sheet 与 univer-slide——它们究竟如何一步步"教会"AI 写出专业办公文档。
对新手来说,核心结论其实很直白:你不是在"用代码"指挥 AI,而是在用一套写给 AI 看的"岗位手册"。 这套手册就叫 Skills,而 univer-sheet 和 univer-slide 正是其中管电子表格和幻灯片的两本"说明书"。
一、什么是 Skills:写给 AI 的"岗位手册"
很多人以为 AI 生成文档是"碰运气"——模型临场发挥,写得对不对全看心情。dsh-univer-office 的做法完全不同:它把每一种办公能力都写成一份 SKILL.md 技能文档,在 AI 动手之前就先加载进它的"脑子里"。
打个比方:新手司机上路要背《驾驶手册》,AI 写专业表格前也要背
univer-sheet。手册里写清了"怎么读单元格、怎么算公式、写完怎么自检",AI 照着做,输出自然就专业。
每份技能文档的开头都有一段 description(描述),它告诉 AI 什么时候该主动加载这本手册。例如 univer-base 技能包 开头就声明:只要任务涉及 Base 表、字段、记录、视图,就该加载它。这种"声明式触发"让 AI 能自己判断该请出哪本手册。
这些技能文档并不散落在各处,而是被统一注册进 DSH 的技能系统。注册逻辑在 src/host/skills/plugin.ts 里完成——它把每个 skills/<名称>/SKILL.md 登记为一个"技能候选",供 AI 按需取用。
二、Skills 全景:8 个按需加载的"技能包"
dsh-univer-office 一共内置了 8 个技能包,覆盖全部办公内容类型。它们各司其职,AI 会根据你的需求"点名"加载对应的那一本:
| 技能包 | 管什么 | 一句话定位 |
|---|---|---|
univer |
总纲 | 多内容文件、worktree、工具地图的"通用流程手册" |
univer-sheet |
电子表格 | 单元格、公式、图表、校验 |
univer-slide |
幻灯片 | 页面、SVG 布局、转场、逐页自检 |
univer-doc |
文档 | 段落、富文本、分页、页眉页脚 |
univer-base |
多维表格 | 表、字段、记录、视图、公式字段 |
univer-board |
画布 | 形状、连线、流程图 |
univer-embed |
内容嵌入 | 把一个内容单元嵌进另一个 |
univer-cross-unit-formula |
跨单元公式 | 一个内容读取另一个内容的数据 |
这套"总纲 + 专项"的结构很关键:AI 会先加载 univer 总纲,掌握通用的文件管理和工具地图;再加载对应的专项技能(写表格就加载 univer-sheet,做 PPT 就加载 univer-slide)。这样既不会遗漏通用规则,也不会被无关细节干扰。
💡 这种设计就是"专业"的根源:通用流程只学一遍,专项细节按任务精确到位。
三、univer-sheet:教会 AI 像 Excel 专家一样写表格
univer-sheet 这份手册,本质上是在纠正 AI 最容易"翻车"的几个地方。它不堆砌 API,而是给出一连串专家级的避坑规则。
1. 把"单元格"当成结构化数据,而不是"一串文字"
普通人会想:往单元格里填个值就行。但 AI 很容易把 "00123" 当成数字、把日期写成纯文本。univer-sheet 明确要求:每个单元格都是 { v, t, f, s } 这样的结构化数据——
v是真正参与计算的存储值;t声明类型(文本、数字、布尔、强制文本);f是公式,s是格式。
它还特别强调"日期、百分比、货币 = 数字 + 数字格式"。这一条就能避免无数"格式错乱"的尴尬。
2. 写完公式必须"等算完再读"
公式写进去并不等于立刻算出结果。手册要求 AI 先订阅"计算完成"事件,再触发计算,最后才去读值,避免读到过期的脏数据。这是新手几乎一定会踩的坑,而 univer-sheet 把它写成了硬性流程。
3. 每次都"自检 + 截图",绝不凭感觉交差
手册的"验证"章节规定了一套闭环:用 univer_inspect 回读数据 → 确认类型、公式、格式 → 用 univer_screenshot 截图"看一眼" → 重算公式 → 才允许导出。
正因为有这套规则,AI 生成的表格才敢做到"带条件格式、带图表、可导出 .xlsx"——这就是"专业办公文档"的具体模样。
四、univer-slide:教会 AI 一页一页打磨专业 PPT
如果说 univer-sheet 教的是"算得对",那 univer-slide 教的就是"画得好"。它最大的特点是:生成页面用 SVG,而不是手写画图命令。
1. SVG 是"生成路径"
对新建或重做的页面,手册要求 AI 先写一份 page-NN.svg,再用 univer_compile_svg 编译成幻灯片页。编译器负责文字测量、基线换算和几何落位,AI 只专注"这页长什么样"。这比让 AI 手算坐标靠谱得多。
2. 一个"闭环"打磨每一页
手册定义了一个严格的逐页循环,做完第 N 页才允许做第 N+1 页:
- 备好本页图片、图标等资源;
- 手写完整 SVG;
univer_compile_svg编译到目标页;- 清除所有编译告警;
univer_inspect+univer_lint检查;- 有问题就改 SVG、重新替换,直到干净。
其中 univer_lint 会用真实渲染的字形几何检查三类硬伤:文字跑出页面、文字溢出容器、文字互相重叠。这等于给 AI 装了一双"审校的眼睛"。
3. 原生图表、表格、转场也讲"规矩"
PPT 里的图表不能"贴死"数值快照,手册要求走原生图表 API,数据才能联动;改完还要回读校验。转场动画同理——"写进去了"不等于"能播",手册要求以 getTransition() 为准、不夸大能力。
这套"SVG 生成 + 逐页闭环 + 渲染级 lint"的组合拳,正是 AI 能把一份 PPT 做到"配色统一、不溢出、不重叠"的原因。
五、从需求到成品:一次完整的 AI 办公之旅
把上面两本手册串起来,就是 univer 总纲里那条标准工作流(见 univer 技能包)。无论做表格还是 PPT,AI 都按同一条节奏走:
状态查询 → 建/选 worktree → 建/导入内容单元 → 加载对应 Skill
→ 解析不熟的 API → 修改内容 → 回读校验
→ (PPT) lint → 截图复核 → 导出 → 标记 ready
这条流程对用户最友好的地方是:所有改动都先进入一个"隔离草稿",你能实时看着它、随时要求修改。满意了再"合入当前版本",不满意直接"丢弃"。AI 永远不会直接覆盖你的正式文件。
做幻灯片时,同样的实时窗口会把每页的改动呈现给你,配合逐页自检,整个过程透明可控:
🧩 这里的关键认知:Skills 不是一段让 AI"背下来的代码",而是一套它每一步都遵守的工作纪律。 工具(
univer_execute、univer_inspect、univer_lint、univer_screenshot)负责"动手",Skills 负责"动得对"。
六、如何上手:3 步让 Skills 为你工作
Skills 随插件一起内置,不需要你手动加载——DSH 会根据任务自动取用。你只要会"提需求"就行。
第 1 步:安装插件(需 Node.js >=22.19.0)
dsh plugin --profile web add dsh-univer-office
dsh web
第 2 步:用自然语言提需求
- 做表格:"帮我做一张薪资表,含基本工资、奖金、扣款、应发、实发,并自动算合计,加个图表。"
- 做 PPT:"做一份 6 页冒泡排序教学 PPT,讲清原理、示例、复杂度,配色友好。"
第 3 步:在会话里审阅
实时窗口会跟着 AI 的制作过程走;完成后审阅卡片留在会话里,可继续修改、合入或丢弃,需要时再让 AI 导出 .xlsx / .pptx。
想深入阅读这套手册的"原文",可直接打开 skills/univer-sheet/SKILL.md、skills/univer-slide/SKILL.md,或整体了解项目背景参见 README.zh-CN.md。
小结:专业,来自"纪律"而非"玄学"
回到开头的问题——univer-sheet 与 univer-slide 到底如何教会 AI 写专业办公文档?答案可以浓缩成三句:
univer-sheet:把单元格当结构化数据、公式算完再读、每次自检 + 截图,保证表格"算得对、格式不乱"。univer-slide:用 SVG 生成页面、逐页闭环打磨、渲染级 lint 审校,保证 PPT"不溢出、不重叠、风格统一"。- 8 个技能包 + 一条标准工作流:按需加载、隔离草稿、可审阅可丢弃,让 AI 既"动得对"又"管得住"。
对新手而言,你只需要学会把需求说清楚,剩下的"专业性",已经由这套 Skills 体系替你兜底了。





