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
+1 -1
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/spill/spill/README.md
README.md: c3434f90a8f7ab30baa6b237beab6dd9763f9bff
README.zh.md: 627097b6c481b593523de7ed7951605397724a1c
README.zh.md: fc80f8a5fee713a6cba1a5c8173c489bfc2c14d8
+1 -1
View File
@@ -24,7 +24,7 @@
## 词汇
`SaveTextSpill`owner、source、suggestedName、content)是请求;`SpillRef`locator、bytes、retrievalHint)是结果。`SpillLocator` 是[带品牌类型](../../util/brand)的值,并以不透明字符串的形式呈现给模型;对 `dsh-spill-local` 而言它是本地路径,但未来的后端可以返回 URI、键或命令 token,无需修改策略/工具消费方。`SpillOwner.sessionId` 是保存时存储命名空间:fork 后的会话会从种子日志继承现有定位信息,无需复制文件或更改其归属;fork 后新产生的 spill 使用子会话 id。`SpillSource`toolName、callId、label)是供后端命名和检查使用的描述性来源信息,而非访问控制信息。完整约见 `src/types.ts`
`SaveTextSpill`owner、source、suggestedName、content)是请求;`SpillRef`locator、bytes、retrievalHint)是结果。`SpillLocator` 是[带品牌类型](../../util/brand)的值,并以不透明字符串的形式呈现给模型;对 `dsh-spill-local` 而言它是本地路径,但未来的后端可以返回 URI、键或命令 token,无需修改策略/工具消费方。`SpillOwner.sessionId` 是保存时存储命名空间:fork 后的会话会从种子日志继承现有定位信息,无需复制文件或更改其归属;fork 后新产生的 spill 使用子会话 id。`SpillSource`toolName、callId、label)是供后端命名和检查使用的描述性来源信息,而非访问控制信息。完整约`src/types.ts`
设计原理见[工具输出 spill Agent Note](../../../.agents/notes/implemented/architecture/2026-07-08-tool-output-spill-files.md),其中说明了为什么创建操作应由运行时 spill seam 而非面向模型的 `write` 工具承担。