技能介绍

要解决什么问题

本地有一堆 PDF / DOC / DOCX，你想在 ChatDOC Studio 里建成可检索的知识库，而不是手工逐个上传、等解析、再单独调用「创建库」接口。更麻烦的是：混在目录里的不支持格式、单文件解析失败，往往会让整批任务直接中断。

本技能把「上传 → 等解析成功 → 用成功的 upload_id 建库」收成一条 JavaScript 工作流，通过 PDRouter（https://platform.paodingai.com）访问 ChatDOC Studio 的 OpenAPI，而不是直连 ChatDOC 内部接口。

技能如何工作

建库：对 --file 与递归扫描的 --dir 去重后，只处理 .pdf、.doc、.docx；并发上传（固定为 5），再调用建库接口，成功时输出 JSON（含 library_id）。
查库：拿到 library_id 后，可走同一脚本做文档列表、检索、统计、grep、大纲（syllabus）与分块（block）阅读。
执行约定：正常使用时必须直接运行 scripts/knowledge-mate.mjs；请求统一走 /openapi/chatdoc-studio/...，鉴权为 Authorization: Bearer + 环境变量 PAODINGAI_API_KEY（在 PDRouter 平台申请）。

适用边界与注意点

仅适用于 PDRouter 封装的 ChatDOC Studio 技能 API；不要在本技能里自行复刻上传/建库 HTTP 流程，也不要添加内部 X-PD-* 签名头。
新建知识库请用 upload-and-create 一体化流程，不要拆成仅上传或仅建库的旁路命令。
单次批处理若支持的文件 超过 300 个，脚本会在上传前直接失败；若全部上传或解析失败，则跳过建库并以非零状态退出。
不支持的类型、单文件上传/解析失败会记为跳过或失败，不会因此终止整批；只有脚本本身不可用或需要修脚本时，才适合改实现细节。