Initial Dever 0.0.1

lib/doc/dever-storage.md

@@ -0,0 +1,19 @@
+# 上传存储
+
+同领域 Adapter 用 storage.put 接收一次性 Upload，不暴露临时文件路径。
+
+## dever.storage.PutResult
+
+上传持久化的结果，成功包含文件的 Uuid。
+
+分支：
+- `Stored(key: Uuid)`：持久化后的文件标识。
+- `error Failed(message: Text)`：文件写入或同步失败。
+
+## dever.storage.put
+
+在 Adapter 中持久化请求上传，成功返回文件 Uuid；失败时传播错误。
+
+## dever.storage.stored
+
+取出已存文件的 Uuid；保存失败时继续传播错误。