用途:通过阿里云 Document Mind(DocMind)的 Node.js SDK,以异步作业方式提交文档解析任务并轮询结果,从而提取文档的结构、文本与版式信息。
安装依赖:npm install @alicloud/docmind-api20220711 @alicloud/tea-util @alicloud/credentials
凭证配置:使用标准阿里云环境变量 ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET,以及可选的 ALIBABACLOUD_REGION_ID(未设置时需选择最合适的区域或询问用户)。
使用方式:DocMind 为异步模式,先调用 submitDocStructureJob 提交作业(可按 URL 或本地文件流提交),再调用 getDocStructureResult 轮询直至 completed=true。建议每约 10 秒轮询一次,最长处理窗口为 120 分钟。使用 URL 提交时需保证文件可被公网访问。
脚本快速开始:设置 DOCMIND_FILE_URL 等环境变量后运行 node skills/ai/text/aliyun-docmind-extract/scripts/quickstart.js;可选变量包括 DOCMIND_FILE_NAME、DOCMIND_POLL_INTERVAL_MS(默认 10000)、DOCMIND_MAX_POLLS(默认 120)。
错误处理:UrlNotLegal 表示 URL 不可公网访问或格式错误;DocProcessing 表示作业仍在运行需继续轮询;Fail 需检查 message 与错误码定位原因。
校验:对 scripts 下 *.py 执行 py_compile,命令退出码为 0 且生成 output/aliyun-docmind-extract/validate.txt 视为通过。产出与证据保存于 output/aliyun-docmind-extract/,并记录区域、资源 id、时间范围等关键参数以便复现。限制:轮询最长约 120 分钟;具体收费、价格与其他平台支持情况暂未提供。