1. 功能说明
将飞书云空间中的文档迁移至指定知识库空间并挂载到指定位置，支持异步处理：若迁移已完成（或文档已在知识库中），直接返回知识库文档 Token；若未完成，返回任务 ID，需配合【查询移动云空间文档至知识库结果】获取最终状态。底层基于飞书 API（https://open.feishu.cn/document/server-docs/docs/wiki-v2/task/move_docs_to_wiki）实现。
2. 配置项说明
| 配置项 | 必填 | 默认值 | 说明 |
|---|---|---|---|
| 飞书访问凭证 | 是 | - | 选择已配置的飞书访问凭证（tenant_access_token/user_access_token），需具备文档管理、知识库编辑权限。 |
| 知识库 ID | 是 | - | 目标知识库的唯一标识（对应飞书 API 的space_id）。 |
| 知识库父节点 Token | 是 | - | 文档在知识库中挂载的父节点唯一标识（对应飞书 API 的parent_wiki_token）。 |
| 云文档类型 | 是 | - | 待迁移文档的类型，可选值： doc：旧版文档 sheet：表格 bitable：多维表格 mindnote：思维导图 docx：新版文档 file：文件 slides：幻灯片 |
| 文档 Token | 是 | - | 飞书云空间中待迁移文档的唯一标识（对应飞书 API 的obj_token）。 |
| 任务 ID | 是 | - | 存储迁移任务的唯一标识（若迁移未完成），用于后续查询任务结果。 |
| 知识库文档 Token | 是 | - | 存储迁移完成后的知识库文档唯一标识（若迁移已完成）。 |
| 返回结果 | 是 | - | 存储完整的 API 响应结果（字典类型），包含状态、错误信息等。 |
返回结果逻辑
- 若迁移已完成（或文档已在知识库）：
知识库文档Token存储结果标识，任务ID为空。 - 若迁移未完成：
任务ID存储任务标识，需调用【查询移动云空间文档至知识库结果】获取状态。
3. 示例场景
将云空间中docx类型的文档（Token：doccaKQ1k3p******8Vabcef）迁移至知识库（ID：1565676577122621）的父节点（Token：wikcnKQ1k3p******8Vabcef）：
- 飞书访问凭证：选择已配置的凭证；
- 知识库 ID：填写
1565676577122621； - 知识库父节点 Token：填写
wikcnKQ1k3p******8Vabcef； - 云文档类型：填写
docx； - 文档 Token：填写
doccaKQ1k3p******8Vabcef； - 任务ID：填写变量：任务ID
- 知识库文档Token：填写变量：知识库文档Token
- 返回结果：填写变量：返回结果
- 执行后，若迁移完成，
变量“知识库文档Token”存储知识库文档 Token；若未完成，变量“任务ID”存储任务 ID，可根据任务 ID，配合【查询移动云空间文档至知识库结果】获取最终状态。
4. 注意事项
常见问题
| 错误类型 | API 错误码 | 可能原因 | 解决方案 |
|---|---|---|---|
| 参数错误 | 131002 | 文档类型填写错误（如传 “excel” 而非 “sheet”）、文档 Token 格式无效、知识库空间 ID 不存在 | 核对文档类型是否为允许值，检查 文档Token 和 知识库ID 的准确性 |
| 超出限制 | 131003 | 知识库节点总数 / 层级 / 单层节点数超过上限，或单次迁移节点数超 2000 个 | 清理知识库冗余节点，拆分迁移任务（单次迁移节点数≤2000），确保目录树层级≤50 层 |
| 数据不存在 | 131005 | 待迁移文档已删除（document not found）、知识库空间不存在（space not found）、父节点不存在（node not found） | 确认源文档、知识库空间、父节点的有效性，重新获取正确的 Token/ID |
| 权限不足 | 131006 | 无文档管理权限、无原文件夹 / 目标父节点编辑权限、应用未开通 Wiki 操作权限 | 1. 为应用添加 “移动 Wiki 空间节点” 或 “查看、编辑和管理 Wiki” 权限；2. 将应用添加为知识库空间管理员（参考飞书权限配置文档）；3. 确保当前凭证对应的用户具备文档管理权限 |
| 服务器内部错误 | 131007 | 飞书 API 服务临时异常 | 提供logid，联系飞书技术支持排查，稍后重试 |