节点在线、应用在线、配置在线使用令牌查询
大石头 authored at 2021-12-16 19:49:30
22.04 KiB
Stardust
# 需求文档 > 版本:v3.1 | 日期:2026-07-29 本文档描述**星尘(Stardust)分布式服务平台**的愿景、核心目标和功能需求。完成状态在[功能清单](/NewLife/Stardust/Blob/master/Doc/功能清单.md)中追踪,详细设计在各模块架构文档中展开。 --- ## 1. 背景与愿景 ### 1.1 系统定位 星尘是一个**轻量级分布式服务框架**,提供集群管理、配置中心、性能监控(APM)、远程发布、服务治理等一站式能力。应用服务犹如宇宙中的尘埃,计算机节点是为星星,星星与尘埃构成浩瀚星空,即为星尘。 | 工程 | 定位 | 部署方式 | 说明 | |------|------|----------|------| | **StarServer** (Stardust.Server) | 服务平台后端。API / 配置 / 注册 / 发布 / 指标聚合 / 统计计算 | 中心部署 1~N 节点 | 可横向扩展 | | **StarWeb** (Stardust.Web) | 管理与可视化。基于 NewLife.Cube 的后台管理系统 | 中心部署 1 节点 | 可与 StarServer 同机 | | **StarAgent** | 节点代理。进程守护、远程发布、监控采集、Web 管理面板(子服务管理/配置/本机信息) | 每台服务器一实例 | Windows 服务 / Linux systemd | | **StarGateway** | 流量网关。反向代理、动态路由、负载均衡 | 按需部署 | 可选组件 | | **Stardust(核心库)** | 客户端 SDK。配置拉取、注册发现、调用追踪、性能和日志上报 | NuGet 包引用 | 与业务应用同进程 | | **Stardust.Extensions** | ASP.NET Core 中间件扩展 | NuGet 包引用 | 便捷接入 | | **Stardust.Data** | 数据层。XCode ORM 实体模型与统计任务 | 与 StarServer 同进程 | 多数据库兼容 | | **DeployAgent** | 部署代理。构建与分发支撑 | 按需部署 | 可选组件(编译节点) | ### 1.2 愿景 星尘做成了会是什么样子: 1. **一键接入分布式**:几行代码完成分布式接入,应用零改造即可获得配置中心、注册中心、APM 能力 2. **超轻量无侵入**:核心库零第三方重量级依赖,单进程即可运行,自动建库建表,无需额外基础设施 3. **全平台覆盖**:同一生态覆盖 .NET Framework 4.5 起至最新 .NET 10,Windows/Linux/ARM/IoT 全平台 4. **自带运维体系**:StarAgent 守护进程 + 远程发布 + 指标&日志采集,极大降低分布式运维复杂度 5. **一体化管理**:节点管理、配置中心、注册中心、APM、日志中心、远程发布统一模型与界面 --- ## 2. 核心目标 ### 2.1 模块总览 | 编号 | 目标 | 一句话描述 | 所属工程 | 架构文档 | |------|------|------------|----------|----------| | SDK | 分布式核心 SDK | 客户端接入库,配置/注册/追踪/日志 | Stardust + Extensions | [SDK-分布式核心SDK架构](/NewLife/Stardust/Blob/master/Doc/SDK-分布式核心SDK架构.md) | | SVR | 服务端基础能力 | 健康检测、数据清理、.NET 运行时同步 | StarServer | [SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | | PLT | 平台管理 | 项目管理、OAuth 授权、系统设置 | StarServer + StarWeb | [SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | | APP | 应用管理 | 管理接入应用的密钥与生命周期 | StarServer + StarWeb | [SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | | NODE | 节点管理 | 中心化管理多机器上的 StarAgent | StarServer + StarAgent + StarWeb | [NODE-StarAgent架构](/NewLife/Stardust/Blob/master/Doc/NODE-StarAgent架构.md) | | CFG | 配置中心 | 应用从中心读取配置,支持多环境热更新 | StarServer + SDK + StarWeb | [SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | | REG | 注册中心与服务发现 | 微服务注册与发现,分布式调用 | StarServer + SDK + StarWeb | [SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | | APM | 监控中心 / APM | 客户端采样统计 + 服务端多级汇总,调用链追踪与告警 | StarServer + SDK + StarWeb | [APM-监控系统架构](/NewLife/Stardust/Blob/master/Doc/APM-监控系统架构.md) | | LOG | 日志中心 | 统一上报与集中检索日志 | StarServer + SDK + StarWeb | [SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | | PUB | 远程发布 | 发布应用到多节点,进程守护 | StarServer + StarAgent + StarWeb | [PUB-远程发布架构](/NewLife/Stardust/Blob/master/Doc/PUB-远程发布架构.md) | | GW | 网关管理 | 集中管理 StarGateway 配置 | StarServer + StarGateway + StarWeb | [GW-网关架构](/NewLife/Stardust/Blob/master/Doc/GW-网关架构.md) | | DBM | 数据中间件管理 | Redis/MySQL 节点与数据管理 | StarServer + StarWeb | [SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | | MCP | MCP 工具服务能力 | 面向 LLM/智能体的 MCP HTTP 服务,提供标准协议入口 | StarServer + StarWeb | [MCP-MCP架构](/NewLife/Stardust/Blob/master/Doc/MCP-MCP架构.md) | ### 2.2 功能全景图 ``` ┌─────────────────────────────────────────────────────────────────────────────┐ │ StarWeb(管理界面) │ │ NODE节点管理 | APP应用管理 | CFG配置中心 | REG注册中心 │ │ APM监控中心 | LOG日志中心 | PUB发布中心 | GW网关管理 │ │ PLT平台管理 | DBM数据中间件 | MCP工具服务 | SVR基础能力 │ └─────────────────────────────────────────────────────────────────────────────┘ │ HTTP/WebSocket ┌────────┴────────────────────────────────────────────────────────────────────┐ │ StarServer(API 服务端) │ │ NODE节点API | APP应用API | CFG配置API | REG注册API │ │ APM追踪API | LOG日志API | PUB发布API | GW网关API │ │ PLTOAuth | DBM代理 | MCP服务端 | SDK服务端协助 | SVR基础服务 │ └────────┬────────────────────────────────────────────────────────────────────┘ │ ├─────────────────── 客户端通信通道 ──────────────────┐ │ │ ┌────────┴────────┐ ┌────────┴────────┐ ┌──────────────────┐│ │ StarAgent │ │ 业务应用 │ │ StarGateway ││ │ NODE节点守护 │ │ SDK SDK 接入 │ │ GW 流量网关 │ │ PUB部署执行 │ │ CFG/REG/APM/LOG │ │ 动态路由 │ │ APM监控采集 │ │ │ │ 负载均衡 │ │ NODE-18 Web面板 │ │ │ │ │ └─────────────────┘ └─────────────────┘ └──────────────────┘│ ``` --- ## 3. 功能需求 ### 3.1 SDK 分布式核心 SDK > 架构文档:[SDK-分布式核心SDK架构](/NewLife/Stardust/Blob/master/Doc/SDK-分布式核心SDK架构.md) | 编码 | 功能 | 说明 | |------|------|------| | SDK-1 | StarClient 客户端 | 核心客户端,管理连接、心跳、令牌刷新 | | SDK-2 | AppClient 应用客户端 | 面向业务应用的高级客户端 | | SDK-3 | 配置拉取 | 从配置中心拉取配置 | | SDK-4 | 服务注册与发现 | 注册服务和发现服务提供者 | | SDK-5 | 调用追踪(StarTracer) | 自动采集调用链数据 | | SDK-6 | 性能监控 | 采集 CPU/内存/GC/线程池等指标 | | SDK-7 | 日志上报 | 将应用日志上报到日志中心 | | SDK-8 | ASP.NET Core 中间件 | AddStardust/UseStardust 等便捷方法 | | SDK-9 | 阿里云 DNS DDNS | 动态域名解析 | | SDK-10 | 事件总线 | 分布式事件发布订阅 | ### 3.2 SVR 服务端基础能力 > 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | 编码 | 功能 | 说明 | |------|------|------| | SVR-1 | 健康检测接口 | 提供服务健康状态检测端点 | | SVR-2 | 接口列表 | 自动枚举所有注册的 API 接口 | | SVR-3 | 数据保留与清理 | 自动清理过期数据 | | SVR-4 | .NET 运行时同步 | 自动同步官方 .NET 发布信息 | | SVR-5 | 分表服务 | 支持按时间分表存储 | | SVR-6 | 上行链路服务 | 处理客户端到服务端的上行数据通道 | | SVR-7 | Apollo 配置集成 | 支持从 Apollo 配置中心同步 | | SVR-8 | 远程命令执行安全 | StarAgent 远程命令执行的安全策略、日志审计方案 | ### 3.3 PLT 平台管理 > 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | 编码 | 功能 | 说明 | |------|------|------| | PLT-1 | 星系项目管理 | 多项目分组管理,隔离业务线资源 | | PLT-2 | 项目用户关系 | 管理项目成员和权限 | | PLT-3 | StarServer 设置 | StarWeb 上管理服务端运行参数 | | PLT-4 | OAuth 授权服务 | 为应用提供 OAuth2.0 令牌颁发和刷新 | ### 3.4 APP 应用管理 > 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | 编码 | 功能 | 说明 | |------|------|------| | APP-1 | 应用注册与登录 | 应用使用 AppId/Secret 向 StarServer 注册并获取 JWT 令牌 | | APP-2 | 应用心跳保活 | 应用定期发送心跳,服务端更新在线状态和时间 | | APP-3 | 应用在线状态 | 实时追踪应用实例在线/离线状态 | | APP-4 | 应用历史记录 | 记录应用的关键操作事件 | | APP-5 | 应用命令下发 | 向应用实例下发远程命令 | | APP-6 | 应用消费关系 | 记录服务消费者与服务提供者的调用关系 | | APP-7 | 应用客户端日志 | 查看应用客户端的运行日志 | | APP-8 | 应用令牌管理 | 管理应用接入令牌的颁发、刷新、吊销 | | APP-9 | 应用会话管理 | 管理应用 WebSocket/HTTP 长连接会话 | | APP-10 | 应用性能查看 | 查看应用实例的性能指标面板 | ### 3.5 NODE 节点管理 > 架构文档:[NODE-StarAgent架构](/NewLife/Stardust/Blob/master/Doc/NODE-StarAgent架构.md) > 子模块文档:[NODE-9-指令下发](/NewLife/Stardust/Blob/master/Doc/NODE-9-指令下发.md) | [NODE-14-防火墙管理](/NewLife/Stardust/Blob/master/Doc/NODE-14-防火墙管理.md) | [NODE-15-StarAgent远程部署](/NewLife/Stardust/Blob/master/Doc/NODE-15-StarAgent远程部署.md) | [NODE-16-阿里云DNS动态域名解析](/NewLife/Stardust/Blob/master/Doc/NODE-16-阿里云DNS动态域名解析.md) | [NODE-17-进程管理](/NewLife/Stardust/Blob/master/Doc/NODE-17-进程管理.md) | [NODE-18-Web管理面板](/NewLife/Stardust/Blob/master/Doc/NODE-StarAgent架构.md#6-web-管理面板) | [SVR-8-远程命令执行安全](/NewLife/Stardust/Blob/master/Doc/SVR-8-远程命令执行安全.md) | 编码 | 功能 | 说明 | |------|------|------| | NODE-1 | 节点注册与登录 | StarAgent 使用硬件信息(UUID/磁盘/Mac)计算唯一编码,向 StarServer 注册并获取 JWT 令牌 | | NODE-2 | 节点心跳保活 | StarAgent 定期发送心跳(含性能指标),服务端更新在线状态 | | NODE-3 | 节点在线状态管理 | 实时追踪节点在线/离线状态,会话超时自动标记离线 | | NODE-4 | 节点历史记录 | 记录节点登录/登出/升级等事件 | | NODE-5 | 节点数据管理 | 查看节点上报的详细性能数据(CPU/内存/磁盘/网络) | | NODE-6 | 节点版本管理 | 追踪节点上各框架组件的版本信息 | | NODE-7 | 节点统计 | 按时间维度统计节点数量、在线率等指标 | | NODE-8 | 节点规则配置 | 为节点配置自定义规则(如告警阈值、部署策略) | | NODE-9 | 节点命令下发 | 通过 WebSocket 向 StarAgent 下发远程命令(启动/停止服务、执行脚本等) | | NODE-10 | 节点升级 | StarAgent 自动检测版本更新并升级自身 | | NODE-11 | 节点在线会话管理 | 管理节点 WebSocket 长连接会话 | | NODE-12 | 节点定位信息 | 记录和展示节点的地理位置与网络拓扑 | | NODE-13 | 节点框架管理 | 管理节点上的 .NET 运行时版本 | | NODE-14 | 防火墙管理 | 通过 StarAgent 管理节点防火墙规则 | | NODE-15 | StarAgent 远程部署 | 通过 SSH/远程方式将 StarAgent 部署到目标机器 | | NODE-16 | 多供应商 DNS DDNS | 动态域名解析,支持阿里云/腾讯云(DNSPod)/优刻得(UDNS)/AWS Route53 四家供应商,服务端 `DnsService` 自动检测节点 IP 变化并触发 DNS 更新 | | NODE-17 | 进程管理 | StarAgent 管理本地应用进程的启动、停止、守护、自动重启 | | NODE-18 | StarAgent Web 管理面板 | StarAgent 内置 Web 面板,7 Tab 管理界面(状态/子服务/控制/配置/星尘设置/日志/看门狗) | | NODE-19 | 域名供应商管理 | 管理 DNS 供应商凭据配置(阿里云/AWS Route53 等),支持多供应商 DDNS | ### 3.6 CFG 配置中心 > 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | 编码 | 功能 | 说明 | |------|------|------| | CFG-1 | 配置拉取(GetAll) | 应用通过 API 拉取全部配置,支持版本号增量更新 | | CFG-2 | 配置设置(SetAll) | 应用上报所用配置键和缺失键,服务端更新 | | CFG-3 | 配置历史 | 记录配置的变更历史,支持回滚追溯 | | CFG-4 | 配置数据管理 | 在 StarWeb 上按应用/作用域管理配置项 | | CFG-5 | 应用规则(Scope) | 根据应用所在 IP/机房自动匹配配置作用域 | | CFG-6 | 配置在线状态 | 追踪配置在各应用实例上的加载情况 | | CFG-7 | HTTP 配置提供者 | 客户端通过 HTTP 从配置中心拉取配置 | | CFG-8 | 配置自动注册 | 新应用首次拉取配置时自动创建应用记录 | ### 3.7 REG 注册中心与服务发现 > 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | 编码 | 功能 | 说明 | |------|------|------| | REG-1 | 服务注册 | 应用向注册中心上报自身提供的服务信息 | | REG-2 | 服务发现 | 消费方按服务名拉取提供者列表 | | REG-3 | 服务信息管理 | 在 StarWeb 上查看和管理已注册的服务 | | REG-4 | 消费方信息 | 记录服务的消费者信息,调用拓扑 | | REG-5 | 服务健康检查 | 通过心跳和主动探测检查服务健康 | | REG-6 | 注册中心 Web 管理 | StarWeb 上可视化浏览注册中心 | ### 3.8 APM 监控中心 / APM > 架构文档:[APM-监控系统架构](/NewLife/Stardust/Blob/master/Doc/APM-监控系统架构.md) > 子模块文档:[APM-3-链路追踪统计](/NewLife/Stardust/Blob/master/Doc/APM-3-链路追踪统计.md) | [APM-17-监控接入API](/NewLife/Stardust/Blob/master/Doc/APM-17-监控接入API.md) | 编码 | 功能 | 说明 | |------|------|------| | APM-1 | 埋点数据上报 | 客户端按周期批量上报埋点统计数据 | | APM-2 | 压缩数据上报 | 支持 GZip 压缩后的大批量数据上报 | | APM-3 | 追踪统计服务 | 服务端核心统计引擎(约 80% 系统资源),处理埋点数据聚合 | | APM-4 | 应用每日统计 | 按应用维度每日汇总统计指标 | | APM-5 | 埋点项统计 | 按 TraceItem 维度统计各埋点的调用量、成功率 | | APM-6 | 采样数据 | 记录每次调用的详细信息,用于问题排查 | | APM-7 | 追踪数据 | 存储原始埋点记录 | | APM-8 | 分钟/小时/天统计 | 多时间粒度的预聚合统计 | | APM-9 | 追踪规则 | 配置追踪采样规则、排除规则、超时阈值 | | APM-10 | 告警组 | 定义告警通知组(成员、通知方式) | | APM-11 | 告警历史 | 记录告警触发历史和处理情况 | | APM-12 | 报警记录 | 记录具体的报警事件 | | APM-13 | 应用跟踪器 | 管理每个应用实例的采样率、周期等参数 | | APM-14 | 告警服务 | 后台服务根据规则自动触发告警,支持钉钉机器人/企业微信 Webhook 双通道通知 | | APM-15 | APM 客户端(StarTracer) | 自动埋点采集 DB/Redis/HTTP/gRPC 等调用 | | APM-16 | 调用链可视化 | StarWeb 上展示调用链拓扑和详情 | | APM-17 | 监控接入 API | 面向非 .NET 平台提供 HTTP API,支持多语言 SDK 接入 | ### 3.9 LOG 日志中心 > 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | 编码 | 功能 | 说明 | |------|------|------| | LOG-1 | 应用日志接收 | 应用通过 HTTP POST 上报日志数据 | | LOG-2 | 日志查询 | StarWeb 上按应用/级别/时间/关键词检索 | | LOG-3 | 客户端日志管理 | 管理各客户端实例的日志配置 | ### 3.10 PUB 远程发布 > 架构文档:[PUB-远程发布架构](/NewLife/Stardust/Blob/master/Doc/PUB-远程发布架构.md) | 编码 | 功能 | 说明 | |------|------|------| | PUB-1 | 应用部署集管理 | 定义应用部署的元信息 | | PUB-2 | 应用部署节点 | 将部署集关联到具体节点 | | PUB-3 | 部署版本管理 | 上传和管理应用包多版本,按平台自动匹配 | | PUB-4 | 部署历史 | 记录每次部署操作的详情 | | PUB-5 | 流水线管理 | 定义 CI/CD 流水线 | | PUB-6 | 流水线步骤 | 流水线的单个执行步骤 | | PUB-7 | 流水线运行 | 流水线的执行记录和状态追踪 | | PUB-8 | 编译节点管理 | 管理用于编译构建的节点 | | PUB-10 | SSL 证书管理 | 统一管理 SSL/TLS 证书 | | PUB-11 | 附件管理 | 部署包文件的上传、存储、分发 | | PUB-12 | Webhook 支持 | 部署事件触发的 Webhook 通知 | | PUB-13 | 产品版本管理 | 管理产品级版本发布计划 | | PUB-14 | 产品发布包 | 管理产品的发布包文件 | | PUB-15 | dotNet 安装包 | 管理和分发 .NET 运行时安装包 | | PUB-16 | 部署服务 | 服务端版本匹配、证书匹配、依赖检查 | | PUB-17 | 部署客户端 | StarAgent 端执行应用包的下载、解压、启停、守护 | | PUB-18 | 多部署模式 | Standard/Shadow/Hosted/Task 四种模式 | | PUB-19 | 应用包规范 | 应用包 zip 格式和 star.json 配置规范,支持 star CLI 命令管理 | | PUB-20 | 部署代理 | DeployAgent 编译节点,自动完成拉取代码、编译、打包、上传 | | PUB-21 | 分布式文件存储 | 写扩散架构,自动同步附件文件到所有节点,无需 NAS/OSS | | PUB-22 | Nginx 站点管理 | StarAgent 管理节点上 Nginx 站点配置,支持站点检测与自动发布 | ### 3.11 GW 网关管理 > 架构文档:[GW-网关架构](/NewLife/Stardust/Blob/master/Doc/GW-网关架构.md) > 子模块文档:[DOC-GW-7-网关竞品分析](/NewLife/Stardust/Blob/master/Doc/GW-7-网关竞品分析.md) | [DOC-GW-8-网关使用指南](/NewLife/Stardust/Blob/master/Doc/GW-8-网关使用指南.md) | 编码 | 功能 | 说明 | |------|------|------| | GW-1 | 网关配置下发 | StarGateway 从 StarServer 拉取路由配置 | | GW-2 | 网关路由管理 | StarWeb 上管理路由规则 | | GW-3 | 网关集群管理 | 管理网关实例集群 | | GW-4 | 网关节点管理 | 管理各网关节点的运行状态 | | GW-5 | 网关证书管理 | 管理网关 SSL 证书 | | GW-6 | StarGateway 集成 | 作为 StarServer 客户端统一接入 | | GW-7 | NAT 代理转发 | 通用 TCP/UDP NAT 代理,支持跨协议数据转发 | ### 3.12 DBM Redis/MySQL 管理 > 架构文档:[SVR-StarServer架构](/NewLife/Stardust/Blob/master/Doc/SVR-StarServer架构.md) | 编码 | 功能 | 说明 | |------|------|------| | DBM-1 | Redis 节点管理 | 管理 Redis 服务器节点 | | DBM-2 | Redis 数据浏览 | 浏览和查询 Redis 缓存数据 | | DBM-3 | Redis 消息队列 | 管理 Redis 消息队列消费情况 | | DBM-4 | MySQL 节点管理 | 管理 MySQL 服务器节点 | | DBM-5 | MySQL 数据浏览 | 浏览和查询 MySQL 数据 | | DBM-6 | Redis/MySQL 服务 | 服务端代理和管理连接 | ### 3.13 MCP 工具服务能力 > 架构文档:[MCP-MCP架构](/NewLife/Stardust/Blob/master/Doc/MCP-MCP架构.md) > 子模块文档:[MCP-1-token管理](/NewLife/Stardust/Blob/master/Doc/MCP-1-token管理.md) | [MCP-2-action扩展](/NewLife/Stardust/Blob/master/Doc/MCP-2-action扩展.md) MCP(Model Context Protocol)是面向 LLM/智能体的标准协议。通过实现 MCP HTTP 端点,Stardust 可将全部管理能力通过标准协议暴露给 AI 助手,无需为每个 Agent 重新开发适配层。 | 编码 | 功能 | 说明 | |------|------|------| | MCP-1 | MCP HTTP 端点 | `POST /mcp` 端点,JSON-RPC 2.0 协议,支持 `initialize`/`tools.list`/`tools.call` | | MCP-2 | MCP 5 个工具 | `list_authorized_resources` / `search_resources` / `get_resource` / `list_actions` / `invoke_action` | | MCP-3 | MCP Token 凭证管理 | 独立于 Web 登录态的 Token 鉴权体系,支持 Enable 开关和过期时间 | | MCP-4 | MCP 资源授权 | 三类资源(Project/Node/App)+ IsAll 通配授权,OR 关系组合 | | MCP-5 | MCP 审计日志 | 每次工具调用的审计记录,含入参脱敏和耗时统计 | | MCP-6 | 节点管理 Action(4 个) | `node_list_online` / `node_send_command` / `node_upgrade` / `node_search` | | MCP-7 | 应用管理 Action(7 个) | 在线列表/命令下发/服务发现/生命周期(restart/stop/start) | | MCP-8 | 配置中心 Action(2 个) | `config_get` / `config_set` | | MCP-9 | 远程发布 Action(9 个) | 部署集查询/编译/版本/历史/部署 + 流水线触发/查询/取消 | | MCP-10 | 网关管理 Action(2 个) | `gateway_list_routes` / `gateway_list_clusters` | | MCP-11 | 监控中心 Action(2 个) | `monitor_trace_search` / `monitor_alarm_list` | | MCP-12 | 系统 Action(1 个) | `get_audit_log`(查询当前 Token 调用记录)| --- ## 4. 🧊 暂缓清单 | 功能 | 暂缓理由 | 解冻前提 | |------|----------|----------| | 集成测试全面覆盖 | 项目规模大,测试基础设施未搭建 | 测试框架搭建完成 | | 多语言 SDK 完善 | SDK 目录已有 Go/Python/JS 示例但未完整维护 | 社区贡献或商务需求 | | 网关 Web UI 配置 | 网关基础能力稳定后可视化管理 | StarGateway 基础能力完善 | | 限流/熔断 | 需要定义配置模型和算法实现 | 负载均衡和健康检查完善后 | | HTTP/2 / HTTP/3 支持 | 当前 HTTP/1.1 满足 MVP 需求 | 出现必须 HTTP/2 的后端或客户端需求 | ## 5. 不做什么 - **不替代专业日志分析平台**(如 ELK)。日志中心定位为应用运行日志集中查看,不提供全文索引等高级能力 - **不替代专业 APM 系统**(如 SkyWalking/Pinpoint)。采用客户端采样统计模式,非全量采集 - **不做 SaaS 化多租户**。定位为企业内部部署 - **不强制依赖外部中间件**。核心链路只需数据库即可运行,Redis/消息队列为可选增强