nutrient-document-processing

nutrient-document-processing 技能概览

nutrient-document-processing 能做什么

nutrient-document-processing 技能可帮助你调用 Nutrient DWS Processor API，对文档进行转换、OCR、提取、脱敏、签名、加水印和填表。它最适合需要实用型 nutrient-document-processing 来完成 PDF Processing 工作流的用户，而不是只想要一个泛泛的“编辑文档”提示词。

谁应该使用它

如果你的任务属于文档自动化，就适合用这个技能：把 DOCX/XLSX/PPTX/HTML 转成 PDF，提取文本或表格，对扫描件做 OCR，或者生成符合合规要求的输出，比如已脱敏或已签名文件。它最适合结果必须可复现、并且由 API 驱动，而不是人工编辑的场景。

安装前需要先确认什么

这个技能的核心采用门槛在于：它集成的是商业 API，因此你需要有效的 API key，并接受把文档发送到外部服务。只有当你已经明确输入文件类型、期望输出格式，以及任务是否需要 OCR、脱敏或签名时，这个技能的效果才最强。

如何使用 nutrient-document-processing 技能

安装并完成认证

先把 nutrient-document-processing 技能安装到你的 skills workspace，然后在运行任何请求前设置 API key：

export NUTRIENT_API_KEY="pdf_live_..."

在执行 nutrient-document-processing install 这一步之前，请确认你的环境能够安全保存密钥，并且允许向 https://api.nutrient.io/build 发起外部请求。

从输入出发，不要从功能出发

一条高质量的 nutrient-document-processing usage 提示词，会在一句话里同时写清源文件、目标输出和转换类型。例如：“将 invoice.docx 转为 PDF，保留版式，并返回单个文件”，或者“对这个扫描版 PDF 做 OCR，并把表格数据提取成结构化文本”。这种具体度能减少猜测，也能避免得到含糊、分多步的输出。

先读这些文件

先查看 skills/nutrient-document-processing 里的 SKILL.md，再阅读任何会影响你环境行为的关联仓库上下文。由于这个 repo 没有额外的 rules/、resources/ 或辅助脚本，最重要的是理解 API 合约、支持的输入类型，以及 skill 正文中展示的精确 multipart 请求格式。

真正好用的工作流

先用一个小测试文档验证结果类型，再扩展到批量或敏感文件。把操作和真实任务对应起来：格式变更用 convert，扫描 PDF 用 OCR，文本/表格捕获用 extract，PII 删除用 redact，信任流程用 sign，表单填写用 fill。如果你的第一版提示词不够明确，就把“完成标准”直接写出来，比如“保留原始版式”“返回可搜索文本”或“删除第 3 页上的所有 SSN 和姓名”。

nutrient-document-processing 技能常见问题

nutrient-document-processing 只适用于 PDF 吗？

不是。nutrient-document-processing skill 支持 PDF，以及 DOCX、XLSX、PPTX、HTML 和图片等常见办公文档/图像输入，不过在很多工作流里，PDF 是主要的下游格式。

我必须已经是 API 用户吗？

不一定，但你需要能接受提供 API key 并处理文件上传。如果你想要的是完全本地、没有外部服务的提示词方案，这个技能大概率不适合你。

这和直接让模型“转换文档”有什么不同？

普通提示词也能描述任务，但这个技能提供的是一个有具体 API 支撑的工作流，上传格式、endpoint 和输出行为都更明确。当输出保真度、可重复性和文件处理方式比一次性的文字建议更重要时，这一点就很关键。

它适合新手吗？

如果你已经知道源文件和目标格式，那它是适合新手的。对于需求不明确的文档任务，它就没那么友好，因为最佳结果取决于选对操作，并给出清晰的输出要求。

如何改进 nutrient-document-processing 技能

把 API 用在最合适的任务上

最大的改进空间在于：选择与你目标最匹配、粒度最窄的操作。比如，只有在源文件是扫描件时才做 OCR；只有在需要删除特定数据时才做 redact；只有在输出格式需要变化时才做 convert。这样能让 nutrient-document-processing guide 更贴合真实工作。

事先说明文档约束

在第一次请求里就写明页码范围、语言、敏感级别和版式预期。好的输入可以像这样：“对这份 12 页的英文扫描 PDF 做 OCR，并保留标题层级”，或者“把附件 PDF 里的所有邮箱地址和电话号码脱敏，然后返回干净的 PDF”。像“帮我修一下这个文档”这类弱输入会迫使系统做过多猜测。

先检查首个输出里的失败模式

常见问题包括版式漂移、低质量扫描件 OCR 不完整，以及脱敏或提取范围过宽。如果第一次结果不理想，应该通过补充文件类型、目标格式和保留规则来收紧提示词，而不是把同样的请求再说一遍。

用小样本测试来提升结果

在处理敏感或高吞吐任务之前，先用一个有代表性的小样本文件测试 nutrient-document-processing 技能。等工作流确认正确后，再沿用同样的提示词结构处理完整批次，这样输出质量更稳定，也更容易验证。