- 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 以优化大文件传输。
14 lines
581 B
Markdown
14 lines
581 B
Markdown
# 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 平台构建仅用于类型检查,可能失败。
|