ai-lib-python | AI-Protocol Python 运行�?/title> <meta name="description" content="ai-lib-python �?AI-Protocol 官方 Python 运行时。异步优先、Pydantic v2 类型、生产级遥测、模型路由�? /> <meta name="viewport" content="width=device-width,initial-scale=1" /> <link rel="icon" href="/favicon.svg" /> </head> <body> <SiteHeader locale=zh-cn /> <main>  <section class="relative pt-16 pb-20 overflow-hidden"> <div class="absolute inset-0 -z-10"> <div class="absolute top-0 left-1/4 w-96 h-96 bg-emerald-500/5 rounded-full blur-3xl"> </div> <div class="absolute bottom-0 right-1/3 w-80 h-80 bg-cyan-500/5 rounded-full blur-3xl"> </div> </div> <div class="container"> <div class="max-w-4xl"> <div class="inline-flex items-center gap-2 px-3 py-1 rounded-full text-xs font-medium bg-emerald-500/10 text-emerald-400 border border-emerald-500/20 mb-6" > v1.0.0 · PyPI </div> <h1 class="text-4xl md:text-6xl font-extrabold tracking-tight mb-6 leading-[1.05]"> <span class="gradient-text-python">Python 运行�?/span> <br /> <span class="text-[var(--text)]">适用�?AI-Protocol</span> </h1> <p class="text-lg md:text-xl text-[var(--text-dim)] max-w-2xl mb-8 leading-relaxed"> 开发者友好、基于协议的 AI 客户端。V2 标准错误码（13 种）、基于能力的可选包�? 个可选包 + 完整包）、全面异步支持、Pydantic v2 类型安全、生产级遥测和智能模型路由。Python 3.10+�? </p> <div class="flex flex-wrap gap-4 mb-8"> <a href="/zh-cn/python/quickstart/" class="inline-flex items-center gap-2 px-6 py-3 bg-emerald-600 text-white font-semibold rounded-lg hover:bg-emerald-700 transition-all hover:no-underline" >快速入�?/a > <a href="https://github.com/ailib-official/ai-lib-python" target="_blank" rel="noopener" class="inline-flex items-center gap-2 px-6 py-3 border border-[var(--border)] text-[var(--text)] font-semibold rounded-lg hover:bg-[var(--bg-alt)] transition-all hover:no-underline" >GitHub</a > <a href="https://pypi.org/project/ai-lib-python/" target="_blank" rel="noopener" class="inline-flex items-center gap-2 px-6 py-3 border border-[var(--border)] text-[var(--text)] font-semibold rounded-lg hover:bg-[var(--bg-alt)] transition-all hover:no-underline" >PyPI</a > </div> <div class="bg-[#0d1117] border border-[var(--border)] rounded-lg p-4 max-w-lg"> <div class="text-xs text-[var(--text-muted)] mb-2 font-mono">终端</div> <code class="text-sm text-emerald-300 font-mono">pip install ai-lib-python</code> </div> </div> </div> </section>  <section class="section-alt"> <div class="container"> <h2 class="text-3xl font-bold text-[var(--text)] mb-10 text-center">主要特�?/h2> <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6"> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">V2 错误码与能力扩展�?/h3> <p class="text-sm text-[var(--text-dim)]"> 13 �?V2 标准错误码，实现一致的错误处理。基于能力的扩展包：8 个可选包及完整包，支持最小或完整安装�? </p> </div> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">异步优先设计</h3> <p class="text-sm text-[var(--text-dim)]"> 全链路原�?async/await。基�?httpx 的传输层，带连接池。CancellableStream 实现优雅的流式终止�? </p> </div> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">Pydantic v2 类型</h3> <p class="text-sm text-[var(--text-dim)]"> 完整的类型提示与 Pydantic v2 校验。ProtocolManifest、Message、ContentBlock、StreamingEvent �? 全部类型安全并支持运行时验证�? </p> </div> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">ResilientExecutor</h3> <p class="text-sm text-[var(--text-dim)]"> ResilientExecutor 整合背压、限流、熔断和指数退避重试。PreflightChecker 在执行前对请求进行门控�? </p> </div> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">模型路由</h3> <p class="text-sm text-[var(--text-dim)]"> ModelManager 配合 ModelArray 实现智能模型选择。策略包括轮询、加权、基于成本和基于质量的路由�? </p> </div> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">生产级遥�?/h3> <p class="text-sm text-[var(--text-dim)]"> MetricsCollector 支持 Prometheus 导出。通过 OpenTelemetry 实现分布式追踪。结构化日志。健康监控。用户反馈收集�? </p> </div> <div class="p-6 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="font-bold text-[var(--text)] mb-2">结构化输�?/h3> <p class="text-sm text-[var(--text-dim)]"> JSON 模式配置、从 Pydantic 模型生成 schema、输出校验。内容过滤和 PII 检测的护栏�? </p> </div> </div> </div> </section>  <section class="section"> <div class="container"> <div class="grid grid-cols-1 lg:grid-cols-2 gap-10 items-start"> <div> <h2 class="text-3xl font-bold text-[var(--text)] mb-4">Python 风格与直�?/h2> <p class="text-[var(--text-dim)] mb-6 leading-relaxed"> 简洁、符�?Python 风格�? API，使用自然。从模型标识符创建客户端，使用流式构建器构建请求，并遍历统一的流式事件�? </p> <p class="text-[var(--text-dim)] mb-6 leading-relaxed"> 同一套代码适用于所有提供商。从 OpenAI 切换�?Anthropic �? DeepSeek，只需更改一个字符串 �?协议清单会处理其余工作�? </p> </div> <div> <pre class="text-sm !bg-[#0d1117] !border-emerald-500/20"><code class="language-python"><span style="color:#ff7b72">from</span> ai_lib_python <span style="color:#ff7b72">import</span> AiClient <span style="color:#8b949e"># Works with ANY provider</span> client = <span style="color:#ff7b72">await</span> AiClient.create( <span style="color:#a5d6ff">"anthropic/claude-3-5-sonnet"</span> ) <span style="color:#8b949e"># Streaming chat</span> <span style="color:#ff7b72">async for</span> event <span style="color:#ff7b72">in</span> client.chat() \ .user(<span style="color:#a5d6ff">"Explain AI-Protocol"</span>) \ .temperature(<span style="color:#79c0ff">0.7</span>) \ .max_tokens(<span style="color:#79c0ff">1000</span>) \ .stream(): <span style="color:#ff7b72">if</span> event.is_content_delta: print(event.as_content_delta.text, end=<span style="color:#a5d6ff">""</span>) <span style="color:#8b949e"># Non-streaming with stats</span> response, stats = <span style="color:#ff7b72">await</span> client.chat() \ .user(<span style="color:#a5d6ff">"Summarize this"</span>) \ .execute_with_stats() print(f<span style="color:#a5d6ff">"Tokens: {stats.total_tokens{'}'}"</span>) print(f<span style="color:#a5d6ff">"Latency: {'{'}stats.latency_ms{'}'}ms"</span>)</code></pre> </div> </div> </div> </section>  <section class="section-alt"> <div class="container"> <div class="text-center mb-10"> <h2 class="text-3xl font-bold text-[var(--text)] mb-4">内部架构</h2> <p class="text-lg text-[var(--text-dim)] max-w-2xl mx-auto"> �?Rust 运行时相同的分层架构 �?协议驱动、基于算子、默认弹性�? </p> </div> <RuntimeArch locale={locale} variant="python" /> </div> </section>  <section class="section"> <div class="container"> <h2 class="text-3xl font-bold text-[var(--text)] mb-10 text-center">模块概览</h2> <div class="grid grid-cols-1 md:grid-cols-2 gap-6"> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono"> client/ + errors/standard_codes/ </h3> <p class="text-sm text-[var(--text-dim)]"> AiClient、AiClientBuilder、ChatRequestBuilder、ChatResponse、CallStats、CancelToken、CancellableStream�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono">protocol/</h3> <p class="text-sm text-[var(--text-dim)]"> ProtocolLoader（本�?环境变量/GitHub）、Pydantic 清单模型、JSON Schema 校验器、热重载支持�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono">pipeline/</h3> <p class="text-sm text-[var(--text-dim)]"> Decoder（SSE、JSON Lines、Anthropic SSE）、Selector（JSONPath）、Accumulator、FanOut、EventMapper（协议驱动、默认、Anthropic）�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono">resilience/</h3> <p class="text-sm text-[var(--text-dim)]"> ResilientExecutor、RetryPolicy、RateLimiter、CircuitBreaker、Backpressure、FallbackChain、SignalsSnapshot、PreflightChecker�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono">routing/</h3> <p class="text-sm text-[var(--text-dim)]"> ModelManager、ModelArray，选择策略（轮询、加权、基于成本、基于质量）。主流提供商预配置目录�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono">telemetry/</h3> <p class="text-sm text-[var(--text-dim)]"> MetricsCollector（Prometheus）、Tracer（OpenTelemetry）、结构化 Logger、HealthChecker、用户反馈收集�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono"> embeddings/ + tokens/ </h3> <p class="text-sm text-[var(--text-dim)]"> EmbeddingClient 及向量操作。TokenCounter（tiktoken 集成）与成本估算，用于使用量追踪�? </p> </div> <div class="p-5 rounded-xl border border-[var(--border)] bg-[var(--bg-card)]"> <h3 class="text-base font-bold text-emerald-400 mb-1 font-mono"> plugins/ + structured/ </h3> <p class="text-sm text-[var(--text-dim)]"> 插件基类、PluginRegistry、HookManager、中间件链。JSON 模式配置、SchemaGenerator、OutputValidator�? </p> </div> </div> </div> </section>  <section class="section-alt"> <div class="container text-center"> <h2 class="text-3xl font-bold text-[var(--text)] mb-4">开始用 Python 构建</h2> <div class="flex flex-wrap gap-4 justify-center"> <a href="/zh-cn/python/quickstart/" class="inline-flex items-center gap-2 px-6 py-3 bg-emerald-600 text-white font-semibold rounded-lg hover:bg-emerald-700 transition-all hover:no-underline" >快速入�?/a > <a href="/zh-cn/python/overview/" class="inline-flex items-center gap-2 px-6 py-3 border border-[var(--border)] text-[var(--text)] font-semibold rounded-lg hover:bg-[var(--bg-alt)] transition-all hover:no-underline" >完整文档</a > </div> </div> </section> </main> <Footer locale={locale} /> </body> </html>}