wecomteam/wecom-cli/wecomcli-disk

企业微信微盘

执行任何 wecom-cli 命令前，必须先读取并完成 wecomcli-shared 技能的公共前置检查。

资源型 skill，负责微盘文件的列出、搜索、读取信息、上传、下载、重命名与新建文件夹。

适用范围

适用

• 列出微盘最近查看的文件
• 按关键词/类型/创建者/共享空间搜索微盘文件或文件夹
• 读取微盘文件基础信息
• 上传本地文件到微盘指定文件夹
• 下载微盘文件到本地
• 重命名微盘文件
• 在微盘中新建文件夹

不适用

• 移动微盘文件或文件夹 → 告知用户暂未支持，建议前往企业微信客户端手动操作
• 删除微盘文件 / 复制微盘文件 → 告知用户暂未支持，建议前往企业微信客户端手动操作
• 删除 / 重命名微盘文件夹（folder）、调整目录树结构 → 告知用户暂未支持，建议前往企业微信客户端手动操作
• 创建 / 删除共享空间（space）、修改空间成员与空间设置 → 告知用户暂未支持，建议前往企业微信客户端手动操作
• 给机器人授予某空间的权限 / 把机器人加入共享空间成员 → 微盘没有该功能，任何渠道都做不到（客户端也不行）。禁止向用户提出这类建议，也不要引导用户"联系空间管理员给机器人授权"
• 修改文件分享权限、生成分享链接、撤销分享、设置访问密码 / 有效期 → 告知用户暂未支持，建议前往企业微信客户端手动操作
• 微盘文件版本管理（查看历史版本、恢复旧版本、比对版本） → 告知用户暂未支持
• 撤销 / 修改已上传的文件（覆盖上传 / 秒传 / 断点续传） → 告知用户暂未支持；如需替换，请重新走「上传文件」上传一份新文件
• 解析微盘文件的内容（正文提取、OCR、看图问答、PDF/Word/Excel 解析等） → 本 skill 负责把文件下载到本地拿 file_path
• 视频 / 音频文件的转写或字幕生成 → 告知用户暂未支持
• 持续监视微盘变更 / 实时通知新文件到达 → 无法主动监视，不要承诺「有新文件时告知你」，请让用户稍后主动再次发起查询

路由决策（判断本 skill / 其他 skill）

注意：doc.weixin.qq.com / page.weixin.qq.com 是在线文档域名，drive.weixin.qq.com 才是微盘域名，切勿混用。

文件类型枚举

doc（在线文档）、sheet（在线表格）、ppt（在线幻灯片）、collect（收集表）、mind（思维导图）、flow（流程图）、smartsheet（智能表格）、smartpage（智能主页）、journal（汇报）、pdf（PDF）、offline_word（离线 Word）、offline_excel（离线 Excel）、offline_ppt（离线 PPT）、offline_pdf（离线 PDF）、image（图片）、videoaudio（视频音频）、design（设计稿）。在线文档保持原名，离线文件用 offline_ 前缀区分。腾讯文档不在本 skill 范围，按【路由决策】表改走对应文档 skill。

在线/离线模糊时同时搜：用户说「Excel」「Word」「PPT」「PDF」等未明确在线还是离线时，file_types 同时传入在线版和离线版（如 ["sheet", "offline_excel"]），避免遗漏。其余类型按上方枚举名按字面对应传入即可。

接口详述

列出文件

获取用户微盘最近查看的文件列表，支持分页。

命令

wecom-cli disk files list --json '{"limit": 10}'

入参

返回

搜索文件

按关键词、文件类型、创建者、共享空间、排序等条件搜索微盘文件、文件夹或共享空间。

命令

wecom-cli disk files search --json '{"keywords": ["季度汇报"], "search_type": "file", "sort_by": "modify_time", "sort_order": "desc", "limit": 10}'

入参

返回

