# DOCX Validate

> 验证DOCX文件格式有效性

- Skill: `cas-bigdatalab/docx-validate` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add cas-bigdatalab/docx-validate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cas-bigdatalab/docx-validate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: cas-bigdatalab (https://skillmd.com/u/cas-bigdatalab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cas-bigdatalab/docx-validate

---


# docx_validate 技能

## 功能说明

该技能验证DOCX文件格式的有效性，检查文件是否为有效的ZIP压缩包，以及是否包含DOCX所需的必要文件。

## 核心功能

- 检查文件是否存在
- 验证是否为有效的ZIP文件
- 检查必要文件是否存在
- 检查XML文件编码
- 输出详细的验证结果

## 使用方法

```bash
python scripts/run_docx_validate.py --input_path <输入DOCX> --output_path <输出JSON>
```

## 参数说明

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| :--- | :--- | :--- | :--- | :--- |
| input_path | string | 是 | - | 输入DOCX文件路径 |
| output_path | string | 是 | - | 输出JSON结果文件路径 |

## 示例

```bash
python scripts/run_docx_validate.py --input_path document.docx --output_path result.json
```

## 输出格式

```json
{
  "valid": true,
  "file_exists": true,
  "is_zip": true,
  "has_required_files": true,
  "required_files": [
    "[Content_Types].xml",
    "_rels/.rels",
    "word/document.xml"
  ],
  "missing_files": [],
  "file_size": 102400,
  "total_files": 15,
  "errors": [],
  "warnings": []
}
```

## 验证项目

| 项目 | 说明 |
| :--- | :--- |
| valid | 整体验证结果 |
| file_exists | 文件是否存在 |
| is_zip | 是否为有效ZIP文件 |
| has_required_files | 是否包含必要文件 |
| required_files | 必需文件列表 |
| missing_files | 缺失的必需文件 |
| file_size | 文件大小（字节） |
| total_files | ZIP内文件总数 |
| errors | 错误信息列表 |
| warnings | 警告信息列表 |

## 注意事项

- 输出目录不存在时会自动创建
- 返回码为0表示验证通过，非0表示验证失败