Croupier C++ SDK 完整分析报告

sdks/cpp/
├── .github/                          # GitHub Actions 工作流
│   └── workflows/
│       ├── cpp-sdk-build.yml        # 完整的多平台构建与发布流程
│       ├── optimized-build.yml      # 优化的构建流程（预生成文件）
│       └── ci.yml                   # 基础 CI 配置
├── .vscode/                         # VS Code 扩展推荐
├── build/                           # CMake 构建输出目录
├── cmake/                           # CMake 模块
│   └── ProtoGeneration.cmake        # Proto 文件生成和下载模块
├── configs/                         # 配置示例文件
├── examples/                        # SDK 使用示例
│   ├── example.cpp                  # 基础示例
│   ├── complete_example.cpp         # 完整示例（含 gRPC）
│   ├── virtual_object_demo.cpp      # 虚拟对象演示
│   ├── config_example.cpp           # 配置驱动示例
│   ├── plugin_demo.cpp              # 插件系统演示
│   ├── comprehensive_demo.cpp       # 综合演示（所有接口）
│   └── plugins/
│       └── example_plugin.cpp       # 示例插件（共享库）
├── generated/                       # 预生成的 Proto 代码
│   ├── croupier/
│   │   ├── agent/local/v1/         # LocalService gRPC
│   │   ├── function/v1/            # Function Service
│   │   ├── server/v1/              # Server Service
│   │   ├── edge/job/v1/            # Job Service
│   │   └── options/                # Protobuf options
│   └── examples/                   # 示例 Proto 定义
├── include/                        # 公共头文件
│   └── croupier/sdk/
│       ├── croupier_client.h       # SDK 核心客户端
│       ├── grpc_service.h          # gRPC 服务接口
│       ├── config_driven_loader.h  # 配置加载器
│       ├── config/
│       │   └── client_config_loader.h
│       ├── plugin/
│       │   └── dynamic_loader.h    # 动态插件加载
│       └── utils/
│           ├── json_utils.h
│           └── file_utils.h
├── scripts/                        # 构建和辅助脚本
│   ├── build.sh                    # 通用跨平台构建脚本
│   └── build-optimized.sh          # CI 优化构建脚本
├── src/                            # SDK 实现源文件
│   ├── croupier_client.cpp
│   ├── grpc_service.cpp
│   ├── config_driven_loader.cpp
│   ├── config_manager.cpp
│   ├── config/
│   ├── plugin/
│   │   └── dynamic_loader.cpp
│   └── utils/
│       ├── json_utils.cpp
│       └── file_utils.cpp
├── tests/                          # 单元测试
│   ├── test_virtual_objects.cpp
│   ├── test_utils.cpp
│   └── test_integration.cpp
├── CMakeLists.txt                  # 主 CMake 构建配置
├── CMakeLists.txt.optimized        # 优化版本（使用预生成文件）
├── CMakeLists.txt.simplified       # 简化版本（最小依赖）
├── vcpkg.json                      # vcpkg 依赖清单
├── README.md                       # 完整文档
├── COMPLETE_SDK_README.md          # 详细文档
├── CONFIG_GUIDE.md                 # 配置指南
├── PLUGIN_GUIDE.md                 # 插件开发指南
└── VIRTUAL_OBJECT_REGISTRATION.md  # 虚拟对象注册详解

标准 triplet (Debug + Release)：12-15 分钟
Release-only triplet：5-7 分钟
系统包：30 秒

1. 检查当前 commit 是否有 git tag (v*.*.*)
   → 正式发布版本
   
2. 手动触发 (workflow_dispatch)
   → nightly / release / patch
   
3. 定时运行 (schedule)
   → 每日 nightly 构建
   
4. 其他 push/PR
   → dev 预发布版本

├── croupier-cpp-sdk-static-1.0.0-windows-x64.zip
├── croupier-cpp-sdk-dynamic-1.0.0-windows-x64.zip
├── croupier-cpp-sdk-static-1.0.0-linux-x64.tar.gz
├── croupier-cpp-sdk-dynamic-1.0.0-linux-x64.tar.gz
├── croupier-cpp-sdk-static-1.0.0-macos-x64.tar.gz
├── croupier-cpp-sdk-dynamic-1.0.0-macos-x64.tar.gz
└── ... (arm64 variants)

Client                          Agent (LocalService)
  │                               │
  ├─→ Connect [mTLS]             │
  │   ← Channel Ready             │
  │                               │
  ├─→ RegisterFunction()          │
  │   ← Ack                       │
  │                               │
  ├⇄ Streaming (requests/responses)
  │   ← Events (progress, logs, done)
  │                               │
  └─→ Disconnect                  │

1. 多配置 triplet (release-only)
2. 容器化预构建
3. GitHub Actions 缓存
4. 系统包管理替代

平台        构建时间    缓存命中率   CI 成本
──────────────────────────────────────
Linux       ~12 分钟    低 (20%)     $$
macOS       ~15 分钟    低 (20%)     $$$
Windows     ~18 分钟    低 (10%)     $$$
──────────────────────────────────────
总计        ~45 分钟    avg 17%      $$$

平台        构建时间    缓存命中率   CI 成本
──────────────────────────────────────
Linux       ~2 分钟     高 (85%)     $
macOS       ~3 分钟     高 (85%)     $
Windows     ~8 分钟     高 (80%)     $$
──────────────────────────────────────
总计        ~13 分钟    avg 83%      $

Language:      C++17
Build System:  CMake 3.20+
Package Mgmt:  vcpkg
gRPC:          1.x (通过 vcpkg)
Serialization: Protocol Buffers 3.x
JSON:          nlohmann/json
Testing:       GoogleTest (可选)
CI/CD:         GitHub Actions
Platforms:     Windows, Linux, macOS
Architectures: x64, x86, ARM64