WPS 云文档

要解决什么问题

团队里常见的 WPS 云文档链接形如 https://365.kdocs.cn/l/{file_id}?lingxi_file_name={file_name}。若把表格或多维表 下载到本地 再用 openpyxl、pandas 改完再上传，往往会丢公式、图表、条件格式和协作状态。本技能把操作约束在 云端 API：先识别文件类型，再走对应子模块。

技能如何工作

收到链接或 file_id 后，先调用 kdocs.get_file_info(file_id)，再按后缀路由：

• 智能文档（.otl）→ AP：导出 Markdown、块级读写
• 表格 / 智能表格（.xlsx、.ksheet）→ ET：数据、公式、格式、图表、透视表等
• 多维表（.dbt）→ DbSheet：Schema、记录与字段、视图
• 其他（如 .docx、.pdf）→ 云文档基础能力；仅在用户明确要求时再 kdocs.download_file

基础层还提供上传/下载、最近文件、list_folder_files 递归列举、create_folder、find_folder_by_path 等。创建或上传后交付给用户时，应使用 API 返回的完整 link_url（含 lingxi_file_name），文件名写在反引号内。

适用边界与注意点

• 默认不上本地下载改表：除非用户明确要求，禁止「下载 → Python 库处理 → 上传」这条路径。
• ET / DbSheet / AP 各有完整子文档，动手前应按技能说明加载对应模块。
• 文件夹操作限定在「我的云文档」；find_folder_by_path 找不到路径时会抛 ValueError，需核对名称或先建目录。
• 下载失败常见原因是 file_id 无效或无权限，需先确认链接与账号权限。