feat: https://github.com/vastsa/FileCodeBox/issues/386 https://github.com/vastsa/FileCodeBox/issues/380

docs/guide/upload.md

@@ -118,12 +118,53 @@ Content-Type: `multipart/form-data`
 **cURL 示例：**
 
 ```bash
+# 上传文件（默认1天有效期）
+curl -X POST "http://localhost:12345/share/file/" \
+  -F "file=@/path/to/file.pdf"
+
+# 上传文件并指定有效期（7天）
 curl -X POST "http://localhost:12345/share/file/" \
   -F "file=@/path/to/file.pdf" \
   -F "expire_value=7" \
   -F "expire_style=day"
+
+# 上传文件并指定有效期（可下载10次）
+curl -X POST "http://localhost:12345/share/file/" \
+  -F "file=@/path/to/file.pdf" \
+  -F "expire_value=10" \
+  -F "expire_style=count"
+
+# 分享文本
+curl -X POST "http://localhost:12345/share/text/" \
+  -F "text=这是要分享的文本内容"
+
+# 通过取件码下载文件
+curl -L "http://localhost:12345/share/select/?code=取件码" -o downloaded_file
 ```
 
+::: tip 需要认证时
+如果管理面板关闭了游客上传（`openUpload=0`），需要先登录获取 token：
+
+```bash
+# 1. 登录获取 token
+curl -X POST "http://localhost:12345/admin/login" \
+  -H "Content-Type: application/json" \
+  -d '{"password": "FileCodeBox2023"}'
+
+# 返回: {"code":200,"msg":"success","detail":{"token":"xxx.xxx.xxx","token_type":"Bearer"}}
+
+# 2. 使用 token 上传文件
+curl -X POST "http://localhost:12345/share/file/" \
+  -H "Authorization: Bearer xxx.xxx.xxx" \
+  -F "file=@/path/to/file.pdf"
+
+# 3. 使用 token 分享文本
+curl -X POST "http://localhost:12345/share/text/" \
+  -H "Authorization: Bearer xxx.xxx.xxx" \
+  -F "text=这是要分享的文本内容"
+```
+:::
+
 ## 分片上传 API
 
 对于大文件，FileCodeBox 支持分片上传功能。分片上传将大文件分割成多个小块分别上传，支持断点续传。