docs: refresh translations, and translate pages in parallel (#3458)
This commit is contained in:
parent
08a3bc8eaf
commit
fd66270926
1 changed files with 4821 additions and 2277 deletions
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
translation:
|
||||
sections: [cfe01c0c5863dfa2, 1c58c5cfcc37d455, a7392996acf1ad8f, 875eb2889263424e]
|
||||
sections: [cfe01c0c5863dfa2, 0dbb68d8b210177b, 80cf193023af3ed4, 875eb2889263424e]
|
||||
tool: 1
|
||||
---
|
||||
# v2 的新变化 {#whats-new-in-v2}
|
||||
|
|
@ -37,11 +37,11 @@ mcp = MCPServer("Demo") # v1: FastMCP("Demo")
|
|||
|
||||
v1 交给你的是三层嵌套:一个产出原始流的传输上下文管理器,包在外面的 `ClientSession`,再加上手动调用的 `await session.initialize()`。v2 只有一个对象:
|
||||
|
||||
```python title="client.py" hl_lines="14-18"
|
||||
--8<-- "docs_src/client/tutorial001.py"
|
||||
```python title="client.py" hl_lines="7-11"
|
||||
--8<-- "docs_src/client/tutorial001_client.py"
|
||||
```
|
||||
|
||||
`Client` 接受一个服务器对象(内存直连,没有传输:这就是测试的做法)、一个 URL(Streamable HTTP)、一个 `StdioServerParameters`(stdio 子进程),或者其他任意传输上下文管理器,比如 `sse_client(...)`。进入 `async with` 就会建立连接并协商协议版本,不管服务器讲的是哪一代协议;之后 `client.server_capabilities` 和 `client.protocol_version` 直接就在那里,服务器表明身份时 `client.server_info` 也一样(它现在是 `Implementation | None`,因为 2026 版的身份信息是可选的)。你在 v1 注册的采样和征询回调仍然能用(它们的函数体会看到和本页其他地方一样的 snake_case 属性重命名),现在还会回答 2026 风格的、嵌在结果里的请求(见下文),并且是并发运行而不是一次一个。想要底层接口的人仍然可以用底下的 `ClientSession`,`client.session` 会把它交给你;它也变了(运行在新的调度器引擎上,自身的一些签名也改了),所以下探之前先读 **[迁移指南](migration.md#clientsession-now-runs-on-jsonrpcdispatcher-basesession-removed)**。
|
||||
`Client` 接受一个 URL(Streamable HTTP)、一个 `StdioServerParameters`(stdio 子进程)、其他任意传输上下文管理器(比如 `sse_client(...)`),或者在测试里直接接受服务器对象本身(内存直连,没有传输)。进入 `async with` 就会建立连接并协商协议版本,不管服务器讲的是哪一代协议;之后 `client.server_capabilities` 和 `client.protocol_version` 直接就在那里,服务器表明身份时 `client.server_info` 也一样(它现在是 `Implementation | None`,因为 2026 版的身份信息是可选的)。你在 v1 注册的采样和征询回调仍然能用(它们的函数体会看到和本页其他地方一样的 snake_case 属性重命名),现在还会回答 2026 风格的、嵌在结果里的请求(见下文),并且是并发运行而不是一次一个。想要底层接口的人仍然可以用底下的 `ClientSession`,`client.session` 会把它交给你;它也变了(运行在新的调度器引擎上,自身的一些签名也改了),所以下探之前先读 **[迁移指南](migration.md#clientsession-now-runs-on-jsonrpcdispatcher-basesession-removed)**。
|
||||
|
||||
**[Client](client/index.md)** 介绍它,**[客户端传输](client/transports.md)** 讲四种连接形式,**[客户端回调](client/callbacks.md)** 讲回调本身,**[测试](get-started/testing.md)** 展示取代 v1 `create_connected_server_and_client_session()` 辅助函数的内存模式。
|
||||
|
||||
|
|
@ -166,11 +166,15 @@ v2 实现了 2026-07-28 修订版,并且同时服务 **两个** 修订版:
|
|||
|
||||
替代方案把调用反了过来。需要从用户那里拿东西的工具把问题 **返回** 出去(`InputRequiredResult`),客户端用它一直都有的那些回调来回答,然后调用会带着答案重试。`Client` 替你驱动这个循环。在服务器上你很少自己构建这个结果,因为 **[依赖](handlers/dependencies.md)** 会做这件事:用 `Resolve(ask_quantity)` 注解一个参数,其中 `ask_quantity` 是你写的普通函数,SDK 就会通过连接所支持的机制去问——在旧版会话上是实时的征询请求,在 2026 上是多轮往返。一个工具函数体,两代协议:
|
||||
|
||||
```python title="dual_era.py" hl_lines="24 37-38"
|
||||
```python title="server.py" hl_lines="21"
|
||||
--8<-- "docs_src/legacy_clients/tutorial001.py"
|
||||
```
|
||||
|
||||
这个文件把卖点集中在了一处:一个服务器,一个由 `Resolve` 支撑的工具,一个旧版客户端加一个新版客户端都拿到了各自的答案,全在内存里。**[多轮往返请求](handlers/multi-round-trip.md)** 解释这个机制(包括 `request_state`,SDK 会替你密封并验证它);**[征询](handlers/elicitation.md)** 讲提问的部分。
|
||||
```python title="client.py" hl_lines="14-15"
|
||||
--8<-- "docs_src/legacy_clients/tutorial001_client.py"
|
||||
```
|
||||
|
||||
这两个文件就是全部卖点:一个服务器,一个由 `Resolve` 支撑的工具,一个旧版客户端加一个新版客户端都从同一个正在运行的服务器拿到了各自的答案(**[服务旧版客户端](run/legacy-clients.md)** 会逐步讲解它们)。**[多轮往返请求](handlers/multi-round-trip.md)** 解释这个机制(包括 `request_state`,SDK 会替你密封并验证它);**[征询](handlers/elicitation.md)** 讲提问的部分。
|
||||
|
||||
!!! warning "这是移植过来的 v1 服务器唯一会改变行为的地方"
|
||||
你自己的测试会最先碰到它:`Client(mcp)` 默认会和你的 v2 服务器协商出 2026-07-28,所以调用 `ctx.elicit()` 的工具会在一个 v1 上能通过的测试里失败。把问题挪进一个 `Resolve(...)` 参数(两代通用),或者如果你确实想要推送行为,就把测试客户端固定为 `mode="legacy"`。
|
||||
|
|
|
|||
Loading…
Reference in a new issue