README.zh.md 4.2 KB
description: "随包附带的 Word、PowerPoint 和 Excel 指令，供需要 Office 文件编写与结构检查能力的部署使用。"
kind: "package-reference"
@deepseek-ai/dsh-skill-office
English | 中文
概述
Agent（智能体）可以加载 Word、PowerPoint 和 Excel 工作流，默认使用内置 Python 环境，并遵循用户或 AGENTS.md 明确指定的环境。这些 skill（技能）涵盖创建、局部编辑、结构检查和文件交付。视觉检查以模型支持图片且有可用渲染工具为前提；普通文档交付不要求安装渲染器。
目录
使用本包
将本提供方与 skill 注册表及 dsh-tool-skill 一同挂载，即可在会话目录中提供 office-docx、office-pptx 和 office-xlsx。提供方携带指令和脚本；部署提供解释器、编写库、执行工具与文件交付工具。
最小配置
- name: '@deepseek-ai/dsh-skill-office'
| 字段 | 默认值 | 含义 |
|---|---|---|
assetRoot |
包内的 assets/ |
包含三个 skill 文件夹和共享 scripts/ 的绝对资源目录；部署可将其放在应用归档之外。 |
相对路径、资源缺失或 skill 文件的 YAML frontmatter 缺少描述都会导致激活失败。卸载插件会移除其候选项。项目和用户 skill 的优先级仍由 skill 注册表负责。
结构检查
共享 Python 检查器读取 DOCX、PPTX 或 XLSX，不修改源文件。它识别 Transitional 与 Strict OOXML 命名空间，验证 ZIP/XML 和包内引用关系，报告文档结构，并可检查必需文本或幻灯片／工作表数量。DOCX 文本断言覆盖正文、分节引用的页眉和页脚，以及正文引用的脚注和尾注；批注、词库文本与未引用的部件或脚注／尾注不能满足断言。它只使用 Python 标准库。无效包、损坏或加密的 ZIP 成员和报告文件写入失败都会在标准输出中产生 JSON 失败报告。检查通过不代表外观、特性保留或公式计算结果已得到验证。
了解实现
实现细节——点击展开
提供方注册三个内置候选项，并在激活时从随包 YAML frontmatter 读取描述。加载后的指令正文不包含这些元数据。加载后的每个 skill 暴露自己的文件系统目录，因此执行工具可以定位共享检查器，而不依赖任务工作目录。可配置的外部资源支持 Python 无法读取应用归档的分发方式。 | 文件 | 职责 | |---|---| | [`src/index.ts`](src/index.ts) | 提供方注册与配置资源路径。 | | [`assets/`](assets/) | 三种工作流和只读 OOXML 检查器。 | | — | 不发布运行时不变量伴随入口：提供方拥有不可变候选项，skill 注册表负责注册生命周期和优先级。 |延伸阅读
模型体验
通过 dsh-tool-skill 间接呈现，由其渲染目录项与选中的指令正文。
KV 缓存影响
挂载提供方会增加三个目录项；加载 skill 时，其正文进入既有 skill 工具的插入位置。提供方不另增提示词分区。
已知限制与暂缓事项
- 提供方不安装 Python、编写库或渲染引擎。检查器要求 Python 3.9 或更高版本。
- 结构检查不判断分页、裁切、字体、图表外观或 Excel 重算。
- 检查器只接受 DOCX、PPTX 和 XLSX；传统格式、加密文件和启用宏的格式需要合适的其他工作流。