# Unified AI System：自托管 AI 网关与 MCP Server

面向自然语言增强、受治理执行与可复现验证的开源 AI 网关。

English | 简体中文 | 项目主页

GitHub Stars CI Container Release 成熟度：加固后的 Public Preview Official MCP Registry Apache-2.0 License

Unified AI System 会在执行前，把一句自然语言需求整理成结构化、可审阅的提示词。它为 OpenAI 兼容 SDK、MCP、A2A、CLI 和 HTTP 提供统一的自托管入口，同时让 provider 调用保持显式。 > **当前成熟度：加固后的 Public Preview。** 零凭证路径可复现并受 CI > 门禁；生产部署仍需要使用方完成真实 Provider staging、HA/DR 演练、 > 独立安全评审和持续运行证据。

Unified AI System 把一句自然语言需求整理成结构化 coding 提示词
原始需求保持可见；本地增强器会补充执行要求、输出要求和完成标准。

凡本 README 里对 MCP 服务端生态的判断，都是实测而非断言：[对公开 MCP 生态的九项测量](https://happy520ai.github.io/unified-ai-system/mcp-ecosystem-measurements.html)（向注册表登记的 40 个服务端匿名提问，每一页都写明自己的分母），同样的结果也提供机器可读数据（[九个问题、十次测量、400 行，2026-09-28](https://happy520ai.github.io/unified-ai-system/data/mcp-ecosystem-measurements.2026-09-28.json)）。 ## 60 秒体验

终端证明：一条 docker run 命令打印增强提示词与 providerCalled=false 证据，结束自动清理

无需登录，直接验证发布镜像： ```bash docker run --rm ghcr.io/happy520ai/unified-ai-system/ai-gateway-service:0.8.0 pnpm gateway demo ``` 在 Apple Silicon 上，请把 `--platform linux/amd64` 写在镜像名之前。已发布的两个 `arm64` 标签（网关与 MCP server）带的都是 x86-64 原生模块，所以这条演示命令目前在该架构上会失败 （见 [#190](https://github.com/happy520ai/unified-ai-system/issues/190)，含读数与复现命令）。 没有 Docker，或者正在用上面明说会失败的 Apple Silicon？同一个证明可以从源码跑：依赖装好之后，演示本身只需要几秒而不是几分钟——目前唯一留档的一次实测是在单台笔记本上耗时 14.0 秒墙钟时间（见[免凭据证据页，英文](docs/credential-free-evidence.html)），那一页也明说了它是一次运行、不是基准测试： ```bash git clone https://github.com/happy520ai/unified-ai-system.git cd unified-ai-system corepack enable && pnpm install --frozen-lockfile # 前置条件：Node 22.18.0+ 与 pnpm 11.19.0 pnpm gateway demo "帮我为团队设计一个小型 API" --enhance --profile coding --evidence ``` 本机实测（Windows、Node v25.8.1、未安装 Docker engine）：exit 0，`"mode": "fake"`，`"providerCalled": false`， `"credentialRequired": false`，输出 4,363 字节，`"language": "zh-CN"`。前面那行安装命令才是超过六十秒的部分； 下文的 `pnpm verify:public-clone` 是更长的可选检查，不是这条演示的前置条件。 你将看到： - 本地 fake provider 执行 - 明确的 `execution: fake` - 可重复的输出 - 不需要 API Key 或账号 - 容器自动退出并清理 用一条命令体验自然语言增强： ```bash docker run --rm ghcr.io/happy520ai/unified-ai-system/ai-gateway-service:0.8.0 \ pnpm gateway demo "帮我为团队设计一个小型 API" --enhance --profile coding --evidence ``` 网关会在本地增强请求、输出结构化提示词，然后自动清理隔离进程，全程不调用真实 provider。 不安装镜像也能核对发布件的工具清单（在克隆出来的仓库里执行）： ```bash node tools/verify-image-roster.mjs 0.8.0 ``` 它通过普通 HTTPS 读取容器层里的 `MCP_TOOL_NAMES`，并逐个用 manifest 声明的摘要校验每个 blob——不需要 Docker 守护进程，也不需要 registry 登录。预期会看到一行 `tools 15`； 同一条命令跑 `0.4.0` 会报 9 个。也就是说，这个数字跟着制品走，而不是跟着描述走。 八个 tag 的完整测量记录（包括 `latest` 与 `0.8.0` 为何接口相同、字节不同）见 [镜像工具清单说明](https://happy520ai.github.io/unified-ai-system/verify-mcp-docker-image.html)。 如果需要指定输出语言，可以使用 `--language zh-CN` 或 `--language en`；省略时默认自动检测。 ## 无需安装，直接体验

Unified AI System：自托管 AI 网关——发布镜像含 15 个受治理 MCP 工具、四项发布门、23 项攻击回归均被防御、首次体验零凭证

[**在浏览器 Prompt Lab 中打开一个可直接运行的 coding 示例**](https://happy520ai.github.io/unified-ai-system/#enhance?prompt=%E5%B8%AE%E6%88%91%E4%B8%BA%E5%9B%A2%E9%98%9F%E8%AE%BE%E8%AE%A1%E4%B8%80%E4%B8%AA%E5%B0%8F%E5%9E%8B+API&profile=coding&language=zh-CN) 链接会自动载入真实请求，并在浏览器本地生成增强结果，不需要账号、 API Key，也不会调用 provider。 也可以用已发布容器运行同一条验证： ```bash docker run --rm ghcr.io/happy520ai/unified-ai-system/ai-gateway-service:0.8.0 pnpm gateway demo "帮我为团队设计一个小型 API" --enhance --profile coding --evidence ``` 证据会确认原始请求被保留、结果具有确定性，并显示 `providerCalled=false`。Codex、VS Code、Claude Code、Gemini CLI、OpenCode、 Cursor、Cline、Continue 和通用 stdio 客户端都可以通过同一个网关 访问受治理 MCP 工具。当前源码提供 15 个工具；已安装镜像的工具清单应在连接后检查。 在真实工作流中有帮助？欢迎[给仓库点 Star](https://github.com/happy520ai/unified-ai-system)，或[分享一条可复现结果](https://github.com/happy520ai/unified-ai-system/issues/new?template=usage-verification-report.yml&title=%5BUsage%20Report%5D%20Quickstart)。 ## 一图看懂网关

架构总览：OpenAI/Anthropic SDK、MCP 客户端、A2A、CLI 与 HTTP 汇入统一网关——提示词增强、虚拟 key、精确缓存 + 可选语义层、反向 MCP 治理、可观测性、审计——provider 位于三重白名单之后，fake provider 为零凭证默认
客户端保持原生协议；网关统一加上 key、预算、缓存与审计。受治理工具清单可由 MCP 客户端检查。

## 选择入口 | 你的目标 | 从这里开始 | 你会得到什么 | | --- | --- | --- | | 安装前先体验 | [在线 Prompt Lab](https://happy520ai.github.io/unified-ai-system/#enhance) | 无需账号或 API Key 的本地确定性预览。 | | 看看谁已经接受它 | [本项目被收录在哪里（英文版）](https://happy520ai.github.io/unified-ai-system/listing-census.html) | 当前收录我们的精选目录与公开 MCP 目录，每一行都附可核对的 URL，每日重新探测。 | | 验证已发布运行时 | [60 秒 Docker 体验](README.zh-CN.md#60-秒体验) | 可见证据、自动清理的 fake provider 一次性运行。 | | 接入智能体客户端 | [Codex 与 MCP 快速开始](https://happy520ai.github.io/unified-ai-system/codex-mcp-docker-quickstart.zh-CN.html) | 固定版本 MCP 容器，连接后检查其工具清单。 | | 选择客户端路径 | [MCP 客户端兼容性矩阵](docs/mcp-client-compatibility.zh-CN.md) | 安装命令、首次检查和明确的证据边界。 | | 集成到应用 | [自然语言提示词增强指南](https://happy520ai.github.io/unified-ai-system/prompt-enhancement.zh-CN.html) | CLI、HTTP、SDK、curl、Python 和 JavaScript 路径。 | | 保留现有 OpenAI 客户端 | [OpenAI 兼容 API](docs/openai-compatible-api.zh-CN.md) | 把 `baseURL` 指向 `/v1`，使用 Chat Completions、函数工具、Responses、流式响应和模型发现。 | | 接入其他智能体 | [A2A v1.0 网关](docs/a2a-protocol.zh-CN.md) | 可选验签 Agent Card/JWKS，并通过 JSON-RPC 执行租户隔离的 fake-provider 任务；支持有界 memory 或同主机持久存储。 | | 检查协议覆盖 | [协议兼容性矩阵](docs/protocol-client-compatibility.zh-CN.md) | 区分官方 SDK 证据和具名客户端认证。 | | 检查客户端真实运行认证 | [客户端运行时认证](docs/client-runtime-certification.md) | 当前有证据支持的目录状态：2,136 个唯一项中 52 项已验证、2,084 项待人工证据、0 项失败。 | | 检查增强契约 | [无凭据评估](docs/prompt-enhancement.md#prompt-enhancement-evaluation) | 用 8 个代表性案例检查 profile、语言、信号、确定性和零 Provider 调用。 | | 排查首次运行问题 | [首次运行排障矩阵](docs/first-run-troubleshooting.zh-CN.md) | 针对不同 Shell 的检查，不暴露凭据。 | | 贡献或报告运行结果 | [结构化使用报告](https://github.com/happy520ai/unified-ai-system/issues/new?template=usage-verification-report.yml) 或 [入门任务 #106](https://github.com/happy520ai/unified-ai-system/issues/106) | 用户与维护者都能复现的反馈入口。 | | 验证 MCP 客户端 | [MCP 客户端报告](https://github.com/happy520ai/unified-ai-system/issues/new?template=mcp-client-report.yml) | 记录一次 Codex、Cursor、Cline 或通用 stdio 客户端运行。 | ## 网关能力全景 以下能力全部跑在同一个自托管进程里——按需开启、fake provider 优先， 零凭证即可试用每一项：

能力卡片：OpenAI、Anthropic 与 Gemini API，虚拟 key 与预算，精确缓存 + 可选语义层，反向 MCP 治理，可观测性，本地优先 RAG，Provider 治理，以及 23 项攻击安全回归

| 能力 | 你能得到什么 | 文档 | | --- | --- | --- | | OpenAI + Anthropic + Gemini 兼容 API | `/v1/chat/completions`（SSE 流式、工具调用、图片/音频多模态、n>1 多候选）、**原生 Anthropic 流式 + prompt caching（cache_control 透传）**的 `/v1/messages`、**Gemini 原生入站** `:generateContent/:streamGenerateContent/:batchGenerateContent`、Responses API、模型发现——保留现有 SDK，只改 base URL。 | [OpenAI 兼容 API](docs/openai-compatible-api.md) · [Gemini](docs/gemini-provider.md) | | 虚拟 key + 预算 | 签发 `uai-` key，支持按周期 token 预算（日/月窗口）、每 key 请求限速、软预算告警、花费归因、即时吊销；消费方永远拿不到 provider 密钥。 | [虚拟 key](docs/virtual-keys.md) · [花费报表](docs/spend-reporting.md) | | 响应缓存（精确 + 语义） | 租户隔离的热路径缓存，JSON/SSE 字节级重放；可选语义层命中同义改述；TTL/大小上限 + 完整审计。 | [响应缓存](docs/response-cache-hot-path.md) | | Guardrails（确定性本地护栏） | 输入/输出双向扫描：粘贴密钥拦截、PII 脱敏、注入话术告警、违禁词与长度限制——无云依赖、零额外凭证、实测开销 <0.2ms、每条规则可运行时配置。 | [Guardrails](docs/guardrails.md) | | 反向 MCP 治理 | 把上游 MCP server（Streamable HTTP / stdio）聚合到一个认证、审计、白名单的统一入口——还有 **REST→MCP**：任意 OpenAPI 3 规格一键变成受治理的 MCP 工具。 | [反向 MCP 治理](docs/reverse-mcp-governance.md) | | 可观测性 | `/metrics` 暴露 chat 专属 Prometheus 指标——分模型 token、缓存命中率、TTFT 直方图、虚拟 key 拒绝、**真实 p50/p95/p99 延迟分位数**——外加可选 Langfuse 导出与按 key 花费报表（API/CLI）。 | [可观测性](docs/observability-export.md) | | 向量检索 + 热路径 RAG | 零凭证确定性 embedding（可插拔 HTTP 真实 embedding）+ SQLite 向量库激活 `mode: "vector"` 检索；`unified_ai.rag` 在 `/v1/chat/completions` 上按请求注入带来源的知识上下文。 | [Provider 与知识库](docs/providers.md) | | 流量治理 | 运营可配的**加权分流**与**影子流量**（`AI_GATEWAY_WEIGHTED_ROUTES_JSON`）：影子调用独立进入成本账本；真实 provider 影子还要求 `AI_GATEWAY_SHADOW_REAL_PROVIDER_ENABLED=true`。 | [多进程部署](docs/multi-process-deployment.md) | | Provider 治理 | 真实 provider 三道门白名单矩阵；运行时凭据默认仅在内存，可显式启用 AES-256-GCM 加密文件/SQLite 持久化并单独保护主密钥；虚拟 key 与用户 token 使用哈希存储；请求成本守卫、熔断器和 fallback 链。 | [真实 provider 启用](docs/real-provider-enablement.md) | | 本地客户端智能网关 | 租户隔离清单、服务端绑定的每客户端 PoP（可选单机持久防重放）、策略固定的 OpenAI/Anthropic/Gemini/原生 chat fake-provider 调度、仅 dry-run 自动治理、回执反馈持久 outbox 与聚合层恰好一次学习、不可逆撤销，以及 Claude-compatible、Cursor、VS Code JSON 事务接入。无凭据 fixture 已通过；真客户端/真 Provider 认证、分布式状态、外部防回滚锚和已部署 Windows 受保护权威仍是发布门。 | [设计与证据边界](docs/local-client-intelligence-gateway.md) | | 企业身份与供给 | **OIDC SSO**（授权码+PKCE+JWKS 验签，登录即发 API token）与 **SCIM 2.0** 用户供给（Bearer 鉴权，create/get/list/patch/deactivate）；RBAC、审计哈希链租户隔离，23 项攻击安全回归守护。 | [安全演练](tools/security-attack-regression.mjs) · [演练输出](https://happy520ai.github.io/unified-ai-system/security-drill-evidence.html) · [演练没有建立的结论](https://happy520ai.github.io/unified-ai-system/mcp-security-boundaries.zh-CN.html) | | 本地计费台账 | 客户/用量/开票/作废/收款登记的 JSONL 台账（未接支付网关：票据如实标注为对账单，非法律发票）。 | [花费报表](docs/spend-reporting.md) | | 多实例控制 | `AI_GATEWAY_MULTI_INSTANCE=true` 保留同主机 SQLite 默认；PostgreSQL 模式覆盖跨主机配额、响应幂等、调度墓碑、WebSocket/A2A/Workforce 租约与终态 fence、审批、中央计费用量和共享 HMAC 审计链。当前源码还以持久 effect tombstone 约束受治理的不可逆内建工具、Webhook、MCP/OpenAPI mutation 与自定义工具。破坏性 CI 演练恢复 PostgreSQL 17、建立真实异步 standby、证明 WAL 重放，并以“连续三次失败 + 二次确认 + 独立围栏”自动提升唯一 standby；真实 Docker bridge 分区期间旧主仍可写但禁止误晋升，恢复后 marker 追平。故障转移后旧主卷先经 `pg_rewind -R`，首次启动只能作为 standby并在新主重启后继续复制；另有独立 manifest 物理基线和连续 WAL archive，删除基线自带 WAL 后仅靠 archive恢复到“好 marker 已存在、稍后坏 marker 不存在”的精确 LSN，八类状态全部通过。这是有界 LSN-PITR、单桥 fencing、旧主安全重入、single-standby failover 与 TTL 内 at-most-once 准入证据，不等于 Provider 侧 exactly-once、多候选 quorum、外部 HA、长时/异地 archive custody、time-based PITR、任意多主机分区/rejoin、完整 split-brain 或生产 RTO/RPO。 | [多进程部署](docs/multi-process-deployment.md) · [PostgreSQL 恢复演练](docs/postgresql-recovery-drill.md) · [外部副作用 fencing](docs/external-effect-fencing.md) | 已发布基础设施基准（fake provider、单机）：chat JSON p50 **15.6 ms**、SSE 首字 **2.8 ms**、并发 8 下 **402 req/s**、缓存命中比未命中快 **5.6×**——见[网关基准报告](docs/benchmarks/2026-08-gateway-benchmark.md)。 ## 为什么使用它 - 不擅长写提示词的用户，也能从自然语言开始工作。 - 无需账号或密钥即可完成干净克隆验证。 - 提供 curl、Python 标准库和 JavaScript 的无 provider 示例。 - 同时支持 OpenAI SDK、CLI、HTTP API、共享 SDK、MCP、Codex、Cursor、Cline 和 Continue。 - 默认使用本地 fake provider，真实 provider 必须显式启用。 - 不声称 AGI、L5 或生产就绪，只展示可以复现的行为。 ## 管道式自然语言输入 当没有提供位置参数或 `--prompt` 时，`demo`、`enhance` 和 `chat` 会从 stdin 读取请求，适合接入 Shell 管道、文本文件和编辑器脚本： ```bash printf '%s' "帮我规划一个小型 API 的发布" | pnpm gateway enhance --profile planning --language zh-CN cat request.txt | pnpm gateway enhance --profile auto --json ``` PowerShell 可以这样使用： ```powershell Get-Content .\request.txt -Raw | pnpm gateway enhance --profile auto --json ``` 输入会在发送到网关前去除首尾空白。`chat` 仍会执行正常的 provider 安全检查；从 stdin 读取请求不会授权真实 provider。 ## 常用工作流 ### 终端 从源码安装后： ```bash pnpm gateway serve pnpm gateway status pnpm gateway doctor pnpm gateway enhance "帮我为团队设计一个小型 API" --profile coding pnpm gateway chat "帮我为团队设计一个小型 API" --enhance --profile coding ``` 受保护的本地客户端控制面提供只读检查和显式受治理生命周期命令。 建议通过环境变量提供管理员虚拟 key，避免写入 shell 历史： ```powershell $env:AGENT_CONSOLE_ADMIN_KEY = "" pnpm gateway clients --json pnpm gateway clients discover --json pnpm gateway clients --help ``` 发现和 smart-manage 默认 dry-run。状态变更必须显式确认并提供管理员 key； 结果不确定的写操作绝不自动重试。注册表检查不等于已配置或控制某个命名应用。 适配器与证据边界见[本地客户端智能网关设计](docs/local-client-intelligence-gateway.md)。 如果偏好 Node.js，可运行只使用内置模块的示例；它会先验证 provider-free 响应，再输出增强后的 JSON： ```bash node docs/examples/prompt-enhancement.mjs "帮我为团队规划一个小型 API" --profile planning --language zh-CN ``` 如果偏好 Go，可运行只使用标准库的示例；它会先验证网关处于 provider-free 模式，再输出包含安全证据的增强 JSON： ```bash go run docs/examples/prompt-enhancement.go "帮我为团队规划一个小型 API" --profile planning --language zh-CN ``` 完整的 HTTP 示例见[自然语言增强指南](docs/prompt-enhancement.md)，其中包含跨平台 curl、Python、Node.js 和 SDK 用法。 ### 现有 OpenAI SDK 先用 `pnpm gateway serve` 启动源码网关，然后保留现有 OpenAI 客户端，只修改 它的 base URL： ```js import OpenAI from "openai"; const client = new OpenAI({ baseURL: "http://127.0.0.1:3100/v1", apiKey: process.env.PME_AUTH_TOKEN || "local-development", }); const result = await client.chat.completions.create({ model: "local-fake-model", messages: [{ role: "user", content: "帮我为团队设计一个小型 API" }], }); console.log(result.choices[0].message.content); ``` 无凭据门禁使用官方 OpenAI JavaScript SDK `7.4.0` 验证这条路径。源码网关运行时， 可以直接复现： ```bash node docs/examples/openai-sdk-chat.mjs ``` 这个聚焦的兼容层支持文本完成、流式响应、模型列表和可选的本地提示词增强。 Python 示例、支持字段、鉴权方式和明确限制见 [OpenAI 兼容 API 指南](docs/openai-compatible-api.zh-CN.md)。 ### MCP、Codex、Cursor、Cline 直接添加已发布的 MCP 镜像： ```bash codex mcp add unified-ai-system -- docker run --rm -i ghcr.io/happy520ai/unified-ai-system/mcp-server:0.8.0 ``` 在 Apple Silicon 机器上，请把 `--platform linux/amd64` 写在镜像名之前：已发布的 `linux/arm64` 标签目前带的是 x86-64 原生模块（含 `better-sqlite3`），受治理工具在该架构上会加载失败 —— [issue #190](https://github.com/happy520ai/unified-ai-system/issues/190) 记录了读数与复现命令。 重启 Codex 后运行 `/mcp` 检查连接，再参考 [Codex MCP 60 秒快速开始](https://happy520ai.github.io/unified-ai-system/codex-mcp-docker-quickstart.zh-CN.html)。 当前源码提供 15 个工具，包括健康检查、Agent 治理查询、自然语言增强、聊天、知识、工作流和 workforce 能力。镜像标签与工作树是不同对象，安装后应检查实际工具清单。 从仓库自行构建要多一个参数：根目录 `Dockerfile` 定义了两个可发布阶段 `mcp` 与 `gateway`，而 `gateway` 排在最后， 所以不加参数的 `docker build .` 得到的是 HTTP 网关，它不会在 stdio 上应答： ```bash docker build --target mcp -t unified-ai-system-mcp . printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}' \ | docker run --rm -i unified-ai-system-mcp ``` `--target mcp` 与 `--target gateway` 正是发布工作流实际构建的两个目标，所以这不是只写在文档里的说法。 任何通过构建我们的 `Dockerfile` 做 introspection 的系统，无论目录站检查工具定义还是你自己的 CI，都必须选 `mcp`； 否则它只会看到一个应答 HTTP 的网关，看不到 MCP 服务。 需要通过 URL 接入的 MCP 客户端，可以使用源码提供的仅本机监听 Streamable HTTP 入口： ```bash pnpm mcp:http # http://127.0.0.1:3210/mcp ``` 远程绑定的鉴权要求与发布版本边界见 [MCP Server 指南](packages/mcp-server/README.md#streamable-http)。 ### 可安装的 Agent Skill ```bash codex plugin marketplace add happy520ai/unified-ai-system --ref master npx skills add happy520ai/unified-ai-system --skill unified-ai-gateway --agent codex --copy --yes ``` 插件固定使用[已审查的 v0.4.9 不可变 MCP 镜像](docs/security/mcp-image-review-0.4.9.md)， 启动时禁用容器网络并移除 Linux capabilities。当前发布版另有自己的 [镜像内容审查](docs/security/mcp-image-review-0.8.0.md)，直接读取已发布的 layer tarball 而非 Docker 导出， `linux/arm64` 的架构注意事项就记录在该页。 Skill 主页： ### 从源码运行 需要 Node.js 22.18.0 或更高版本，以及 pnpm 11.19.0。 ```bash git clone https://github.com/happy520ai/unified-ai-system.git cd unified-ai-system corepack enable corepack prepare pnpm@11.19.0 --activate pnpm install --frozen-lockfile pnpm verify:public-clone pnpm gateway demo ``` 源码开发和完整验证需要 Node.js 22.18.0 或更高版本；Docker 快速路径不需要本地 Node.js。 如果不想配置本地环境，可以直接使用 [GitHub Codespaces](https://codespaces.new/happy520ai/unified-ai-system?quickstart=1)。工作区准备完成后先运行一条命令查看结果： ```bash pnpm gateway demo "帮我为团队设计一个小型 API" --enhance --profile coding --evidence ``` 如需执行完整的无凭据公共克隆检查，再运行 `pnpm verify:public-clone`。 仓库的 devcontainer 默认保持 provider-free。Codespaces 的可用性和使用额度由 GitHub 控制。 ### Docker Compose 如果使用源码目录，可以通过 Compose 启动网关并等待就绪检查： ```bash docker compose up --build -d docker compose ps curl http://127.0.0.1:3100/health/check ``` 只有 `/health/check` 成功响应后，服务才会显示为 `healthy`。使用完成后执行： ```bash docker compose down ``` Compose 将 `.env` 视为可选配置，并保持 provider 行为显式；无凭据的 fake-provider 路径仍是默认路径。 ## 分享可验证结果 如果这个项目对你的工作流有帮助，请运行一条可复现路径、[给仓库点 Star](https://github.com/happy520ai/unified-ai-system)，再通过[结构化使用报告](https://github.com/happy520ai/unified-ai-system/issues/new?template=usage-verification-report.yml)分享最小且有用的结果。 如果希望直接生成可复核的 CLI 证据包，可在增强 demo 后追加 `--evidence`： ```bash pnpm gateway demo "帮我为团队设计一个小型 API" --enhance --profile coding --language zh-CN --evidence ``` 分享前请检查原始请求和输出内容。 如果使用浏览器 Prompt Lab，可以点击“复制证据”或“下载证据”，再把 JSON 粘贴或附加到同一模板里的可选 Prompt Lab evidence 字段。 如果希望其他浏览器复现同一个本地场景，可以点击“复制分享链接”；分享前请检查原始请求，因为 URL 片段会包含输入文本。 ## 下一步 - [文档总览](docs/README.md)：安装、CLI、自然语言增强与 provider 配置。 - [Codex MCP 快速开始](https://happy520ai.github.io/unified-ai-system/codex-mcp-docker-quickstart.zh-CN.html)：最快接入 Codex 与 MCP；仓库内同时保留[源码指南](docs/codex-mcp-quickstart.md)。 - [自托管 AI 网关对比（各自原话）](https://happy520ai.github.io/unified-ai-system/self-hosted-ai-gateways-compared.zh-CN.html)：LiteLLM、Portkey Gateway、Agent Router 与本项目，逐条摘自各自 README 并标注阅读日期，另附移交智能体流量前应当先问的三个问题。 - [对公开 MCP 生态的九项测量](https://happy520ai.github.io/unified-ai-system/mcp-ecosystem-measurements.html)——向官方注册表登记的 40 个服务器匿名提问：[16 个应答者中 0 个在分页 `tools/list`](https://github.com/happy520ai/unified-ai-system/blob/master/docs/mcp-tools-list-pagination-survey.md)、[18 个应答者中有 2 个答应使用一个根本不存在的协议版本](https://github.com/happy520ai/unified-ai-system/blob/master/docs/mcp-protocol-revision-tolerance.md)、[发出 session id 的那 2 个服务器都要求把它带回来](https://github.com/happy520ai/unified-ai-system/blob/master/docs/mcp-session-enforcement.md)，以及[16 个里只有 1 个实现了 `server/discover`，12 个听说都没听说过](https://happy520ai.github.io/unified-ai-system/mcp-ecosystem-measurements.html)，还有[16 个里有 9 个会把服务端撰写的 `instructions` 长文本送给一个匿名客户端，每段 72 到 1,423 字符](https://happy520ai.github.io/unified-ai-system/mcp-ecosystem-measurements.html)。40 个里有 22 个根本不接受匿名客户端，每一页都如实写明自己的分母是什么。其中两个结论有各自的页面，值得按它自己的口径读：[服务端有没有说工具清单能缓存多久](https://happy520ai.github.io/unified-ai-system/mcp-list-cache-hints.html)——16 个返回清单的服务端里只有 1 个说了，而我们自己两个字段都没读；以及[Mcp-Method 头能不能把服务端改道到正文没写的方法](https://happy520ai.github.io/unified-ai-system/mcp-route-headers.html)——16 组 POST 配对与 13 条无正文 GET 全是 0 次，另附那条被重复腿在写成结论之前抓住的假阳性。每页都附带脚本，两分钟就能自己重跑一遍，整套结果都作为生成的数据发布：[40 端点样本（2026-09-27）](https://happy520ai.github.io/unified-ai-system/data/mcp-ecosystem-measurements.json)、[九问十次测量的重跑（2026-09-28）](https://happy520ai.github.io/unified-ai-system/data/mcp-ecosystem-measurements.2026-09-28.json) 与 [宽样本](https://happy520ai.github.io/unified-ai-system/data/mcp-ecosystem-measurements.wide.json)。另有一个问题在同日晚间以独立样本窗口测得：[有没有服务端强制 `MCP-Protocol-Version` 头](https://happy520ai.github.io/unified-ai-system/mcp-protocol-version-header.html)——16 个应答者中 0 个在意，这也正说明补齐我们自己的缺口是一致性修复，而不是互操作抢救。最后有一项是普查而不是抽样：[把注册表默认视图里的每一个服务器都数一遍](https://happy520ai.github.io/unified-ai-system/mcp-registry-census.html)——123,831 条版本记录归并成 37,013 个服务器，其中 439 个（1.20%）既没有 package 也没有 hosted endpoint；第二次重走的读数与它并排发布，因为一个复现不了的数字只是轶事。 - [贡献指南](CONTRIBUTING.md)：聚焦改动与安全验证要求。 - [使用报告模板](.github/ISSUE_TEMPLATE/usage-verification-report.yml)：提交可复现反馈。 - [引用本项目](CITATION.cff)、[路线图](ROADMAP.md)与[支持页面](SUPPORT.md)。 ## 诚实边界 - 干净克隆和 fake provider 路径：**已验证** - 托管的公共 API：**没有** - 默认真实 provider 执行：**没有**，必须显式启用 - 仓库内置浏览器聊天 UI：**没有**，CLI、API 和 MCP 是一等入口 - 生产就绪、AGI、L5：**不声称** 真实 provider 默认关闭。请参考 `.env.example` 和[provider 配置指南](docs/providers.md)进行显式配置。 ## 验证项目 ```bash pnpm check pnpm test pnpm check:public pnpm verify:public-clone pnpm verify:mcp ``` `master` 上的 CI 会执行 Linux 检查、容器启动 smoke test、MCP 发现和进程清理验证。 ## 项目链接 - [官方 MCP Registry 条目](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.happy520ai%2Funified-ai-system/versions/0.8.0) - [Release v0.8.0](https://github.com/happy520ai/unified-ai-system/releases/tag/v0.8.0) - [Codex MCP Server README](packages/mcp-server/README.md) - [Roadmap](ROADMAP.md) - [Vision](VISION.md) - [Support](SUPPORT.md) ## Star History 如果这个网关帮你省了一次代理迁移或一下午的提示词整理， [点个 star](https://github.com/happy520ai/unified-ai-system/stargazers) 能让更多人看到它。 [![Star History Chart](https://api.star-history.com/svg?repos=happy520ai/unified-ai-system&type=Date)](https://star-history.com/#happy520ai/unified-ai-system&Date)