file-share · diff
git:20260313.22f8357 to git:20260313.837fc11
29 added, 47 removed. Audit A to A.
---
name: file-share
- description: 上传文件到临时分享服务，返回下载链接。当你需要把生成的文件发送给用户，但`message`无法使用时，使用该 skill 生成分享链接。
+ description: Upload files to temporary sharing services and get download links. Use this skill only when the `message` tool cannot send files directly.
---
# file-share
- 将本地文件上传到临时文件分享服务，获取公开下载链接。
-
- ## 使用方法
-
- ### tmpfiles.org（推荐，1小时有效）
+ Upload local files to temporary file sharing services to get public download links.
- ```bash
- curl -s -F "file=@<文件路径>" https://tmpfiles.org/api/v1/upload
- ```
+ ## Important
- 示例：
- ```bash
- curl -s -F "file=@./data/report.pdf" https://tmpfiles.org/api/v1/upload
- # 返回: {"status":"success","data":{"url":"http://tmpfiles.org/12345/report.pdf"}}
- # 注意：需要把 url 中的 tmpfiles.org 改成 tmpfiles.org/dl 才能直接下载
- # 即: http://tmpfiles.org/dl/12345/report.pdf
- ```
+ Always prefer using the channel's native file sending capability via the `message` tool first - this provides the best user experience. Only use this as a fallback when native file sending is unavailable or fails.
- ### catbox.moe（永久有效）
+ ## Available Services
- ```bash
- curl -s -F "reqtype=fileupload" -F "fileToUpload=@<文件路径>" https://catbox.moe/user/api.php
- ```
+ ### tmpfiles.org (Recommended, 1 hour expiry, 100MB)
- 示例：
```bash
- curl -s -F "reqtype=fileupload" -F "fileToUpload=@./data/chart.png" https://catbox.moe/user/api.php
- # 返回: https://files.catbox.moe/abc123.png
+ curl -s -F "file=@<file_path>" https://tmpfiles.org/api/v1/upload
+ # Returns: {"status":"success","data":{"url":"http://tmpfiles.org/12345/file.pdf"}}
+ # Note: Add /dl to URL for direct download: http://tmpfiles.org/dl/12345/file.pdf
```
- ### litterbox（24小时临时）
-
- ```bash
- curl -s -F "reqtype=fileupload" -F "time=24h" -F "fileToUpload=@<文件路径>" https://litterbox.catbox.moe/resources/internals/api.php
- ```
+ ### uguu.se (48 hours expiry, 128MB)
- 示例：
```bash
- curl -s -F "reqtype=fileupload" -F "time=24h" -F "fileToUpload=@./data/data.xlsx" https://litterbox.catbox.moe/resources/internals/api.php
- # 返回: https://litter.catbox.moe/abc123.xlsx
+ curl -s -F "files[]=@<file_path>" https://uguu.se/upload.php
+ # Returns: {"success":true,"files":[{"url":"https://d.uguu.se/xxxxx.pdf",...}]}
```
- ## 使用流程
+ ## Workflow
- 1. 生成/处理文件，保存到 `data/` 目录
- 2. 使用上述任一命令上传
- 3. 将返回的链接发送给用户
- 4. 用户点击链接即可下载
+ 1. Generate/process file and save to `data/` directory
+ 2. Upload using one of the commands above
+ 3. Extract the download URL from response
+ 4. Send the download link to the user
- ## 服务对比
+ ## Notes
- | 服务 | 有效期 | 大小限制 |
- |------|--------|----------|
- | tmpfiles.org | 1小时 | 100MB |
- | catbox.moe | 永久 | 200MB |
- | litterbox | 24小时 | 1GB |
+ - Do not upload sensitive information (public links)
+ - Verify the file exists before uploading
+ - For tmpfiles.org, add `/dl` to URL for direct download
- ## 注意事项
+ ## Unavailable Services (Do NOT use)
- - 不要上传敏感信息（这些是公开链接）
- - 尽量不要使用永久有效的方案
- - 上传前确认文件存在且路径正确
- - tmpfiles.org 返回的链接需要加 `/dl` 才能直接下载
+ The following services are blocked or unreliable:
+ - transfer.sh - timeout
+ - x0.at - timeout
+ - litterbox.catbox.moe - timeout
+ - catbox.moe - timeout
+ - 0x0.st - blocks automated uploads
+ - file.io - unreliable