1.7 KiB
1.7 KiB
导入本地文件：+import Golden Route
唯一推荐入口
dws doc +import --file ./report.docx --format json
dws doc +import --file ./report.docx --folder <FOLDER_ID> --format json
dws doc +import --file ./notes.md --workspace <WORKSPACE_ID> --name "会议纪要" --format json
+import 一次完成创建会话、上传、确认转换和轮询。支持 doc/docx/xls/xlsx/md/txt/xmind/mark，文件大小上限 20MB。
本地文件边界
--file只接受当前工作目录内已存在的相对路径；禁止绝对路径、..或符号链接逃逸。--folder与--workspace都是可选位置；都不传时导入默认根目录，两者都有时优先--folder。- CLI 负责上传和格式转换。不要先用 Python/Office 库解析文件，不要安装本地依赖来伪造在线导入结果，也不要手写 HTTP 上传。
- 白名单外格式（如 HTML/PDF）自动改走原文件上传，返回
fallback=upload、converted=false；不得报告成已经转换为可编辑在线文档。
失败处理
- 发起前的格式、大小或路径校验失败：修正输入后再执行。
- 已返回
taskId后超时或中断：保留该taskId，读取精确恢复命令 Schema 后只查询原任务；禁止重新提交导入。 - 返回状态未知时原样报告，不把本地文件内容改走
+create，因为这会改变格式保真和任务语义。 - 白名单外格式如果目标是钉盘而非文档空间，切换到
dingtalk-drive上传。
正常导入不得手工编排原子 doc import 子步骤。只有 shortcut 未公开必要的恢复参数时，才按精确 leaf Schema 使用原子查询命令。