docs(i18n): proofread README translations 121-140

packages/storage/README.zh.md

@@ -2,13 +2,13 @@
 
 [English](README.md) | 中文
 
-存储家族持久化会话事件日志之外的一切数据：命名后端与类型化数据形式在一个中心相接。设计记录：[领域 KV 存储 Agent Note](../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.zh.md)。
+存储家族持久化会话事件日志之外的一切数据：命名后端与类型化数据形式在一个中心相接。设计记录：[领域 KV 存储 Agent Note（agent 决策记录）](../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.zh.md)。
 
-| 包 | 职责 | ctx key |
+| 包（package） | 职责 | ctx key |
 |---|---|---|
-| `storage/` | 中心：命名后端注册表 + 可合并扩展的数据形式挂载、后端 facet 词汇、共享一致性测试套件 | `ctx.storage` |
+| `storage/` | 中心：命名后端注册表 + 可通过合并扩展的数据形式挂载、后端分面词汇、共享一致性测试套件 | `ctx.storage` |
 | `storage-json/` | JSON 后端：每个单元一个人类可读文件，以原子方式重写整个文件 | 注册后端 `json` |
 | `storage-sqlite/` | SQLite 后端：一个数据库承载所有已路由单元，每行一个文档 | 注册后端 `sqlite` |
 | `domain/` | 领域数据形式：经 zod 验证的记录、逐领域写入链、`domain/changed` 事件、按配置路由后端 | `ctx.storageDomain` + `ctx.storage.domain` |
 
-每个后端拥有一种介质，并公开数据形状 **facet**（目前为 `kv`；为未来的会话后端迁移预留 append-log facet）。每个后端插件都会在注册后发布内部生命周期服务；领域插件在公开自身服务前注入每个已配置的后端 key，因此配置树中的行序不携带启动语义。消费方绝不直接接触后端，而是注入 `storageDomain` 并通过它打开已声明的领域。
+每个后端拥有一种介质，并公开数据形状**分面**（目前为 `kv`；为未来的会话后端迁移预留追加日志分面）。每个后端插件都会在注册后发布内部生命周期服务；领域插件在公开自身服务前注入每个已配置的后端 key，因此配置树中的条目顺序不影响启动顺序。消费方绝不直接接触后端，而是注入 `storageDomain` 并通过它打开已声明的领域。

packages/storage/storage-domain/README.zh.md

@@ -2,15 +2,15 @@
 
 [English](README.md) | 中文
 
-DeepSeek Harness 存储中心的领域数据形式：在每个已配置后端注册后，公开可注入的 `ctx.storageDomain` 服务及对应的 `ctx.storage.domain` 投影。一个领域通过 `defineDomain`（zod 记录 schema、从 `z.infer` 派生的类型）声明一次，通过 `DomainFacility.open` 打开，并由具有最终决定权的内存状态提供服务：读取同步执行；写入在一条逐领域链上串行化，先在已路由后端达到持久状态，再更新内存并发出 `domain/changed`。打开消费方拥有 handle 的生命周期，并通过 `Domain.close()` 释放它（幂等；通常作为其自身的 `ctx.effect` disposer）；插件卸载时，facility 会关闭仍处于打开状态的领域。
+DeepSeek Harness 存储中心的领域数据形式：在所有已配置的后端注册后，公开可注入的 `ctx.storageDomain` 服务及对应的 `ctx.storage.domain` 投影。一个领域通过 `defineDomain`（zod 记录 schema、从 `z.infer` 派生的类型）声明一次，通过 `DomainFacility.open` 打开，并由具有最终决定权的内存状态提供服务：读取同步执行；写入在每个领域各自的一条链上串行化，先在已路由后端达到持久状态，再更新内存并发出 `domain/changed`。打开领域的消费方负责管理句柄的生命周期，并通过 `Domain.close()` 释放它（幂等；通常作为其自身的 `ctx.effect` 资源释放函数）；插件卸载时，该设施会关闭仍处于打开状态的领域。
 
-设计原理、打开语义和存储／领域分层见 [Agent Note](../../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.zh.md)。
+设计原理、打开语义和存储／领域分层见 [Agent Note（agent 决策记录）](../../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.zh.md)。
 
 ## 配置
 
 | key | 含义 |
 | --- | --- |
-| `backend` | 每个领域的默认后端名称（必填；不存在普遍正确的介质）。 |
+| `backend` | 每个领域的默认后端名称（必填；不存在普遍适用的存储介质）。 |
 | `routes` | 逐领域覆盖：领域名称 → 后端名称。 |
 
 ## 模型体验
@@ -19,7 +19,7 @@ DeepSeek Harness 存储中心的领域数据形式：在每个已配置后端注
 
 #### 模型看到的内容
 
