juhecli-cdn 企微 CDN
juhecli-cdn - 企业微信云存储文件管理，CDN 认证与文件获取
使用案例
下载客户发的文件获取文件的认证信息
获取CDN认证
cdn get_info - 获取CDN认证信息
>帮我获取一下CDN认证信息
// Agent 调用 cdn get_info 获取认证凭据
$juhe-cli cdn get_info
{
"data": {
"auth_key": "xxxx_a1b2c3d4",
"cdn_url": "https://cdn.example.com",
"expire_time": 1710494400
}
}
概述
企微 CDN SKILL（juhecli-cdn）用于获取企业微信云存储的文件。 通过全局 GUID 认证机制访问 CDN 资源，获取的认证信息约 3 小时有效，可复用。 适用于下载聊天中的图片、文档、视频等文件。
认证有效期
CDN 认证信息获取一次后约 3 小时内可复用，无需每次操作都重新获取。 过期后重新调用
cdn get_info 即可。触发方式
当用户用自然语言表达以下意图时，Agent 应激活此 SKILL：
- “获取CDN认证” / “获取CDN认证信息”
- “下载CDN文件” / “获取云存储文件”
- “下载聊天里的图片” / “获取消息中的文件”
命令一览
| SKILL 名称 | 说明 |
|---|---|
juhecli-cdn | 企微CDN文件管理 - 获取私有化云存储文件、CDN认证信息 |
Agent 交互示例
cdn get_info - 获取 CDN 认证信息
text
用户：帮我获取一下CDN认证信息
Agent：好的，我来获取CDN认证。
→ Agent 调用 cdn get_info
Agent：CDN认证信息获取成功，有效期约3小时。期间下载文件无需重复获取认证。参数：无额外参数，使用全局 GUID 认证。
返回值：CDN 认证凭据信息。
cdn get_file - 获取云存储文件
text
用户：下载聊天里那个合同文件
Agent：好的，我先搜索包含文件的消息，然后获取文件。
→ Agent 调用 db msg search 搜索包含文件的消息
→ Agent 调用 cdn get_info 获取认证（如果认证已过期或未获取）
→ Agent 调用 cdn get_file 下载文件
Agent：文件下载成功。参数：无额外参数，使用全局 GUID 认证。
返回值：文件内容或下载地址。
完整工作流：搜索消息并下载文件
text
用户：帮我找到上周发的合同图片并下载下来
Agent：好的，我来搜索消息并下载。
→ Agent 调用 db msg search 搜索包含“合同”的消息
→ Agent 向用户确认目标文件
→ Agent 调用 cdn get_info 获取认证
→ Agent 调用 cdn get_file 下载文件
Agent：合同图片已下载成功。参数来源速查
| 参数 | 来源标记 | 说明 |
|---|---|---|
| 全局 GUID | [需查询] | 通过 device list 获取，所有命令共用 |
典型工作流
工作流 1：获取 CDN 认证并下载文件
用户需要下载云存储文件时，Agent 分步操作：
- 获取认证：调用 cdn get_info 获取 CDN 认证凭据（可复用约 3 小时）
- 下载文件：调用 cdn get_file 获取文件内容或下载地址
工作流 2：从消息中提取文件并下载
用户说“下载聊天里那个文件”。Agent 分步操作：
- 搜索消息：通过 db msg search 找到包含文件的消息，获取 file_id 等信息
- 获取认证：调用 cdn get_info（如果认证尚未获取或已过期）
- 下载文件：调用 cdn get_file 下载目标文件
AI Agent 注意事项
- 两个命令均无需额外参数，使用全局 GUID 认证
- CDN 认证信息约 3 小时有效，短时间内可缓存复用
- 大文件下载建议使用异步方式，避免阻塞
- 文件操作通常与
db msg search配合使用，从消息中获取文件标识 - 注意 CDN 流量配额，避免超出限制