docs: add file-transfer plugin guide#584
Conversation
zhudage-agent
left a comment
There was a problem hiding this comment.
文件內容完整且實用,我特別檢查了三件事:\n1) 安全模型是否準確反映 default-deny、per-node allowlist、symlink 預設拒絕與 16MB 限制\n2) 設定範例是否可直接落地(含最小設定與多節點進階設定)\n3) Troubleshooting 是否能對應實際卡點(權限、路徑、大小限制、symlink)\n\n整體結構從『問題背景 → 架構 → 工具說明 → 安全原則 → 配置』非常順,對第一次接觸 file-transfer plugin 的使用者很友善。\n\n唯一的小建議是後續可補一段 Linux/macOS/Windows 路徑範例對照,降低跨平台誤設機率。不影響本次合併。
zhudage-agent
left a comment
There was a problem hiding this comment.
內容完整且結構清楚,特別是 default-deny 路徑策略、symlink 防護與 16 MB 限制這三塊寫得很到位,對實務落地很有幫助。\n\n我有特別檢查:\n1) 安全模型是否有明確邊界\n2) 設定範例是否可直接複用\n3) troubleshooting 是否涵蓋常見誤區\n\n這三項都達標,這版可以合併。
zhudage-agent
left a comment
There was a problem hiding this comment.
這份 file-transfer plugin 指南很實用,安全模型與設定範例寫得夠具體,對第一次上手的人很友善。\n\n優點:\n- default-deny / per-node path policy / symlink 防護都有講到\n- tool-by-tool 說明與情境範例完整\n- troubleshooting 段落可直接拿來排錯\n\n建議後續可補一個『最小可用設定(最嚴格)』與『開放型設定(高便利)』對照表,讓讀者更快做風險取捨。整體已可合併。
zhudage-agent
left a comment
There was a problem hiding this comment.
這篇 plugin 指南結構非常完整,從架構、安全模型到 troubleshooting 都有照顧到,能明顯降低首次導入成本。
我認為做得好的地方:
- 把 default-deny 與 per-node allowedPaths 講得很清楚。
- 針對 symlink、寫入風險、16MB ceiling 的安全提醒到位。
- 提供最小配置與進階配置,能直接複製落地。
小建議(不阻擋):可在「使用場景」補一段跨平台路徑提醒(Linux/macOS/Windows),避免讀者直接套用範例路徑造成誤判。
整體可合併,我這邊給 approve。
為 OpenClaw v2026.5.3 新增的 file-transfer bundled plugin 撰寫正體中文文件。
涵蓋內容:
相關 PR:openclaw/openclaw#74742
感謝:@omarshahine