-无。该包不注册工具、不注入提示词，也不追加会话事件；它在 `ctx.storageDomain` 后面存储非会话数据（Workspace 记录、未来的会话伴随元数据），只发出进程内 `domain/changed` 事件。只有消费方包通过自身已记录的表层渲染该事件时，它才会到达模型。
+无。该包（package）不注册工具、不注入提示词，也不追加会话事件；它在 `ctx.storageDomain` 后面存储非会话数据（工作区记录、未来的会话伴随数据），只发出进程内 `domain/changed` 事件。只有消费方包通过自身有文档说明的接口呈现该事件时，它才会到达模型。
 
 #### Token 影响
 
@@ -27,9 +27,9 @@ DeepSeek Harness 存储中心的领域数据形式：在每个已配置后端注
 
 #### KV Cache 影响
 
-相互独立：领域读写绝不触碰请求前缀，因此这里没有任何内容能使提供方 cache 复用失效。
+相互独立：领域读写绝不触碰请求前缀，因此这里没有任何内容能使提供方缓存复用失效。
 
 ## 已知限制与暂缓事项
 
-- **变更只在单进程内可见**：`domain/changed` 是进程内事件；在 Agent Note 暂缓的跨进程 revision 模式落地前，第二个主机进程或重新连接的 GUI 无法观察变更。
-- **没有跨表事务、二级索引或多 segment key**：每次写入只触碰一条记录；这些扩展的 trigger 和返工点列在 Agent Note 的暂缓工作清单中。
+- **变更只在单进程内可见**：`domain/changed` 是进程内事件；在 Agent Note 暂缓的跨进程修订模式落地前，第二个主机进程或重新连接的 GUI 无法观察变更。
+- **没有跨表事务、二级索引或多段键**：每次写入只触碰一条记录；这些扩展的触发点和返工点列在 Agent Note 的暂缓工作清单中。

packages/storage/storage-json/README.zh.md

@@ -2,13 +2,13 @@
 
 [English](README.md) | 中文
 
-[存储中心](../storage/README.md)的 JSON 后端：配置根目录下每个单元使用一个人类可读的 `<unit>.json` 文件，注册为后端 `json`。设计见[领域 KV 存储 Agent Note](../../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.zh.md)。
+[存储中心](../storage/README.md)的 JSON 后端：配置根目录下每个单元使用一个人类可读的 `<unit>.json` 文件，注册为后端 `json`。设计见[领域 KV 存储 Agent Note（agent 决策记录）](../../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.zh.md)。
 
 ## 模型
 
-- 内存中的单元状态具有最终决定权；每个写入原语都会通过临时写入 + fsync + 原子 `rename()` 替换重新发布整个文件。单元文件始终是完整的当前净状态：可读性是该后端存在的理由，规模问题则属于 SQLite 后端。
-- 缺失文件会作为空单元打开，并在第一次写入时物化。外部或无法解析的文件以 `malformed-medium` 拒绝；已存版本与 descriptor 不同时以 `version-mismatch` 拒绝（预发布立场，不迁移）。
-- 跨调用的写入顺序属于调用方（领域层的写入链）；每个单独调用具备原子性，并在 resolve 后持久。
+- 内存中的单元状态具有最终决定权；每个写入原语都会通过临时文件写入 + fsync + 原子 `rename()` 替换重新发布整个文件。单元文件始终是完整的当前状态：可读性是该后端存在的理由，规模问题则属于 SQLite 后端。
+- 缺失文件会作为空单元打开，并在第一次写入时物化。外来或无法解析的文件以 `malformed-medium` 拒绝；已存版本与描述符不同时以 `version-mismatch` 拒绝（预发布立场，不迁移）。
+- 跨调用的写入顺序属于调用方（领域层的写入链）；每次调用都具备原子性，并在完成时已达到持久状态。
 
 ## 配置
 
@@ -22,7 +22,7 @@
 
 #### 模型看到的内容
 
-无。该后端不贡献提示词、工具或 schema；它在 `ctx.storage` 后面持久化非会话领域数据，只供主机侧消费方使用。
+无。该后端不贡献提示词、工具或 schema；它在 `ctx.storage` 后面持久化非会话领域数据，只供宿主侧消费方使用。
 
 #### Token 影响
 
@@ -34,5 +34,5 @@
 
 ## 已知限制与暂缓事项
 
