docs: rescan rebased documentation hierarchy

2026-08-05 16:16:57 +08:00
parent 012bb0a549
commit 8af3babaea
304 changed files with 1091 additions and 1983 deletions
@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write python/README.md
-README.md: 010d922b52eae0be184baec063e307b5c8e55819
-README.zh.md: ebf773d943e3ad3248fb41c58ca7e44950bb9d7f
+README.md: 27637edb9d4d5e8714fe379a00b6aae3af1a541f
+README.zh.md: dd020aa507de965815fc05f8423b87e766a2fb42
@@ -17,4 +17,4 @@ The SDK starts the matching bundled runtime unless the caller selects an explici

 ## Contributor workflows

-The [Python contributor reference](development.md) covers building runtime artifacts, validating the packages, source-mode development, and distribution.
+The [Python contributor workflows](development.md) cover building runtime artifacts, validating the packages, source-mode development, and distribution.
@@ -17,4 +17,4 @@

 ## 贡献者工作流

-[Python 贡献者参考](development.md)介绍运行时产物构建、包验证、源码模式开发和分发。
+[Python 贡献者工作流](development.md)介绍运行时产物构建、包验证、源码模式开发和分发。
@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write python/development.md
-development.md: f7cf69f798c08f8e2b558bb68431bc77ab220378
-development.zh.md: 53e31bc1455367f95260dccf5a2bcc7d2ed6e55d
+development.md: b0d4875f0d5b7c8fd2b4b480ac67793741640710
+development.zh.md: 4fda7efbeaa0359bd4999aca148ca21a63c4fd70
@@ -2,7 +2,7 @@

 English | [中文](development.zh.md)

-Reference for building, validating, and distributing the Python SDK and bundled runtime. Package behavior belongs in the [SDK reference](sdk/README.md) and [runtime carrier reference](sdk-runtime/README.md).
+Follow the workflow for the contributor outcome you need: build runtime artifacts, validate the SDK, run against source, or build distributions. Package behavior belongs in the [SDK reference](sdk/README.md) and [runtime carrier reference](sdk-runtime/README.md).

 ## Build runtime artifacts

@@ -2,7 +2,7 @@

 [English](development.md) | 中文

-构建、验证和分发 Python SDK 与内置运行时的参考。包行为分别见 [SDK 参考](sdk/README.md)和[运行时载体参考](sdk-runtime/README.md)。
+根据所需的贡献者成果选择工作流：构建运行时产物、验证 SDK、从源码运行或构建分发包。包行为分别见 [SDK 参考](sdk/README.md)和[运行时载体参考](sdk-runtime/README.md)。

 ## 构建运行时产物

@@ -3,4 +3,4 @@
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write python/sdk/README.md
 README.md: bb3420f1a1bd461facbd0eb1312a255df1da4412
-README.zh.md: adc8e377ca9f70838b6164301a9052e2247c8eff
+README.zh.md: 2cb48ac9aaae115bbcce5943449bca9e42f2592c
@@ -29,7 +29,7 @@ with DeepSeekHarness(
    result = harness.run("Make the requested code change.")
 ```

-`provider` 用于选择当前 Cordis 组合已注册的提供方路由；`model` 是该适配器解析的模型 ID。`max_tokens` 是可选的正整数，用于限制根 agent 及其进程内后代每次请求的输出 token；省略时由提供方默认值控制。压缩摘要继续使用压缩插件单独配置的上限。内置默认组合注册 `deepseek-official`。自定义组合可以挂载 `llm-pi-ai`，在其中配置各提供方的凭据与端点，再选择 pi-ai 已安装目录中的任意提供方/模型组合。
+`provider` 用于选择当前 Cordis 组合已注册的提供方路由；`model` 是该适配器解析的模型 ID。`max_tokens` 是可选的正整数，用于限制根 agent（智能体）及其进程内后代每次请求的输出 token；省略时由提供方默认值控制。压缩摘要继续使用压缩插件单独配置的上限。内置默认组合注册 `deepseek-official`。自定义组合可以挂载 `llm-pi-ai`，在其中配置各提供方的凭据与端点，再选择 pi-ai 已安装目录中的任意提供方/模型组合。

 `HarnessClient` 会在运行时进程的生命周期内保留已发现的 subagent（子 agent）祖先关系。每次执行 `Session.run()` 时，`TurnResult.notifications` 与 `on_notification` 会按协议传输顺序收到根会话及所有已知后代的通知，其中包括嵌套 subagent 的生命周期事件与会话事件。`TurnResult.events` 仍只保存根会话的完整事件流，`TurnResult.final_response` 则取该会话最后一个 `assistant/message` 的文本内容，因此后代消息不会覆盖根会话回复。