文档解析skill使用说明

更新时间：2026-10-29

简介

文档解析Skill基于百度智能云文档解析服务，内置文档解析标准版与文档解析（PaddleOCR-VL）两套引擎，覆盖 PDF、Word、Excel、PPT、图片、扫描件等文档格式，支持解析结果以结构化Markdown输出。

Skill资源地址

GitHub：https://github.com/baidubce/skills/tree/develop/skills/baidu-document-parser

Skill安装方法

支持在 Cursor、Claude Code、OpenAI Codex、Workbuddy 等智能体中安装使用。

方式一：下载文件安装

下载文件：baidu-document-parser（提取码：q49p）
将文件夹拖入 Agent 对话框，输入以下指令：

帮我安装这个Skill：SKILL.md

方式二：通过 GitHub 链接安装

在Agent对话框中输入以下指令：

帮我安装这个Skill：baidu-document-parser.md

鉴权配置说明

在使用该skill前需要进行鉴权配置；目前支持两种鉴权方式，选择其中一种配置即可。如需了解更多鉴权机制说明，可参考鉴权认证机制。

方式一：API Key 鉴权

第一步：获取 API Key

登录百度智能云控制台，前往 API Key 管理页，单击「创建 API Key」
填写名称，在权限范围中勾选相关权限，确认创建
创建成功后，在列表中复制该 API Key 备用

第二步：配置环境变量

macOS

方式 A：一条命令写入（推荐）

打开「终端」，把 您的APIKey 换成实际值后回车执行：

                Bash
                
                echo 'export BAIDU_DOC_AI_BEARER_TOKEN="您的APIKey"' >> ~/.zshrc && source ~/.zshrc

验证是否生效：

Bash

1echo $BAIDU_DOC_AI_BEARER_TOKEN

能打印出 API Key 即表示成功。

方式 B：用编辑器打开配置文件

在终端执行：

Bash

1nano ~/.zshrc

（若提示没有该文件，先执行 touch ~/.zshrc）

在文件最后一行增加：

                Bash
                
                export BAIDU_DOC_AI_BEARER_TOKEN="您的APIKey"

按 Control + O 回车保存，再按 Control + X 退出。然后执行：

Bash

1source ~/.zshrc

也可用图形界面打开文件（不用记 nano 快捷键）：

Bash

1open -e ~/.zshrc

在打开的文本编辑中追加同一行 export ...，保存关闭后，回到终端执行 source ~/.zshrc。

若使用 bash，将以上命令中的 ~/.zshrc 全部改为 ~/.bashrc。不确定时，在终端执行 echo $SHELL，含 zsh 用 zshrc，含 bash 用 bashrc。

Windows

方式 A：图形界面（推荐）

在任务栏搜索框输入「环境变量」，打开「编辑系统环境变量」
单击右下角「环境变量」按钮
在用户变量区域单击「新建」：
- 变量名：BAIDU_DOC_AI_BEARER_TOKEN，变量值：粘贴 API Key
确定保存后，重新打开智能体客户端

方式 B：PowerShell 命令

按 Win + X，选择「Windows PowerShell」或「终端」，替换为实际值后执行：

Powershell

1[System.Environment]::SetEnvironmentVariable("BAIDU_DOC_AI_BEARER_TOKEN", "您的APIKey", "User")

关闭窗口后重新打开智能体客户端。验证：

Powershell

1echo $env:BAIDU_DOC_AI_BEARER_TOKEN

方式 C：命令提示符 cmd

Plain Text

1setx BAIDU_DOC_AI_BEARER_TOKEN "您的APIKey"

执行成功后新开一个终端窗口再验证；当前已打开的窗口可能仍读不到新变量。

Linux

                Bash
                
                echo 'export BAIDU_DOC_AI_BEARER_TOKEN="您的APIKey"' >> ~/.bashrc && source ~/.bashrc

验证：

Bash

1echo $BAIDU_DOC_AI_BEARER_TOKEN

若使用 zsh，将 ~/.bashrc 改为 ~/.zshrc。

设置完成后，请完全退出并重新打开智能体客户端，变量才能生效。

方式二：AK/SK 鉴权

使用应用的 API Key 和 Secret Key 换取 Access Token，Token 有效期 30 天，脚本自动刷新。

第一步：获取 API Key 和 Secret Key

登录百度智能云控制台，前往应用列表，在「文字识别」产品页签下，单击「创建应用」
填写应用名称，在接口选择中勾选「文字识别」相关接口，保存提交
创建成功后，回到应用列表，单击应用名称进入详情，即可看到平台分配的API Key、Secret Key，复制备用

如需更多帮助，可参考获取 AK/SK 教程。

第二步：配置环境变量

macOS

方式 A：一条命令写入（推荐）

打开「终端」（启动台搜索「终端」，或按 Command + 空格 搜索 Terminal），把 您的APIKey 和 您的SecretKey 换成实际值后回车执行：

                Bash
                
                echo 'export BAIDU_DOC_AI_API_KEY="您的APIKey"' >> ~/.zshrc
echo 'export BAIDU_DOC_AI_SECRET_KEY="您的SecretKey"' >> ~/.zshrc
source ~/.zshrc

验证是否生效：

                Bash
                
                echo $BAIDU_DOC_AI_API_KEY
echo $BAIDU_DOC_AI_SECRET_KEY

两行均能打印出对应的值即表示成功。

