第二章　官方自带：开箱即用的 Office 技能族

本章导读

如果你只装一组技能，就装这组。

DeepSeek Harness 官方随包分发了一套 Office 技能族，由 @deepseek-ai/dsh-skill-office 提供，共七个技能，覆盖 Word、Excel、PowerPoint 的创建、编辑、校验、渲染、格式转换与公式重算。它们不是社区爱好者写的玩具，而是 dsh 自己文档工作流的组成部分。

更重要的是：这套技能的安装方式与众不同——不用复制任何文件，只要在组合配置里挂一行提供方。

为什么值得优先装

三个理由：

理由 说明
零维护 随 dsh 版本升级，无需手动更新
权威 官方出品，与 dsh 的审批、沙箱、工具链深度配合
省上下文 渐进加载，非办公任务时七个技能只占七条摘要

七个技能一览

技能 职责 你什么时候会用到
office 任务路由：判断该进哪个子技能 模型自行选择时首先命中它
office-docx 创建、读取、编辑、校验 .docx 写报告、改合同、批量生成公文
office-xlsx 读取、创建、编辑、校验工作簿与公式 做台账、清洗数据、校验表格
office-pptx 创建、读取、编辑、校验 .pptx 做汇报稿、改模板
office-export-pdf 用 LibreOffice 转 PDF 交付前的格式固化
office-render 渲染文档图片、检查视觉布局 确认排版是否真好看
office-recalculate 刷新公式缓存并校验计算结果 防止“看起来对、算出来错”

安装：一行配置

在组合配置中加入提供方：

- name: '@deepseek-ai/dsh-skill-office'

这一行的含义是：在技能注册表与 dsh-tool-skill 旁挂载一个技能提供者。提供方负责提供技能说明；操作类技能在加载时会附加解释器与 CLI 的绝对路径。

提供方有三个可配置字段：

字段 默认值 含义
assetRoot 载体资源或包内 assets/ 含七个技能目录的绝对路径
node 宿主 Node.js 操作技能使用的独立 Node 可执行程序
cli 已安装的 Kit CLI CLI 入口绝对路径，false 表示禁用操作执行

普通用户不需要改任何字段，用默认值即可。

一个必须知道的设计：宿主不按扩展名注入

官方明确写了一条行为准则：模型依据任务选择技能，宿主不会根据文件扩展名注入完整说明。

这句话的实践含义是：你丢一个 .docx 进去，dsh 不会自动加载 Word 技能。必须任务本身匹配上技能的 description，或者你显式调用。所以如果发现“我明明在改 Word，它却没用技能”，先试试明确说“用 office-docx 技能来处理”。

渐进加载的工作流

官方给的路由逻辑是这样的：

初始目录：七条 Office 摘要
   ├─ 非办公任务 → 不加载任何 Office 指令，继续干活
   └─ 办公任务 → skill(office) 任务路由
                    ├─ 创建或编辑 → office-docx / office-pptx / office-xlsx
                    │       └─ 创作并校验内容、结构与数据 → 交付
                    └─ 需要图片、视觉检查或外观修改 → office-render

注意最后一条分支：用户要求的外观修改（包括单元格填充、文本对齐），即使没有明确要求视觉检查，也需要渲染。 这是官方写进技能说明的规则，目的是避免“改完不知道长什么样”。

本章小节

  • 2.1 office：总路由与渐进加载
  • 2.2 office-docx：Word 三件套之一
  • 2.3 office-xlsx：Excel 与公式校验
  • 2.4 office-pptx：演示文稿
  • 2.5 office-export-pdf 与 office-render：交付与视觉把关
  • 2.6 office-recalculate：让公式结果可信

延伸阅读