协议定义位于 src/proto/proto/，编解码实现位于 src/proto/codec/。源码文件、消息、字段与枚举标识符采用 snake_case。原 AFMsg package 改为 ark.protobuf，C++ 命名空间为 ark::protobuf；consul、osslog 保留既有 package。
构建与包含
启用 ARK_BUILD_PROTO=ON 并使用 ark::proto，取得生成头文件路径、ARK_HAS_PROTOBUF 及 Protobuf 运行库依赖。构建应用时必须启用此选项。
add_subdirectory(path/to/ark ark-build)
add_executable(my_service main.cpp)
target_link_libraries(my_service PRIVATE ark::core ark::proto)生成的 C++ 文件保留在 CMake 构建目录的 src/proto/generated/ark/proto/ 下。修改源码 .proto 后，由 CMake 重新生成，不直接编辑生成头文件。可包含 <ark/proto/common_messages.pb.h> 等单类消息头文件，或使用汇总头文件 <ark/proto.hpp>。.pb.h 后缀由 Protobuf 生成器决定，不应手动重命名。
Protobuf、Abseil 与 utf8_range 应来自同一套兼容安装。手工选择软件包时，同步检查 Protobuf_DIR、absl_DIR 与 utf8_range_DIR；链接成功本身不能证明反射和 JSON 行为正确。
命名迁移约定
| 保持不变 | 调用方需要调整 |
|---|---|
| 字段号、类型与重复性 | C++ 类型名和字段访问方法 |
| 枚举数值与二进制消息编码 | descriptor 全名与 Any 类型 URL |
| 显式保留的外部 JSON 字段名 | 已改名的 JSON 枚举字符串及依赖文本类型名的代码 |
当前名称包括 ark::protobuf::protobuf_data、protobuf_node_data、protobuf_entity_data。相关辅助接口使用完整的 protobuf，不再使用 pb 缩写前缀，例如 Bus 模块的 msg_module::decode_protobuf。依赖的 C++ 代码需要与生成消息一同重新构建。
外部 JSON 拼写
Consul 的 C++ 字段使用小写，json_name 显式保留其外部键。例如 consul::service_data::meta() 对应 JSON 的 Meta；ID、Name、Address、Port、Tags、Check 也保留要求的拼写。不要为匹配 C++ 标识符而修改这些外部键。
协议约定与代表性二进制、JSON 回归见 consul.proto 和 protobuf_messages.cpp。文本 descriptor 变化与二进制兼容是不同问题，本次迁移不保证全面的源码兼容或 JSON 枚举字符串兼容。