方式 B：用编辑器打开配置文件

在终端执行：

Bash

1nano ~/.zshrc

（若提示没有该文件，先执行 touch ~/.zshrc）

在文件最后一行增加：

                Bash
                
                export BAIDU_DOC_AI_API_KEY="您的APIKey"
export BAIDU_DOC_AI_SECRET_KEY="您的SecretKey"

按 Control + O 回车保存，再按 Control + X 退出。然后执行：

Bash

1source ~/.zshrc

也可用图形界面打开文件（不用记 nano 快捷键）：

Bash

1open -e ~/.zshrc

在打开的文本编辑中追加同样两行 export ...，保存关闭后，回到终端执行 source ~/.zshrc。

若使用 bash，将以上命令中的 ~/.zshrc 全部改为 ~/.bashrc。不确定时，在终端执行 echo $SHELL，含 zsh 用 zshrc，含 bash 用 bashrc。

Windows

方式 A：图形界面（推荐）

在任务栏搜索框输入「环境变量」，打开「编辑系统环境变量」
单击右下角「环境变量」按钮
在用户变量区域单击「新建」，依次添加两条：
- 变量名：BAIDU_DOC_AI_API_KEY，变量值：粘贴 API Key
- 变量名：BAIDU_DOC_AI_SECRET_KEY，变量值：粘贴 Secret Key
全部确定保存后，重新打开智能体客户端

方式 B：PowerShell 命令

按 Win + X，选择「Windows PowerShell」或「终端」，替换为实际值后执行：

Powershell

1[System.Environment]::SetEnvironmentVariable("BAIDU_DOC_AI_API_KEY", "您的APIKey", "User")
2[System.Environment]::SetEnvironmentVariable("BAIDU_DOC_AI_SECRET_KEY", "您的SecretKey", "User")

关闭窗口后重新打开智能体客户端。验证：

Powershell

1echo $env:BAIDU_DOC_AI_API_KEY
2echo $env:BAIDU_DOC_AI_SECRET_KEY

方式 C：命令提示符 cmd

Plain Text

1setx BAIDU_DOC_AI_API_KEY "您的APIKey"
2setx BAIDU_DOC_AI_SECRET_KEY "您的SecretKey"

执行成功后新开一个终端窗口再验证；当前已打开的窗口可能仍读不到新变量。

Linux

在终端执行（bash）：

                Bash
                
                echo 'export BAIDU_DOC_AI_API_KEY="您的APIKey"' >> ~/.bashrc
echo 'export BAIDU_DOC_AI_SECRET_KEY="您的SecretKey"' >> ~/.bashrc
source ~/.bashrc

验证：

                Bash
                
                echo $BAIDU_DOC_AI_API_KEY
echo $BAIDU_DOC_AI_SECRET_KEY

若使用 zsh，将 ~/.bashrc 改为 ~/.zshrc。

设置完成后，请完全退出并重新打开智能体客户端，变量才能生效。

使用额度

文档解析为已实名认证的客户提供了免费测试额度，两套引擎免费额度独立，实名认证后自动下发：

用户类型	文档解析标准版	文档解析（PaddleOCR-VL）
个人实名认证	200 页	200 页
企业实名认证	200 页	1000 页

如果您还没有完成实名认证，可前往实名认证。
如果您想查看文档解析的免费额度，可前往资源列表。
如果您的免费额度耗尽，可以前往购买页（服务名称：智能文档分析-文档解析&文档解析（PaddleOCR-VL））中购买更多资源。

适用场景

合同审查：解析扫描合同，自动识别印章位置与内容，定位甲乙方、金额、日期、违约条款所在页，逐条核查无需手动翻页
标书质检：快速抽取资格要求、废标条款、评分办法、响应表等关键章节，定位盖章页，核查材料完整性
知识库构建：将 PDF / Word / PPT 批量转为结构化 Markdown，保留标题层级和表格，直接对接 RAG 流水线切片入库
论文与报告阅读：准确识别公式、多语种文字、复杂图文混排，支持 100+ 语种自动识别
教育场景：解析教材、课件、试卷、练习册，准确提取题目、公式、图表，支持题库构建与在线批改流水线
发票与财报处理：提取表格数据，支持跨页合并，金额、日期等字段可直接对接下游结构化处理
文档比对：对两份文档分别解析，按章节目录对齐，快速定位新增、删除、修改的段落
出版校对：提取图题、表题、公式编号、脚注，逐一核查编号是否连续、图文是否对应
OCR拍照识别：对证件、票据、白板拍照件，自动矫正角度，识别印章与手写内容

注意事项

环境变量必须在启动智能体客户端之前已经生效，否则调用时会提示鉴权失败，需完全退出后重新打开客户端
API Key 和 Secret Key 请妥善保管，勿提交到公开代码仓库；Key 泄露后请立即在控制台禁用并重新创建
调用失败不计费；额度耗尽后需前往控制台充值或购买资源包才能继续使用

文字识别

文档解析skill使用说明

简介

Skill资源地址

Skill安装方法

方式一：下载文件安装

方式二：通过 GitHub 链接安装

鉴权配置说明

方式一：API Key 鉴权

第一步：获取 API Key

第二步：配置环境变量

方式二：AK/SK 鉴权

第一步：获取 API Key 和 Secret Key

第二步：配置环境变量

使用额度

适用场景

注意事项

相关链接