SuperAPI AI 工具集

document-processor-api

办公与效率

查看项目

更新于 10-16 12:53

技能介绍

Nutrient DWS 是一套托管式文档处理方案,适用于对保真度、合规性或复杂多步骤处理有要求的场景,其用途覆盖文档生成、格式转换、内容提取、安全处理与合规输出。

用途方面,它可以从 HTML 模板、已上传素材或远程 URL 生成 PDF;在 Office、HTML、图片、PDF 等支持的格式之间转换;对扫描件进行 OCR 并提取文本、表格或键值对;对 PDF 执行脱敏、水印、签名、表单填写、合并、拆分、旋转、扁平化或加密;并生成 PDF/A、PDF/UA、优化 PDF 或线性化 PDF 等交付目标。资料提示,在大规模、批处理或 AI 密集型任务前应先检查配额。

主要能力以脚本形式提供,位于相对于 SKILL.md 的 scripts/ 目录,需以包含该 SKILL.md 的目录为工作目录运行,例如 cd <目录> && uv run scripts/<脚本>.py --help。单操作脚本包括:convert.py(在 pdf、pdfa、pdfua、docx、xlsx、pptx、png、jpeg、webp、html、markdown 间转换)、merge.py(合并多个文件为一个 PDF)、split.py(按页面范围拆分为多个 PDF)、add-pages.py(追加空白页)、delete-pages.py(删除指定页)、duplicate-pages.py(重排或复制页面为新 PDF)、rotate.py(旋转选中页面)、ocr.py(对扫描 PDF 或图片做 OCR)、extract-text.py(提取文本为 JSON)、extract-table.py(提取表格)、extract-key-value-pairs.py(提取键值对)、watermark-text.py(添加文字水印)、redact-ai.py(AI 检测并执行脱敏)、sign.py(对本地 PDF 数字签名)、password-protect.py(输出加密 PDF)、optimize.py(通过 JSON 应用优化与线性化类选项)。

使用方式方面,API 密钥需在 https://dashboard.nutrient.io/sign_up/?product=processor 获取;直接 API 调用使用 Authorization: Bearer $NUTRIENT_API_KEY,环境变量示例为 export NUTRIENT_API_KEY="nutr_sk_..."。MCP 配置常用 @nutrient-sdk/dws-mcp-server 与 NUTRIENT_DWS_API_KEY。页面范围使用 start:end 格式,索引基于 0,结束位置不包含,负数索引从末尾计数。多步骤任务时,不应在 scripts/ 下新增提交的流水线脚本,而应复制 assets/templates/custom-workflow-template.py 到临时位置(如 /tmp/ndp-workflow-<task>.py),在其中实现组合流程并用 uv run 运行,最后返回生成文件,除非用户明确要求保留,否则删除临时脚本。

决策规则与限制包括:已有脚本能干净覆盖的操作优先用脚本;可控制源标记时优先 HTML 生成而非浏览器打印;源文件已位于稳定 URL 时可使用远程 file.url 输入以避免本地上传;转换与最终化目标使用 output.type,变换使用 actions;扫描件需先 OCR 再提取文本、键值或做语义脱敏;目标明确时优先预设或正则脱敏,AI 脱敏仅用于上下文或自然语言请求。PDF 要求方面,split.py 需要多页 PDF,无法从单页提取范围;delete-pages.py 必须至少保留一页;sign.py 仅接受本地文件路径作为主 PDF。反模式提示:不要仅因任务提到提取就对原生数字 PDF 做 OCR;不要在水印/扁平化未确认前扁平化表单或批注;不要对中间工作文件签名、归档或线性化;合同性要求下不要在没有验证步骤时承诺 PDF/A 或 PDF/UA 合规;不要将临时工作流脚本提交到 scripts/ 下。安全加固方面,优先使用固定版本且预安装的 MCP 服务器二进制而非运行时获取(如 npm i -g @nutrient-sdk/dws-mcp-server@<固定版本>),生产中避免未固定版本的运行时获取;绝不要将 NUTRIENT_DWS_API_KEY 存入已提交的 JSON 配置文件,应通过运行时环境注入(shell/export、密钥管理器或宿主环境),并用 SANDBOX_PATH 限制文件访问到最小必要工作目录;生产启用 MCP 模式前应验证包来源并锁定版本。