技能名称: alicloud-ai-text-document-mind
详细描述:
类别: 提供者

文档智能 (DocMind) — Node.js SDK

使用DocMind通过异步任务提取文档结构、文本和布局。

前提条件

• - 安装SDK：

• - 通过标准阿里云环境变量提供凭证：

快速入门（提交 + 轮询）

js
const Client = require(@alicloud/docmind-api20220711);
const Credential = require(@alicloud/credentials);
const Util = require(@alicloud/tea-util);

const cred = new Credential.default();
const regionId = process.env.ALICLOUDREGIONID || cn-hangzhou; // 示例默认值；如果未设置，请选择或询问。
const client = new Client.default({
endpoint: docmind-api.${regionId}.aliyuncs.com,
accessKeyId: cred.credential.accessKeyId,
accessKeySecret: cred.credential.accessKeySecret,
type: access_key,
regionId,
});

async function submitByUrl(fileUrl, fileName) {
const req = new Client.SubmitDocStructureJobRequest();
req.fileUrl = fileUrl;
req.fileName = fileName;
const resp = await client.submitDocStructureJob(req);
return resp.body.data.id;
}

async function pollResult(jobId) {
const req = new Client.GetDocStructureResultRequest();
req.id = jobId;
const resp = await client.getDocStructureResult(req);
return resp.body;
}

(async () => {
const jobId = await submitByUrl(https://example.com/example.pdf, example.pdf);
console.log(jobId:, jobId);

// 每10秒轮询一次，直到完成。
for (;;) {
const result = await pollResult(jobId);
if (result.completed) {
console.log(result.status, result.data || result.message);
break;
}
await new Promise((r) => setTimeout(r, 10000));
}
})();

脚本快速入门

bash
DOCMINDFILEURL=https://example.com/example.pdf \\
node skills/ai/text/alicloud-ai-text-document-mind/scripts/quickstart.js

环境变量：

• - DOCMINDFILEURL
• DOCMINDFILENAME（可选）
• DOCMINDPOLLINTERVALMS（可选，默认值10000）
• DOCMINDMAX_POLLS（可选，默认值120）

本地文件上传

js
const fs = require(fs);
const advanceReq = new Client.SubmitDocStructureJobAdvanceRequest();
advanceReq.fileUrlObject = fs.createReadStream(./example.pdf);
advanceReq.fileName = example.pdf;
const runtime = new Util.RuntimeOptions({});
const resp = await client.submitDocStructureJobAdvance(advanceReq, runtime);

给Claude Code/Codex的说明

• - DocMind是异步的：提交任务，然后轮询直到completed=true。
• 大约每10秒轮询一次；最大处理窗口为120分钟。
• 使用URL提交时，请确保文件可公开访问。

错误处理

• - UrlNotLegal：URL不可公开访问或格式错误。
• DocProcessing：任务仍在运行；继续轮询。
• Fail：检查message和错误代码以查找根本原因。

验证

bash
mkdir -p output/alicloud-ai-text-document-mind
for f in skills/ai/text/alicloud-ai-text-document-mind/scripts/*.py; do
python3 -m py_compile $f
done
echo pycompileok > output/alicloud-ai-text-document-mind/validate.txt

通过标准：命令退出码为0，且生成了output/alicloud-ai-text-document-mind/validate.txt。

输出与证据

• - 将工件、命令输出和API响应摘要保存在output/alicloud-ai-text-document-mind/目录下。
• 在证据文件中包含关键参数（区域/资源ID/时间范围），以确保可复现性。

工作流程

1) 确认用户意图、区域、标识符以及操作是只读还是修改性操作。
2) 首先运行一个最小的只读查询，以验证连接性和权限。
3) 使用显式参数和限定范围执行目标操作。
4) 验证结果并保存输出/证据文件。

参考资料

• - DocMind Node.js SDK：@alicloud/docmind-api20220711

• - 来源列表：references/sources.md