wls_vfs/README.md

# wls_vfs

Windows/Linux 文件共享服务端（gRPC + Protobuf）。

本仓库已升级至协议 v2（统一错误模型）：

- 所有 RPC 使用显式的 `Request`/`Response` 类型；
- 响应统一携带 `RpcStatus { ok, error }`；
- 删除历史 `ret` 字段；失败信息通过 `FsError` 完整承载（`code`/`sys_msg`/`operation`/`paths`/`context` 等）。

协议详情见：`proto/lws.proto` 与 `docs/protocol_v2.md`。

注意：本项目主要在 Windows 上构建运行（依赖 `winapi`）。在非 Windows 平台构建仅用于类型检查，可能失败。
-												Initial commit

											
										
										
											2024-07-02 18:39:35 +08:00
+								# wls_vfs
-												feat(proto/server)!: 升级至协议 v2（统一错误模型）；全面替换 Request/Response 并移除 ret

- Breaking change: 协议不向后兼容，旧客户端需同步升级
- Proto: 新增 FsOp/ErrorCause/FsError/RpcStatus；为所有 FS 接口定义 <Op>Request/<Op>Response；删除历史 ret 字段
- Server: 所有 RPC 返回统一的 RpcStatus；成功 ok=true，失败填充 FsError（operation/paths/sys_msg 等）
  - Open/Read/Write 对齐新字段（fi/data/written）；Readdir/Opendir/Releasedir 等返回类型调整
  - Rename 传回 from/to；OpendirRequest 不再输入 fi，服务端生成并回传
- Docs: 新增 docs/protocol_v2.md；README 标注 v2 破坏性升级与用法
- Build: 主要面向 Windows（winapi）。Linux 环境类型检查可能失败

后续：完善 errno 抽取与 context 填充；可选引入流式 read/write 以优化大文件传输。

											
										
										
											2025-09-23 21:25:06 +08:00
+								Windows/Linux 文件共享服务端（gRPC + Protobuf）。
 								本仓库已升级至协议 v2（统一错误模型）：
 								- 所有 RPC 使用显式的 `Request`/`Response` 类型；
 								- 响应统一携带 `RpcStatus { ok, error }`；
 								- 删除历史 `ret` 字段；失败信息通过 `FsError` 完整承载（`code`/`sys_msg`/`operation`/`paths`/`context` 等）。
 								协议详情见：`proto/lws.proto` 与 `docs/protocol_v2.md`。
 								注意：本项目主要在 Windows 上构建运行（依赖 `winapi`）。在非 Windows 平台构建仅用于类型检查，可能失败。