From 24f15cc4790f5b0a50f55332f77f4a2eeb35fdf1 Mon Sep 17 00:00:00 2001 From: leom1919 <1162308169@qq.com> Date: Tue, 27 Oct 2026 15:26:16 +0800 Subject: [PATCH] docs(zh): fix 5 cross-language anchor links pointing to English pages (#7603) Translated zh pages link to the English docs routes (/docs/...) but kept localized Chinese anchor slugs, which do not exist on the English pages. Replace each Chinese anchor with the matching English heading slug (verified present in the target file): a-run-fails-after-a-config-edit, forks-are-accepted-not-refused, placements, failure-isolation, runaway-guards. Co-authored-by: leom1919 --- frontend/src/content/zh/harness/checkpoints/quick-start.mdx | 2 +- frontend/src/content/zh/harness/checkpoints/reference.mdx | 2 +- frontend/src/content/zh/harness/extensions/index.mdx | 4 ++-- frontend/src/content/zh/harness/middlewares.mdx | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/frontend/src/content/zh/harness/checkpoints/quick-start.mdx b/frontend/src/content/zh/harness/checkpoints/quick-start.mdx index b247616829..1f185e7195 100644 --- a/frontend/src/content/zh/harness/checkpoints/quick-start.mdx +++ b/frontend/src/content/zh/harness/checkpoints/quick-start.mdx @@ -67,6 +67,6 @@ database: 因此这次改动在重启前一直被忽略。改 `checkpoint_delta.snapshot_frequency` 而不重启则更响—— 下一次 run 会失败，run 记录与 SSE `error` 帧里带着 `CheckpointModeReconfigurationError`。 这两种改动都不会让任何请求返回 `503`；见 - [故障排查](/docs/harness/checkpoints/troubleshooting#改完配置后-run-失败)。请通过重启所有共享 + [故障排查](/docs/harness/checkpoints/troubleshooting#a-run-fails-after-a-config-edit)。请通过重启所有共享 该检查点数据库的进程来发布改动。 diff --git a/frontend/src/content/zh/harness/checkpoints/reference.mdx b/frontend/src/content/zh/harness/checkpoints/reference.mdx index 0980ae505f..dfd1a1d4b7 100644 --- a/frontend/src/content/zh/harness/checkpoints/reference.mdx +++ b/frontend/src/content/zh/harness/checkpoints/reference.mdx @@ -159,7 +159,7 @@ Your config.yaml (version %d) is outdated — the latest version is %d. Run `mak | --- | --- | --- | --- | | `GET /api/threads/{thread_id}` | `get_thread` | 在 `404 Thread not found` 之前检查 | `threads:1276,1291-1292,1298-1299,1303` | | `GET /api/threads/{thread_id}/state` | `get_thread_state` | | `threads:1446,1454-1455,1458-1459` | -| `POST /api/threads/{thread_id}/state` | `update_thread_state` | 调用方传入的 `checkpoint_id` 若比 head 更旧，会作为一次增量分叉被直接应用，没有线性化 —— 见[分叉会被接受，而不是被拒绝](/docs/harness/checkpoints/resume-and-rollback#分叉会被接受而不是被拒绝) | `threads:1495,1559-1560` | +| `POST /api/threads/{thread_id}/state` | `update_thread_state` | 调用方传入的 `checkpoint_id` 若比 head 更旧，会作为一次增量分叉被直接应用，没有线性化 —— 见[分叉会被接受，而不是被拒绝](/docs/harness/checkpoints/resume-and-rollback#forks-are-accepted-not-refused) | `threads:1495,1559-1560` | | `POST /api/threads/{thread_id}/history` | `get_thread_history` | | `threads:1695,1715-1716,1907-1908` | | `POST /api/threads/{thread_id}/branches` | `branch_thread` → `_branch_thread_with_reservation` | detail 中的线程 id 是源线程；无测试覆盖该路由 | `threads:953,231-232,298-299,1105-1106` | | `POST /api/threads/{thread_id}/compact` | `compact_thread` | 压缩被禁用时同样返回 `409`；无测试覆盖该路由 | `threads:1399,1413-1414,1429-1430,1431-1432` | diff --git a/frontend/src/content/zh/harness/extensions/index.mdx b/frontend/src/content/zh/harness/extensions/index.mdx index ef3ea7cb59..5c932d13c2 100644 --- a/frontend/src/content/zh/harness/extensions/index.mdx +++ b/frontend/src/content/zh/harness/extensions/index.mdx @@ -35,7 +35,7 @@ import { Callout } from "nextra/components"; | 在配置里直接给所有 Agent 加一个 `AgentMiddleware` 类 | `config.yaml` 的 `extensions.middlewares`，见[自定义与扩展](/docs/harness/customization) | | 交付一个带版本的包，用来观察运行、保存状态、运行服务或提供路由 | **扩展包**（本手册） | -两条中间件路径容易混淆。`extensions.middlewares` 把一个类插到固定位置，不附带任何契约；扩展包的中间件声明语义化的[放置位置](/docs/harness/extensions/middleware#放置位置)，运行在隔离故障的包装器里，并且可以和下面其他贡献类型一起发布。 +两条中间件路径容易混淆。`extensions.middlewares` 把一个类插到固定位置，不附带任何契约；扩展包的中间件声明语义化的[放置位置](/docs/harness/extensions/middleware#placements)，运行在隔离故障的包装器里，并且可以和下面其他贡献类型一起发布。 ## 扩展能贡献什么 @@ -84,7 +84,7 @@ plugins: 扩展是观察性的，所以一个坏掉的扩展只会退化成一条日志，而不会搞坏一次运行： - 抛出异常的贡献会被跳过，Gateway 记录一条归属到其入口点的错误（`Extension : ...`）。 -- 贡献的中间件运行在隔离包装器里，包装器绝不会重复一次模型调用或工具副作用。见[故障隔离](/docs/harness/extensions/middleware#故障隔离)。 +- 贡献的中间件运行在隔离包装器里，包装器绝不会重复一次模型调用或工具副作用。见[故障隔离](/docs/harness/extensions/middleware#failure-isolation)。 - 任务生命周期通知共享一个有上限的时间预算；观察者逐个通知，一个观察者失败不会跳过后面的观察者。 唯一的例外是 `required: true`，它把任何加载失败都变成启动中止。只在缺了这个扩展部署就是错的情况下使用它，因为从这种失败中恢复需要有 shell 权限去改配置文件。 diff --git a/frontend/src/content/zh/harness/middlewares.mdx b/frontend/src/content/zh/harness/middlewares.mdx index 3212fd685f..b730af1ace 100644 --- a/frontend/src/content/zh/harness/middlewares.mdx +++ b/frontend/src/content/zh/harness/middlewares.mdx @@ -18,7 +18,7 @@ import { Callout } from "nextra/components"; 这种设计使 Agent 核心保持简单稳定，同时允许丰富的可组合行为分层叠加。 - 每个子 Agent 运行各自的 Agent 循环，并拥有自己的中间件链。下方的循环检测、token 预算和摘要压缩防护已镜像到子 Agent 链（#3875）；记忆、标题生成和澄清等其他 Lead Agent 专属中间件不会在子 Agent 链中运行。参见[子 Agent → 失控行为防护](/docs/harness/subagents/limits#失控行为防护)。 + 每个子 Agent 运行各自的 Agent 循环，并拥有自己的中间件链。下方的循环检测、token 预算和摘要压缩防护已镜像到子 Agent 链（#3875）；记忆、标题生成和澄清等其他 Lead Agent 专属中间件不会在子 Agent 链中运行。参见[子 Agent → 失控行为防护](/docs/harness/subagents/limits#runaway-guards)。 ## 链的工作方式