Yangqihu0328/loong-aegisgate

[英文](README.md) | [中文](README_zh.md) ## 客户端 SDK 与 AegisGate 集成的官方客户端 SDK： | 语言 | 包名 | 功能 | |----------|---------|----------| | [Python](sdk/python/) | `aegisgate` | 同步 + 异步客户端，基于 httpx | | [Node.js](sdk/nodejs/) | `@aegisgate/sdk` | TypeScript，原生 fetch，ESM | | [Go](sdk/go/) | `aegisgate-go` | 零依赖，仅使用 stdlib | 所有 SDK 提供以下功能：聊天完成（流式 + 非流式）、模型列表、健康检查、指标检索和配置重新加载。 ## 持续集成/持续部署 GitHub Actions 在每次推送和 `main` 分支的 PR 上运行： - **5 种构建配置**：发布、调试+ASan、覆盖率、发布-所有功能、发布-PG - **104 个测试套件**，100% 通过率 - Ubuntu 24.04 上的 vcpkg 依赖缓存 ## 测试 107 个测试文件中的 104 个测试套件覆盖所有模块： | 模块 | 测试 | 突出特点 | |--------|-------|------------| | 核心模块（Pipeline、Config、FeatureGate、Crypto、ErrorCodes） | 7 | Pipeline 阶段流程、版本门控、配置验证 | | 网关模块（Connectors、Router、ML/AB Router、Balancer、Fallback、RateLimiter、TokenOpt、AbuseDetector、Proxy） | 19 | Curl 流式传输、断路器、提示压缩、工具使用、滥用检测 | | 守护模块（Injection、PII、Topic、Content、Hallucination、Audit、Rules、Encoding、Unicode、Guard、ExternalSafety、InputPreprocessor） | 17 | 多语言注入、L4 外部安全 API、链式哈希、编码转义 | | 可观察性模块（Logger、Metrics、Cost、Quality、Predictor、Alerting、Compliance、Tracing、TokenEstimator） | 13 | OTEL 集成、预算估计、多通道调度 | | 缓存模块（Embedder、VectorStore、VectorIndex、PartitionedIndex、SemanticCache、Tokenizer） | 7 | VectorStore 抽象、并发安全、自适应阈值、ONNX Embedder | | 认证模块（AuthService、JWT、OIDC、TOTP、SCIM、Session、Encryption、PromptTemplate、Authorization） | 14 | 多因素认证流程、SCIM 2.0、会话生命周期、AES-256-GCM | | 存储 + 集群模块（CacheStore、PersistentStore、SQLite、PG、Redis、RBAC、ConnectionPool、StateStore） | 10 | WAL 模式、fail-open 降级、集群状态 | | 服务器模块（GatewayRuntime、AdminController、SSE、RuntimeLifecycle、ProxySecurity、SSO、MFA、Phase3） | 8 | 租户策略提取、元数据事件、代理安全 | | 集成模块（E2E、Security、Streaming、Chaos、RBAC、TenantIsolation、ExternalSafety） | 7 | 灾难恢复、跨租户隔离、代理端点安全 | | CLI & 插件模块（aegisctl、Migrate、Replay、BenchStats、PluginLoader、RulePackManager） | 5 | 插件加载、规则包管理 | ## 社区 我们非常欢迎您的参与！以下是您如何与我们联系的方式： - **GitHub 讨论区** — 提问、分享想法、展示您所构建的内容：[讨论区](https://github.com/loong-superbank/aegisgate/discussions) - **Discord** — 与贡献者和维护者进行实时聊天：[加入 Discord](https://discord.gg/aegisgate) - **Good First Issues** — 新手友好任务：[Good First Issues](https://github.com/loong-superbank/aegisgate/labels/good%20first%20issue) - **使用过 AegisGate？告诉我们** — 在结构化的 5 分钟表单中分享您的节省故事或痛点：[打开种子用户反馈问题](https://github.com/loong-superbank/aegisgate/issues/new?template=seed_user_feedback.yml)。或者被列入[`ADOPTERS.md`](ADOPTERS.md）。 ## 贡献 我们欢迎各种类型的贡献 — 代码、文档、错误报告、功能想法等等！ - 查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解开发设置、编码标准和拉取请求指南 - 阅读有关入门友好任务的 [Good First Issues Guide](docs/guides/good-first-issues.md) - 在参与之前阅读我们的 [Code of Conduct](CODE_OF_CONDUCT.md) - 通过 [SECURITY.md](SECURITY.md) 私下报告安全漏洞 ## 版本控制 AegisGate 遵循 [语义版本控制](https://semver.org/)。查看 [VERSIONING.md](VERSIONING.md) 了解 API 稳定性保证和弃用策略，以及 [CHANGELOG.md](CHANGELOG.md) 了解每个版本中的详细更改。 ## 许可证 [Apache License 2.0](LICENSE) 版权所有 2026 龙超级银行

标签：AB测试, AES-256-GCM, Apex, API网关, ESM, ETW劫持, GNU通用公共许可证, Go, JWT, MITM代理, Node.js, OIDC, PII保护, Python, Ruby工具, SCIM, SCIM 2.0, SDK开发, TOTP, TypeScript, Unicode, 主题控制, 云计算, 人工智能, 人工智能安全, 代码覆盖率, 令牌优化, 令牌估算, 会话生命周期, 会话管理, 依赖缓存, 内容审核, 分区索引, 分词器, 功能门控, 加密, 加密算法, 合规性, 同步异步, 向量存储, 向量索引, 回退策略, 外部安全API, 多因素认证, 安全插件, 安全网关, 安全防护, 审计, 嵌入器, 性能优化, 成本估算, 指标收集, 授权, 提示模板, 提示词模板, 无后门, 日志审计, 日志记录, 机器学习, 构建配置, 检测绕过, 模块测试, 注入防护, 流水线, 测试套件, 滥用检测, 漏洞扫描器, 用户模式Hook绕过, 编码, 编码转义, 规则引擎, 警报系统, 语义缓存, 负载均衡, 质量监控, 路由器, 身份验证服务, 连接器, 追踪, 逆向工具, 链式哈希, 错误代码, 预测器