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/sandbox/sandbox/README.md
README.md: 8c1c747f6c7178f9c8c1a9827675ffa98f29aa6d
README.zh.md: 1e9ecee967bfc3621d6fb441f405e84896fa7863
README.zh.md: abc5d387384e3a69e35496d6ce4bc9830185c55d

View File

@@ -2,7 +2,7 @@
[English](README.md) | 中文
抽象进程沙箱 seam。负责定义 `ctx.sandbox` 服务约([`SandboxProvider`](src/index.ts))与 harness 共享的限制词汇:`SandboxMode``read-only``workspace-write``danger-full-access`,仅限文件操作)、`SandboxEnforcement``full``partial`,针对每种内核 ABI`SandboxExecutionPolicy`(每次调用的完整模式及工作区根目录)、`SandboxPolicy`(其中受限制的子集),以及故障时拒绝放行的 `SANDBOX_UNAVAILABLE` 错误。它是[能力 seam 拆分](../../../.agents/notes/implemented/architecture/2026-06-13-capability-seams.md)的接口包:只依赖 cordis及 harness 错误基类),绝不依赖后端。
抽象进程沙箱 seam。负责定义 `ctx.sandbox` 服务约[`SandboxProvider`](src/index.ts))与 harness 共享的限制词汇:`SandboxMode``read-only``workspace-write``danger-full-access`,仅限文件操作)、`SandboxEnforcement``full``partial`,针对每种内核 ABI`SandboxExecutionPolicy`(每次调用的完整模式及工作区根目录)、`SandboxPolicy`(其中受限制的子集),以及故障时拒绝放行的 `SANDBOX_UNAVAILABLE` 错误。它是[能力 seam 拆分](../../../.agents/notes/implemented/architecture/2026-06-13-capability-seams.md)的接口包:只依赖 cordis及 harness 错误基类),绝不依赖后端。
用一句话概括约定:`ctx.sandbox.confine(argv, policy)` 返回用于 spawn、应当取代调用方原始 argv 的 argv。返回值经过包装使进程及其派生的所有进程都在限制下运行还会附带所选后端达到的强制执行完整度、拒绝方言`denialSignatures`)和结构化 runner 失败证据(`runnerFailureRules`)。没有可用后端时,它会抛出异常,绝不会原样传递 argv 使其不受限制地运行。[核心类型目录](../../../docs/subsystems/sandbox.md#wrapped-argv-and-classification-dialects)负责定义分类器的精确结构。