-- Windows 持久性依赖 libuv 的 `rename()`（使用替换的 `MoveFileExW`），没有显式 write-through 标志；append-log facet 落地时，计划把会话日志后端更严格的 Win32 write-through 发布辅助函数下移到此处（见 Agent Note 的迁移章节）。
-- 没有跨进程写锁：两个进程写入同一根目录时，可能交错执行整文件替换（最后写入者胜出）。当前消费方采用单主机进程部署；多进程方案按 Agent Note 的范围外表格暂缓。
+- Windows 持久性依赖 libuv 的 `rename()`（调用 `MoveFileExW` 并启用替换），没有显式 write-through 标志；追加日志分面 落地时，计划把会话日志后端更严格的 Win32 write-through 发布辅助函数下移到此处（见 Agent Note 的迁移章节）。
+- 没有跨进程写锁：两个进程写入同一根目录时，可能交错执行整文件替换（最后写入者胜出）。当前消费方采用单一宿主进程部署；多进程方案按 Agent Note 的范围外事项表暂缓。

packages/storage/storage-sqlite/README.zh.md

@@ -2,13 +2,13 @@
 
 [English](README.md) | 中文
 
-[存储中心](../storage/README.md)的 SQLite 后端：注册为后端 `sqlite`，通过一个数据库文件提供 `kv` facet；该文件使用 `node:sqlite`（也可以是 `:memory:`）。设计与取舍见[领域 KV 存储 Agent Note](../../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.zh.md)。
+[存储中心](../storage/README.md)的 SQLite 后端：注册为后端 `sqlite`，通过一个数据库文件提供 `kv` facet；该文件使用 `node:sqlite`（也可以是 `:memory:`）。设计与取舍见[领域 KV 存储 Agent Note（agent 决策记录）](../../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.zh.md)。
 
 ## 存储模型
 
-每行一个文档：每个单元表都会成为一个物理 STRICT 表 `"u_<unit>_<table>" (key TEXT PRIMARY KEY, value TEXT)`，其中 `value` 是记录的 JSON 文本，因此一个 key 只更新一行（高频变更领域路由到这里而非 JSON 后端的原因）。单元标识位于两个元数据表中：`units` 在单元首次打开时标记其格式版本，descriptor 不同时以 `version-mismatch` 拒绝；`unit_globals` 保存每个单元的全局 singleton 行。物理布局版本位于 `PRAGMA user_version`；其他任何标记值都会被拒绝（未发布格式，不迁移）。单元名和表名在进入 DDL 之前依据中心的 `UNIT_NAME_RE` 接受验证，因此不会把外部输入插值到 SQL 标识符中。
+每行一个文档：每个单元表都会成为一个物理 STRICT 表 `"u_<unit>_<table>" (key TEXT PRIMARY KEY, value TEXT)`，其中 `value` 是记录的 JSON 文本，因此一个 key 只更新一行（高频变更领域路由到这里而非 JSON 后端的原因）。单元标识位于两个元数据表中：`units` 在单元首次打开时标记其格式版本，描述符不同时以 `version-mismatch` 拒绝；`unit_globals` 保存每个单元的全局单例行。物理布局版本位于 `PRAGMA user_version`；其他任何标记值都会被拒绝（未发布格式，不迁移）。单元名和表名在进入 DDL 之前依据中心的 `UNIT_NAME_RE` 进行验证，因此不会把外部输入插值到 SQL 标识符中。
 
-每个写入原语都是一条 prepared statement：SQLite 的逐语句原子性无需显式事务即可满足 KV 契约，写入顺序仍由调用方负责（领域层写入链）。缺失目录和数据库文件会以仅 owner 可访问的权限创建（`0o700`／`0o600`），与 session-persistence SQLite 后端一致；在计划的介质层提取完成前，该包逐字复用了后者的打开顺序。
+每个写入原语都是一条预处理语句：SQLite 的逐语句原子性无需显式事务即可满足 KV 契约，写入顺序仍由调用方负责（领域层写入链）。缺失目录和数据库文件会以仅所有者可访问的权限创建（`0o700`／`0o600`），与 session-persistence SQLite 后端一致；在计划的介质层提取完成前，该包（package）逐字复用了后者的打开顺序。
 
 ## 配置（schemastery）
 
