dsh-univer-office Skills体系揭秘:univer-sheet与univer-slide如何教会AI写专业办公文档

原创2026-11-06 12:29:091,675 阅读
文章标签:AI 插件dsh-plugin人工智能工具调用前端

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 按需取用。

dsh-univer-office Skills 体系全景:从自然语言需求到专业办公文档


二、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 截图"看一眼" → 重算公式 → 才允许导出。

univer-sheet 生成的专业电子表格,带条件格式与图表

正因为有这套规则,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 页:

  1. 备好本页图片、图标等资源;
  2. 手写完整 SVG;
  3. univer_compile_svg 编译到目标页;
  4. 清除所有编译告警;
  5. univer_inspect + univer_lint 检查;
  6. 有问题就改 SVG、重新替换,直到干净。

其中 univer_lint 会用真实渲染的字形几何检查三类硬伤:文字跑出页面、文字溢出容器、文字互相重叠。这等于给 AI 装了一双"审校的眼睛"。

univer-slide 要求 AI 逐页打磨的专业幻灯片工作流

3. 原生图表、表格、转场也讲"规矩"

PPT 里的图表不能"贴死"数值快照,手册要求走原生图表 API,数据才能联动;改完还要回读校验。转场动画同理——"写进去了"不等于"能播",手册要求以 getTransition() 为准、不夸大能力。

univer-slide 生成的专业 PPT 幻灯片,AI 办公文档审阅界面

这套"SVG 生成 + 逐页闭环 + 渲染级 lint"的组合拳,正是 AI 能把一份 PPT 做到"配色统一、不溢出、不重叠"的原因。


五、从需求到成品:一次完整的 AI 办公之旅

把上面两本手册串起来,就是 univer 总纲里那条标准工作流(见 univer 技能包)。无论做表格还是 PPT,AI 都按同一条节奏走:

状态查询 → 建/选 worktree → 建/导入内容单元 → 加载对应 Skill
        → 解析不熟的 API → 修改内容 → 回读校验
        → (PPT) lint → 截图复核 → 导出 → 标记 ready

这条流程对用户最友好的地方是:所有改动都先进入一个"隔离草稿",你能实时看着它、随时要求修改。满意了再"合入当前版本",不满意直接"丢弃"。AI 永远不会直接覆盖你的正式文件。

dsh-univer-office 实时预览窗口:AI 正在写电子表格,用户可实时观看

做幻灯片时,同样的实时窗口会把每页的改动呈现给你,配合逐页自检,整个过程透明可控:

univer-slide 实时预览窗口: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 写专业办公文档?答案可以浓缩成三句:

  1. univer-sheet:把单元格当结构化数据、公式算完再读、每次自检 + 截图,保证表格"算得对、格式不乱"。
  2. univer-slide:用 SVG 生成页面、逐页闭环打磨、渲染级 lint 审校,保证 PPT"不溢出、不重叠、风格统一"。
  3. 8 个技能包 + 一条标准工作流:按需加载、隔离草稿、可审阅可丢弃,让 AI 既"动得对"又"管得住"。

对新手而言,你只需要学会把需求说清楚,剩下的"专业性",已经由这套 Skills 体系替你兜底了。

登录后查看全文
dsh-univer-office