docs(i18n): standardize contract terminology

This commit is contained in:
xjt
2026-08-09 11:33:14 +08:00
parent 5d46c11784
commit a7af54a8d3
848 changed files with 1506 additions and 1506 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/web/web/README.md
README.md: 73765fe060cc0a2b0fa3d69703a670f488a29ac9
README.zh.md: 3cce0fb528457b566b2c2ab4ffd1f29471255c07
README.zh.md: bebdb52d6c9bd33db5a982c1f278e71c1882f2de

View File

@@ -2,7 +2,7 @@
[English](README.md) | 中文
**web 访问 seam**:抽象 `WebService``ctx.web`)定义 harness 具备哪些 web 访问能力(搜索 web、抓取 URL并通过多个提供方实现不把模型约绑定到某个厂商的 API 形状。
**web 访问 seam**:抽象 `WebService``ctx.web`)定义 harness 具备哪些 web 访问能力(搜索 web、抓取 URL并通过多个提供方实现不把模型约绑定到某个厂商的 API 形状。
该包是 web 能力中负责接口的三分之一。与 bash/fs 不同,它在一个 seam 上跨越搜索与抓取两种能力,每种能力都可能有多个提供方:
@@ -43,7 +43,7 @@
## 词汇
`WebSearchRequest``query``maxResults?`)→ `WebSearchResult``content?``sources[]``truncated`);每个 `WebSearchSource` 都有必填 `url` 与可选 `title``snippet``publishedAt`Perplexity 引用可能只含 URL`WebFetchRequest``url`)→ `WebFetchResult`(最终 `url``statusCode``body``truncated`);取消作为可选的直接 `AbortSignal` 参数传给 `search()``fetch()``WebFetchBody` 是这里拥有的封闭判别联合(`html` | `text`);消费方使用 `switch` 实现穷尽检查,因此新增类型会导致编译失败,直到处理完毕。完整约见 `src/types.ts`,其中也包含 `WebError` code 分类体系。
`WebSearchRequest``query``maxResults?`)→ `WebSearchResult``content?``sources[]``truncated`);每个 `WebSearchSource` 都有必填 `url` 与可选 `title``snippet``publishedAt`Perplexity 引用可能只含 URL`WebFetchRequest``url`)→ `WebFetchResult`(最终 `url``statusCode``body``truncated`);取消作为可选的直接 `AbortSignal` 参数传给 `search()``fetch()``WebFetchBody` 是这里拥有的封闭判别联合(`html` | `text`);消费方使用 `switch` 实现穷尽检查,因此新增类型会导致编译失败,直到处理完毕。完整约`src/types.ts`,其中也包含 `WebError` code 分类体系。
## 模型体验