@@ -25,7 +25,7 @@ interface Config {
 
 #### 模型看到的内容
 
-无。该后端不贡献提示词、工具或 schema；它在 `ctx.storage` 后面持久化非会话领域数据（Workspace 记录、未来的会话伴随元数据），只供主机侧消费方使用。
+无。该后端不贡献提示词、工具或 schema；它在 `ctx.storage` 后面持久化非会话领域数据（工作区记录、未来的会话伴随元数据），只供主机侧消费方使用。
 
 #### Token 影响
 
@@ -37,7 +37,7 @@ interface Config {
 
 ## 已知限制与暂缓事项
 
-- **`DatabaseSync` 是同步的**：每次写入会在其持续时间内阻塞事件循环（一条语句）；在领域数据规模下可以接受。
-- **没有 busy-wait 或重试策略**：另一个连接持有写事务时，该操作会立即被拒绝；多进程写入保护列在设计的未来工作清单中。
+- **`DatabaseSync` 是同步的**：每次写入都会在单条语句执行期间阻塞事件循环；在领域数据规模下可以接受。
+- **没有忙等待或重试策略**：另一个连接持有写事务时，该操作会立即被拒绝；多进程写入保护列在设计文档的未来工作清单中。
 - **只打开当前的 `STORAGE_SQLITE_SCHEMA_VERSION`**：其他任何已标记版本都会被拒绝而不是迁移（预发布立场）。
 - **`openDatabase` 重复了 session-persistence SQLite 打开顺序**：提取到共享介质层的工作暂缓至计划的会话后端迁移（见 Agent Note 的复用审计）。

packages/storage/storage/README.zh.md

@@ -2,17 +2,17 @@
 
 [English](README.md) | 中文
 
-非会话数据的存储中心（`ctx.storage`）：命名后端注册表加已挂载的数据形式 facility。中心自身不执行 IO：后端拥有介质，数据形式拥有语义。设计与取舍见[领域 KV 存储 Agent Note](../../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.zh.md)。
+非会话数据的存储中心（`ctx.storage`）：命名后端注册表加已挂载的数据形式设施。中心自身不执行 IO：后端拥有介质，数据形式拥有语义。设计与取舍见[领域 KV 存储 Agent Note（agent 决策记录）](../../../.agents/notes/proposed/architecture/2026-07-24-domain-kv-storage-and-workspace.zh.md)。
 
-## 形状
+## 结构
 
-- `ctx.storage.backend`：名称 → 后端表。多个后端并排保持挂载（`json`、`sqlite`）；为消费方提供服务的后端由该消费方自身的配置决定（领域层的路由表），绝非中心的全局选择。`register()` 返回 disposer；重复名称和未知 lookup 会高声失败。
-- `ctx.storage.mount(form, facility)`／`ctx.storage.form(form)`：数据形式挂载。`StorageForms` 可合并扩展；领域层合并 `domain`，并通过 `ctx.storage.domain` 访问。
-- 后端拥有一种介质（文件树根、数据库文件），并公开可选的数据形状 **facet**：目前为 `kv`；为未来的会话后端迁移预留 append-log facet。`src/backend.ts` 是规范契约文本；`tests/contract.ts` 导出每个后端都会运行的共享一致性测试套件。
+- `ctx.storage.backend`：名称 → 后端表。多个后端并排保持挂载（`json`、`sqlite`）；为消费方提供服务的后端由该消费方自身的配置决定（领域层的路由表），绝非中心的全局选择。`register()` 返回资源释放函数；注册重复名称或查找未知名称时都会明确报错。
+- `ctx.storage.mount(form, facility)`／`ctx.storage.form(form)`：数据形式挂载。`StorageForms` 可通过合并扩展；领域层合并 `domain`，并通过 `ctx.storage.domain` 访问。
+- 后端拥有一种介质（文件树根、数据库文件），并公开可选的数据形状**分面**：目前为 `kv`；为未来的会话后端迁移预留追加日志分面。`src/backend.ts` 是规范契约文本；`tests/contract.ts` 导出每个后端都会运行的共享一致性测试套件。
 
 ## 该分组中的包
 
-| 包 | 职责 |
+| 包（package） | 职责 |
 | --- | --- |
 | `dsh-storage` | 中心服务 + 后端词汇 + 共享一致性测试套件 |
 | `dsh-storage-json` | JSON 后端：每个单元一个人类可读文件，以原子方式重写整个文件 |
@@ -29,13 +29,13 @@
 
 #### Token 影响
 
-每次请求的直接 token 为零。
+每次请求都不会直接增加 token。
 
 #### KV Cache 影响
 
-与实时请求相互独立：中心绝不触碰请求前缀，因此无法使提供方 cache 复用失效。
+与实时请求相互独立：中心绝不触碰请求前缀，因此无法使提供方缓存复用失效。
 
 ## 已知限制与暂缓事项
 
 - **`kv` 是唯一的数据形状**：设计记录为未来的会话后端迁移预留了 append-log facet，但尚未定义；后端目前恰好只有一个 facet 需要实现。
-- **形式惰性解析**：在领域插件挂载前读取 `ctx.storage.domain` 会抛出 `form-not-mounted`；组装会按相应顺序排列插件（错误配置会高声失败，而不是静默等待）。
+- **数据形式按需解析**：在领域插件挂载前读取 `ctx.storage.domain` 会抛出 `form-not-mounted`；组装会按相应顺序排列插件（错误配置会明确报错，而不是静默推迟处理）。