diff --git a/docs/zh/droppable.md b/docs/zh/droppable.md
index 88ee9c1..2160188 100644
--- a/docs/zh/droppable.md
+++ b/docs/zh/droppable.md
@@ -11,6 +11,8 @@
 |-------|------|------|
 | `group` | string | 分组名称，只接收同 group 的拖拽源。默认 `"default"`。 |
 | `accepts` | string[] | 接受的类型列表。对内部元素匹配 `data-type` 属性；对外部文件匹配 MIME 类型或扩展名。如 `["card", "image/*", ".pdf"]`。 |
+| `max_size` | number | （可选）单个文件最大字节数，超出则忽略。 |
+| `multiple` | boolean | （可选）是否允许多文件拖入，默认 `true`。 |
 | `animation` | number | 拖拽动画时间（毫秒）。 |
 
 ## 外部文件拖入
@@ -28,20 +30,38 @@
 | `dropremove` | 有内部元素被拖出（不会发生，因 Droppable 不可拖出） |
 | `filedrop` | 有外部文件拖入。`event.params.files` 为文件数组，每项含 `{name, size, type, file}` |
 
-## 示例 — 接收文件
+## 示例 — 文件拖入并上传
 
 ```json
 {
   "widgettype": "Droppable",
-  "options": {"group": "upload", "accepts": ["image/*", ".pdf"]},
+  "options": {"accepts": ["image/*", ".pdf", ".docx"], "max_size": 10485760},
   "subwidgets": [
-    {"widgettype": "Text", "options": {"text": "拖入图片或PDF文件"}}
+    {"widgettype": "Text", "options": {"text": "拖入文件到这里上传", "css": "drop-zone-text"}}
   ],
-  "binds": [{"event": "filedrop", "actiontype": "script",
-    "script": "var fs=event.params.files;alert('收到 '+fs.length+' 个文件');"}]
+  "binds": [{"wid": "self", "event": "filedrop", "actiontype": "script",
+    "script": "(function(){\n  var fs = event.params.files;\n  if (!fs.length) return;\n  var dz = this;\n  fs.forEach(function(f) {\n    var fd = new FormData();\n    fd.append('file', f.file, f.name);\n    fetch('{{entire_url('/api/upload.dspy')}}', {method:'POST', body:fd})\n      .then(function(r) { return r.json(); })\n      .then(function(d) {\n        if (d.status) {\n          var c = dz.querySelector('.drop-zone-text');\n          if (c) c.textContent = f.name + ' 上传成功 ✓';\n        }\n      })\n      .catch(function(e) {\n        var c = dz.querySelector('.drop-zone-text');\n        if (c) c.textContent = f.name + ' 上传失败: ' + e.message;\n      });\n  });\n}).call(this);"}]
 }
 ```
 
+**上传脚本关键部分拆解：**
+
+```javascript
+// 1. 从 event.params 获取文件
+var files = event.params.files;  // [{name, size, type, file}]
+
+// 2. 构建 FormData
+var fd = new FormData();
+fd.append('file', files[0].file, files[0].name);  // file 是原生 File 对象
+
+// 3. 发送到后端
+fetch('/api/upload.dspy', {method: 'POST', body: fd})
+  .then(r => r.json())
+  .then(d => { /* d.status 为 true 表示成功 */ });
+```
+
+> **注意：** `event.params.files[].file` 是浏览器原生 `File` 对象，可直接用于 `FormData.append()` 或 `FileReader.readAsDataURL()`。
+
 ## 示例 — 接收内部元素
 
 ```json