Skip to Content
核心概念统一 SDK 框架

统一 SDK 框架

Argus 的核心架构理念是「多能力统一接入框架」。不同能力(日志 / 崩溃 / 性能 / 埋点 / 反馈) 不是各自独立的 SDK,而是共享同一套底层管线

共享层内容
认证HMAC-SHA256 签名(跨 Go / TS / Swift / Kotlin / Dart 逐字节一致)
传输批量上报、重试、退避
降级本地持久化队列(离线积压、重启恢复重发)
配置远程配置 / Feature Flag 下发链路

新增一个能力,只需写它各自的 Collector + Schema,不重复造网络 / 存储 / 认证。

落到上报上

所有端上数据走同一个 Ingestion Gateway,差异只在字段:

  • channel / event_type 区分能力(log / crash / apm / track / trace)。
  • 服务端用同一份 ClickHouse 存储(按事件类型分区),同一套查询接口。

这就是为什么各端 SDK 的 API 形态高度一致:initlog / track / metric / captureCrashflush,且都用同一个 DSN。

统一计费 / 统一 AI

  • 统一计费维度:MAU + 事件量 + 存储量 + AI 调用量,所有能力贡献到同一份用量数据。
  • 统一 MCP 工具集:MCP Server(对外)与 Platform Copilot(内嵌)共享同一套约 30 个工具, 双轨复用。

详见 docs/06-architecture/07-sdk-framework.md