83 lines
2.7 KiB
Markdown
83 lines
2.7 KiB
Markdown
---
|
||
name: send-file
|
||
description: "发送本地或远程文件到当前微信会话。用户要求发送、转发或分享一个或多个已有文档、压缩包及其他普通文件，且输入是机器人可访问的本地路径或 http/https 文件 URL 时使用；图片应优先使用 send-image。"
|
||
---
|
||
|
||
# 发送文件
|
||
|
||
使用 `scripts/send_file.py` 调用机器人客户端文件接口，将一个或多个本地文件、远程文件 URL 发送到当前微信会话。
|
||
|
||
## 入参
|
||
|
||
```json
|
||
{
|
||
"type": "object",
|
||
"properties": {
|
||
"file_path": {
|
||
"type": "string",
|
||
"description": "要发送的本地文件路径，必须是机器人运行环境可访问的文件。"
|
||
},
|
||
"file_paths": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"description": "要发送的多个本地文件路径。"
|
||
},
|
||
"file_url": {
|
||
"type": "string",
|
||
"description": "要发送的远程文件 URL，必须以 http 或 https 开头。"
|
||
},
|
||
"file_urls": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"description": "要发送的多个远程文件 URL。"
|
||
}
|
||
},
|
||
"anyOf": [
|
||
{ "required": ["file_path"] },
|
||
{ "required": ["file_paths"] },
|
||
{ "required": ["file_url"] },
|
||
{ "required": ["file_urls"] }
|
||
],
|
||
"additionalProperties": false
|
||
}
|
||
```
|
||
|
||
可同时提供本地路径和远程 URL。对应命令行参数：
|
||
|
||
- `--file_path <本地文件路径>`：可重复传入。
|
||
- `--file_paths <JSON数组>`：一次传入多个本地文件路径。
|
||
- `--file_url <远程文件URL>`：可重复传入。
|
||
- `--file_urls <JSON数组>`：一次传入多个远程文件 URL。
|
||
|
||
## 执行
|
||
|
||
在技能目录运行脚本：
|
||
|
||
```bash
|
||
python3 scripts/send_file.py --file_path '/tmp/report.pdf'
|
||
```
|
||
|
||
发送远程文件：
|
||
|
||
```bash
|
||
python3 scripts/send_file.py --file_urls '["https://example.com/a.pdf","https://example.com/b.zip"]'
|
||
```
|
||
|
||
本地文件逐个调用 `POST /api/v1/robot/message/send/file/local`；远程文件合并调用 `POST /api/v1/robot/message/send/file/url`。接收方固定读取 `ROBOT_FROM_WX_ID`，客户端端口读取 `ROBOT_WECHAT_CLIENT_PORT`。
|
||
|
||
## 约束
|
||
|
||
- 至少提供一个非空本地路径或远程 URL。
|
||
- 本地路径必须指向已存在、非空且不超过 25MB 的文件，不能把 URL 作为本地路径传入。
|
||
- 远程 URL 必须包含有效的 `http` 或 `https` 协议及主机名；客户端下载后的文件也不能超过 25MB。
|
||
- 脚本按首次出现顺序去重；所有参数通过校验后，单个发送失败时会继续尝试其余文件，最终返回全部失败原因。
|
||
|
||
## 输出
|
||
|
||
- 全部成功时输出「文件发送成功」，无需再发送额外消息。
|
||
- 任一失败时返回具体错误信息，不要声称文件已全部发送。
|