docs(i18n): include complete proofreading corpus

This commit is contained in:
xjt
2026-08-12 12:30:19 +08:00
parent 7b450d121e
commit 4806d94715
884 changed files with 2546 additions and 2547 deletions

View File

@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/util/timeout/README.md
README.md: 54908a7e5df0e6c5d337a0b9f82d447cfc55b49d
README.zh.md: 638dc1af60761f9c964e356edc070d20af0f4819
README.zh.md: b80cbeffb3a3a729bd2f4d2e0116088e68d0c949

View File

@@ -2,11 +2,11 @@
[English](README.md) | 中文
超时的**时序与分类**部分:一个零依赖纯函数库(无运行时 harness 依赖),由每个需要限制调用方超时提示、启动 deadline并在之后区分「已超时」与「已取消」的能共享。
超时的**时序与分类**部分:一个零依赖纯函数库(无运行时 harness 依赖),由每个需要限制调用方超时提示、启动 deadline并在之后区分「已超时」与「已取消」的能共享。
它**不负责终止**。它发出的信号只会*通知*;真正停止工作仍由各能负责因为机制各不相同bash 对操作系统进程组发送 SIGKILLweb 关闭 `fetch` 套接字,没有任何共享层能够承担全部终止机制。[Agent Note](../../../.agents/notes/implemented/architecture/2026-07-06-timeout-deadline-library.md) 将边界划定为:共享时序/分类,将强制终止保留在本地。
它**不负责终止**。它发出的信号只会*通知*;真正停止工作仍由各能负责因为机制各不相同bash 对操作系统进程组发送 SIGKILLweb 关闭 `fetch` 套接字,没有任何共享层能够承担全部终止机制。[Agent Note](../../../.agents/notes/implemented/architecture/2026-07-06-timeout-deadline-library.md) 将边界划定为:共享时序/分类,将强制终止保留在本地。
它是**库,而非服务或插件**:没有 `ctx`,不注册任何内容,不持有状态,也不发出事件。「超时服务」必须了解如何停止每项能的工作,这正是微内核要排除在共享层之外的知识。
它是**库,而非服务或插件**:没有 `ctx`,不注册任何内容,不持有状态,也不发出事件。「超时服务」必须了解如何停止每项能的工作,这正是微内核要排除在共享层之外的知识。
## 对外接口
@@ -64,7 +64,7 @@ export async function runWithDeadline(upstream: AbortSignal | undefined, timeout
## 已知限制与暂缓事项
- **只发出通知**deadline 无法停止忽略其信号的工作;每项能仍需要自己的 socket/进程/任务终止路径。
- **只发出通知**deadline 无法停止忽略其信号的工作;每项能仍需要自己的 socket/进程/任务终止路径。
- **`timeoutMs <= 0` 是内部词汇**:只有在所属后端已解析策略后,它才会禁用本地 timer绝不会作为面向模型/插件的公开开关。
- **第一个中止原因决定分类**:当 upstream 取消早于本地 timer 发生时,即使自己的超时之后也会到期,该层也无法再报告。
- **空闲 watchdog 不是总 deadline**:它针对每个尚未完成的迭代器需求重新启动,并刻意排除消费方的处理时间。