在线文档命中项处理约束——极重要：搜索返回的 type 若为 smartsheet / smartpage / sheet / word / ppt / journal / collect / mind / flow，这些是在线协作文档（正文存云端，非二进制文件），禁止走 disk files download（会失败或拿到空壳），也不适合走 disk files get。其中 smartsheet / smartpage / sheet / word / ppt 有对应的下游 skill 可读正文，路由见文末【跨技能依赖】表；`journal` / `collect` / `mind` / `flow` 目前没有任何下游 skill 或 CLI 能读取正文，命中这些类型且用户要看内容时，直接告知暂不支持读取，引导用户用 doc_url 在企业微信客户端内打开查看。仅当 type=file 时才可用 id 作为 file_id 调 disk files download 拿本地文件。

使用规则

• 触发条件（唯一权威描述）：keywords / creator_userids / search_type / file_types 四选一，至少传一个；space_keywords 只是附加过滤条件，不能单独触发搜索。若四者全空则用自然语言追问后再发起搜索。若用户仅给出空间关键词（如「在 XX 空间里搜一下」），可用自然语言追问具体搜索内容。
• 多次搜不到就如实告知：多次调整关键词/类型后仍无结果时，停止搜索，如实告知用户是「搜不到文件」还是「搜不到该空间」，不要反复换词硬搜。
• 可选参数传值策略——默认不传，仅在用户明确点名时才传：

• `keywords` 不要混入文件类型后缀：用户说「搜一下 Excel 报告」「找 PPT 方案」时，文件类型后缀（Excel/PPT/Word/PDF）交给 file_types 过滤，keywords 只保留业务关键词（如「报告」「方案」）。例：「Excel 报告」→ keywords:["报告"] + file_types:["sheet","offline_excel"]。
• `file_types` 口语→枚举映射：见上方「文件类型枚举」表中的「用户口语表达」列。
• 分页续传：has_more=true 时用 next_cursor 作为下一次调用的 cursor；首次调用 cursor 传空串。
• 不支持时间范围过滤：本接口没有 begin_time / end_time 字段，禁止伪造；若用户给出"最近 3 天 / 上周 / 本月"等时间范围，先按 sort_by=modify_time, sort_order=desc 拉取，再由客户端根据 update_time 二次筛选。
• 结果总结顺序跟随排序方向：sort_order=desc（默认，新→旧）时，向用户总结结果也应从最新到最旧展示，不要颠倒顺序。

读取文件信息

根据 file_id 或微盘文件 URL 读取文件基础信息。

命令

wecom-cli disk files get --json '{"file_id": "FILE_ID"}'

入参

返回

上传文件

将本地文件上传到微盘指定目录。支持两种上传方式：A. 素材方式 上下文中已有 media_id 时直接传 file_content_media；B. 本地路径方式 直接传 file_path。两者二选一。

命令

wecom-cli disk files upload --json '{"folder_id": "FOLDER_ID", "file_name": "季度汇报.pptx", "file_content_media": "mcxxx"}'

或直接使用本地文件路径：

wecom-cli disk files upload --json '{"folder_id": "FOLDER_ID", "file_name": "季度汇报.pptx", "file_path": "/tmp/季度汇报.pptx"}'

入参

返回

使用规则

上传分两条路径，按用户手上的素材形态选一条即可：

路径 A：素材方式（`file_content_media`）

适用场景：上下文中已有可用的 `media_id`（前置技能返回的、或用户直接给出的），无需再走 media +upload。

1. 确认 folder_id：用户没提供时不传则默认上传到默认空间
2. 直接把已有的 media_id 填入 file_content_media，调 disk files upload

路径 B：本地路径方式（`file_path`）

1. 用户已经明确给出本地文件路径（或前置技能返回了本地 file_path，例如 disk files download 下载后的路径）时可直接使用
2. 确认 folder_id：用户没提供时不传则默认上传到默认空间
3. 直接把本地路径填入 file_path，调 disk files upload（不需要再走 wecomcli-media）