From de0348bd9e556ff7053a2746a05e8dbbf191b768 Mon Sep 17 00:00:00 2001 From: xjt Date: Wed, 29 Jul 2026 20:16:45 +0800 Subject: [PATCH] docs(i18n): standardize reviewed README headings --- packages/acp/acp/README.i18n.yaml | 2 +- packages/acp/acp/README.zh.md | 4 ++-- packages/bash/bash-local/README.i18n.yaml | 2 +- packages/bash/bash-local/README.zh.md | 2 +- packages/client/ui-skill/README.i18n.yaml | 2 +- packages/client/ui-skill/README.zh.md | 2 +- packages/client/ui-subagent/README.i18n.yaml | 2 +- packages/client/ui-subagent/README.zh.md | 2 +- .../code-runtime-worker/README.i18n.yaml | 2 +- .../code-runtime/code-runtime-worker/README.zh.md | 2 +- .../code-runtime/code-runtime/README.i18n.yaml | 2 +- packages/code-runtime/code-runtime/README.zh.md | 2 +- packages/core/agent-loop/README.i18n.yaml | 2 +- packages/core/agent-loop/README.zh.md | 8 ++++---- packages/core/agent/README.i18n.yaml | 2 +- packages/core/agent/README.zh.md | 4 ++-- packages/core/system-prompt/README.i18n.yaml | 2 +- packages/core/system-prompt/README.zh.md | 4 ++-- packages/core/tools/README.i18n.yaml | 2 +- packages/core/tools/README.zh.md | 8 ++++---- packages/examples/cli-demo/README.i18n.yaml | 2 +- packages/examples/cli-demo/README.zh.md | 2 +- packages/examples/tui-demo/README.i18n.yaml | 2 +- packages/examples/tui-demo/README.zh.md | 4 ++-- packages/goal/command-goal/README.i18n.yaml | 2 +- packages/goal/command-goal/README.zh.md | 2 +- packages/goal/goal-session/README.i18n.yaml | 2 +- packages/goal/goal-session/README.zh.md | 2 +- packages/goal/goal/README.i18n.yaml | 2 +- packages/goal/goal/README.zh.md | 2 +- packages/goal/tool-goal/README.i18n.yaml | 2 +- packages/goal/tool-goal/README.zh.md | 2 +- packages/guard/README.i18n.yaml | 2 +- packages/guard/README.zh.md | 2 +- packages/guard/repeat-tool-guard/README.i18n.yaml | 2 +- packages/guard/repeat-tool-guard/README.zh.md | 2 +- packages/sdk/create-sdk/README.i18n.yaml | 2 +- packages/sdk/create-sdk/README.zh.md | 2 +- packages/sdk/helper/README.i18n.yaml | 2 +- packages/sdk/helper/README.zh.md | 2 +- packages/sdk/scripts/README.i18n.yaml | 2 +- packages/sdk/scripts/README.zh.md | 2 +- packages/sdk/sdk-client/README.i18n.yaml | 2 +- packages/sdk/sdk-client/README.zh.md | 2 +- packages/sdk/sdk-protocol/README.i18n.yaml | 2 +- packages/sdk/sdk-protocol/README.zh.md | 2 +- packages/sdk/telemetry/README.i18n.yaml | 2 +- packages/sdk/telemetry/README.zh.md | 2 +- .../session-checkpoint-policy/README.i18n.yaml | 2 +- .../session-checkpoint-policy/README.zh.md | 4 ++-- .../session-persistence-jsonl/README.i18n.yaml | 2 +- .../session-persistence-jsonl/README.zh.md | 4 ++-- .../session-persistence-sqlite/README.i18n.yaml | 2 +- .../session-persistence-sqlite/README.zh.md | 4 ++-- .../session-query-sqlite/README.i18n.yaml | 2 +- .../session-query-sqlite/README.zh.md | 2 +- .../session-query/session-query/README.i18n.yaml | 2 +- packages/session-query/session-query/README.zh.md | 2 +- .../tool-session-query/README.i18n.yaml | 2 +- .../session-query/tool-session-query/README.zh.md | 14 +++++++------- .../README.i18n.yaml | 2 +- .../session-title-all-messages-llm/README.zh.md | 2 +- .../README.i18n.yaml | 2 +- .../session-title-first-message-llm/README.zh.md | 2 +- packages/skill/tool-skill/README.i18n.yaml | 2 +- packages/skill/tool-skill/README.zh.md | 8 ++++---- packages/spill/spill-policy/README.i18n.yaml | 2 +- packages/spill/spill-policy/README.zh.md | 2 +- packages/timeout/timeout-policy/README.i18n.yaml | 2 +- packages/timeout/timeout-policy/README.zh.md | 2 +- packages/todo/tool-todo/README.i18n.yaml | 2 +- packages/todo/tool-todo/README.zh.md | 4 ++-- packages/util/retention/README.i18n.yaml | 2 +- packages/util/retention/README.zh.md | 2 +- packages/util/timeout/README.i18n.yaml | 2 +- packages/util/timeout/README.zh.md | 2 +- packages/workspace/workspace/README.i18n.yaml | 2 +- packages/workspace/workspace/README.zh.md | 2 +- 78 files changed, 101 insertions(+), 101 deletions(-) diff --git a/packages/acp/acp/README.i18n.yaml b/packages/acp/acp/README.i18n.yaml index 3c399fb50e..d359613cd6 100644 --- a/packages/acp/acp/README.i18n.yaml +++ b/packages/acp/acp/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/acp/acp/README.md README.md: 1b188b994d17ce56e8d5df019ddef755338fcc88 -README.zh.md: 6df70034e9de8464510f6af8e013bf7d1bc1c568 +README.zh.md: c1e7d045b55119b62ad44d81071188e1ed6110d5 diff --git a/packages/acp/acp/README.zh.md b/packages/acp/acp/README.zh.md index 6df70034e9..c1e7d045b5 100644 --- a/packages/acp/acp/README.zh.md +++ b/packages/acp/acp/README.zh.md @@ -45,7 +45,7 @@ ### 提示词文本 -#### 模型所见内容 +#### 模型看到的内容 `session/prompt` 文本块会原样拼接为一条用户消息；基线资源链接会在该消息中表示为带方括号的 `[resource_link name=… uri=…]` 引用，模型可以使用自身工具打开它。协议元数据、客户端能力、权限选择和 session id 绝不进入模型请求。 @@ -59,7 +59,7 @@ ### 权限决策 -#### 模型所见内容 +#### 模型看到的内容 不会直接看到任何内容。所属工具通过常规工具结果路径记录其结果：允许、拒绝、取消或不可用。 diff --git a/packages/bash/bash-local/README.i18n.yaml b/packages/bash/bash-local/README.i18n.yaml index da4c6b6f9b..e72432de87 100644 --- a/packages/bash/bash-local/README.i18n.yaml +++ b/packages/bash/bash-local/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/bash/bash-local/README.md README.md: 694b7a7686ea6c38da5a354ff6b6e6d2c4520706 -README.zh.md: 16c8ca50a0fc1671ea07024f35b1234f6a4df49a +README.zh.md: c56543f26965effebaf020dd8d9d4ba130cd9b17 diff --git a/packages/bash/bash-local/README.zh.md b/packages/bash/bash-local/README.zh.md index 16c8ca50a0..c56543f269 100644 --- a/packages/bash/bash-local/README.zh.md +++ b/packages/bash/bash-local/README.zh.md @@ -2,7 +2,7 @@ [English](README.md) | 中文 -`@deepseek-ai/dsh-bash` 执行器 seam 的本地实现，构建在 [`@deepseek-ai/dsh-subprocess`](../../subprocess/subprocess/README.md) 服务之上：`LocalBashExecutor` 每次调用都通过 `ctx.subprocess` 把 `bash -c ` 作为受管进程组 spawn，并负责所有 Bash 层职责（命令默认值补全与上限、超时与取消分类、适合模型的终端环境，以及后台读取时面向模型的 stdout/stderr 合并）。进程组机制（以 spill 文件兜底的有界输出、凭据清除、kill 升级、dispose（资源释放））则由 subprocess 服务负责。 +`@deepseek-ai/dsh-bash` 执行器 seam 的本地实现，构建在 [`@deepseek-ai/dsh-subprocess`](../../subprocess/subprocess/README.md) 服务之上：`LocalBashExecutor` 每次调用都通过 `ctx.subprocess` 把 `bash -c ` 作为受管进程组 spawn，并负责所有 Bash 层职责（命令默认值补全与上限、超时与取消分类、适合模型的终端环境，以及后台读取时面向模型的 stdout/stderr 合并）。以 spill 文件兜底的有界输出、凭据清除、kill 升级和 dispose（资源释放）等进程组机制则由 subprocess 服务负责。 包根目录导出默认与具名的 `LocalBashExecutor` 插件及其 `Config`。 diff --git a/packages/client/ui-skill/README.i18n.yaml b/packages/client/ui-skill/README.i18n.yaml index 193a000511..3481eb7d7d 100644 --- a/packages/client/ui-skill/README.i18n.yaml +++ b/packages/client/ui-skill/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/client/ui-skill/README.md README.md: 4838be893c1d5422cc707cb0d7542a056be41fa7 -README.zh.md: 965682622f0f550f50832bb98d9ca512437fb14c +README.zh.md: ed582128246a62297f555f8abe09f427cb9d256a diff --git a/packages/client/ui-skill/README.zh.md b/packages/client/ui-skill/README.zh.md index 965682622f..ed58212824 100644 --- a/packages/client/ui-skill/README.zh.md +++ b/packages/client/ui-skill/README.zh.md @@ -12,7 +12,7 @@ skill（技能）引用 source 的浏览器端：把 `/` 触发的 `skill` sourc ### 用户提示词中的 skill 引用文本 -#### 模型所见 +#### 模型看到的内容 被 pick 的候选会把字面文本 `/name ` 落进草稿（决策 21：纯文本，无 `` 标签）；该文本原样进入普通用户消息（`session.prompt`）到达模型，没有专用内容块、提示词 section 或 host 侧展开。与实际 skill 的关联在模型侧建立且不确定：会话前缀已携带 skill 目录（由 `dsh-tool-skill` 渲染），引用名称与目录条目匹配，正是这一点引导模型去加载它。 diff --git a/packages/client/ui-subagent/README.i18n.yaml b/packages/client/ui-subagent/README.i18n.yaml index 27d1200a5a..39c7c6cd5b 100644 --- a/packages/client/ui-subagent/README.i18n.yaml +++ b/packages/client/ui-subagent/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/client/ui-subagent/README.md README.md: 7a70add139eae7bc507469b4fe7170359efdec31 -README.zh.md: d16bc1d90bff410fc7254856e16bdffe81a1703e +README.zh.md: 4ff79780fd33a47a0a45695ab9feda15cd1763cd diff --git a/packages/client/ui-subagent/README.zh.md b/packages/client/ui-subagent/README.zh.md index d16bc1d90b..4ff79780fd 100644 --- a/packages/client/ui-subagent/README.zh.md +++ b/packages/client/ui-subagent/README.zh.md @@ -12,7 +12,7 @@ subagent 引用 source 的浏览器半侧：把 `@` 触发的 `subagent` source ### 用户提示词中的 subagent label 文本 -#### 模型所见 +#### 模型看到的内容 被 pick 的候选会把字面文本 `@label`（子会话的显示标题）落进草稿；该文本原样进入普通用户消息（`session.prompt`）到达模型，没有专用内容块、提示词 section 或 host 侧解析。目前不存在任何消费语义：模型看到的是纯文本，只能自行解读。 diff --git a/packages/code-runtime/code-runtime-worker/README.i18n.yaml b/packages/code-runtime/code-runtime-worker/README.i18n.yaml index 58a9c6aa33..9a8eef9301 100644 --- a/packages/code-runtime/code-runtime-worker/README.i18n.yaml +++ b/packages/code-runtime/code-runtime-worker/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/code-runtime/code-runtime-worker/README.md README.md: 83c9a398970831e88cb3ef5d71d3f175da97d1f1 -README.zh.md: d6f56d509ffb01515d3970f2717ac4daa6fe2121 +README.zh.md: 3a4714fab55b85ffeb237d2a9fd0615ae4789bcf diff --git a/packages/code-runtime/code-runtime-worker/README.zh.md b/packages/code-runtime/code-runtime-worker/README.zh.md index d6f56d509f..3a4714fab5 100644 --- a/packages/code-runtime/code-runtime-worker/README.zh.md +++ b/packages/code-runtime/code-runtime-worker/README.zh.md @@ -44,7 +44,7 @@ SDK 对外提供默认及具名导出的 `WorkerCodeRuntime` 类，以及 `Confi 不会直接失效；由上述消费方负责请求前缀变更。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **程序派生的 OS 进程在程序终止后仍会存活**：`worker.terminate()` 只结束线程，比 bash-local 的进程组终止更弱；在容器后端出现前，孤儿进程清理属于部署职责。 - **类型剥离依赖 Node 的实验性 `stripTypeScriptTypes` API**：依赖的行为由单元测试固定；如其发生变化，amaro／sucrase 是已经点名的直接替代品。 diff --git a/packages/code-runtime/code-runtime/README.i18n.yaml b/packages/code-runtime/code-runtime/README.i18n.yaml index 950abb4418..4b5476220b 100644 --- a/packages/code-runtime/code-runtime/README.i18n.yaml +++ b/packages/code-runtime/code-runtime/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/code-runtime/code-runtime/README.md README.md: c7a2d519e47d160f5ab123bfc887e7e9f24ec602 -README.zh.md: 9cb22190bc5e42c16d3a59e7b9754355669c91bc +README.zh.md: 9103e7490e2fccb071cd8a234b224bc17514253e diff --git a/packages/code-runtime/code-runtime/README.zh.md b/packages/code-runtime/code-runtime/README.zh.md index 9cb22190bc..9103e7490e 100644 --- a/packages/code-runtime/code-runtime/README.zh.md +++ b/packages/code-runtime/code-runtime/README.zh.md @@ -28,7 +28,7 @@ 不会直接失效；由上述消费方负责请求前缀变更。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **`run()` 是一次性的**：`logs` 只有在 `CodeRunResult` resolve 后才能获得；seam 不提供正在运行的程序所产生输出的流式日志或进度接口。 - **持久 REPL 风格内核已记录为未来工作**：在持久内核后端带来自己的日志方案前，运行之间不保留状态的契约继续有效（参见 [Code Mode Agent Note](../../../.agents/notes/implemented/feature/2026-06-15-code-mode.md)）。 diff --git a/packages/core/agent-loop/README.i18n.yaml b/packages/core/agent-loop/README.i18n.yaml index d41dd01ec2..938f374862 100644 --- a/packages/core/agent-loop/README.i18n.yaml +++ b/packages/core/agent-loop/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/core/agent-loop/README.md README.md: 6bb8b12af69f54c2a75cd672e4d3802887808c76 -README.zh.md: d763f72ff1ac4520a49e6273d680aeab2bb4e0a5 +README.zh.md: 80a01f3e3fdddba8c243cad28c43072148af1dd9 diff --git a/packages/core/agent-loop/README.zh.md b/packages/core/agent-loop/README.zh.md index d763f72ff1..80a01f3e3f 100644 --- a/packages/core/agent-loop/README.zh.md +++ b/packages/core/agent-loop/README.zh.md @@ -84,7 +84,7 @@ interface Config { ### 完整对话请求 -#### 模型所见 +#### 模型看到的内容 每个步骤中，循环会发送针对该 agent 呈现的系统提示词、可见工具 schema 和会话派生消息。它提供 `provider`、`model` 与 `cwd` 变量值，但不添加固定文案。 @@ -98,7 +98,7 @@ interface Config { ### 保留的消息历史 -#### 模型所见 +#### 模型看到的内容 已接纳的 user 消息、assistant 消息、工具调用与结果、注入上下文和 steering 都会记录，并在后续步骤中发送。原始流分片、生命周期边界和其他仅写入日志的事件会被排除。 @@ -112,7 +112,7 @@ interface Config { ### 取消后未分发的调用 -#### 模型所见 +#### 模型看到的内容 如果后续请求回放一个中止的步骤，取消所阻止分发的每个工具调用都有错误码 `ABORTED_BEFORE_DISPATCH`，结果文本为 `Error: tool call aborted before dispatch`。 @@ -124,7 +124,7 @@ interface Config { 仅追加；每个合成结果都位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **分类是一元的**：安全性取决于比较同级调用或资源的调用必须保持独占（参见[设计原理](../../../.agents/notes/implemented/feature/2026-07-10-parallel-tool-call-execution.md)）。 - **配置 label 默认每次新建**：省略 `sessionId` 会在每次启动时创建全新的 `${id}-session-`；确切的恢复或创建行为要求显式提供稳定的 `sessionId`，而 `resumeSessionId` 要求已有持久化历史。 diff --git a/packages/core/agent/README.i18n.yaml b/packages/core/agent/README.i18n.yaml index 7125d8e239..c361cf499b 100644 --- a/packages/core/agent/README.i18n.yaml +++ b/packages/core/agent/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/core/agent/README.md README.md: 9ca79f28506b133a555bd7d1e984386c715fd9d6 -README.zh.md: 1c3862ef7729b34902bdac543b58dd541a59e5ab +README.zh.md: a32f75431a6d7ced64ae2f2171b6aa924d23de3e diff --git a/packages/core/agent/README.zh.md b/packages/core/agent/README.zh.md index 1c3862ef77..a32f75431a 100644 --- a/packages/core/agent/README.zh.md +++ b/packages/core/agent/README.zh.md @@ -81,7 +81,7 @@ Agent *创建* 由实现 `AgentFactory` 的插件（`dsh-agent-loop`）提供， ### 用户、steering 与注入消息 -#### 模型所见 +#### 模型看到的内容 `send`、`steer` 与 `inject` 会向所属会话提供输入。`agent/prompt-submit`、`agent/step` 和其他已声明事件让插件能够阻止提示词或添加持久请求材料；此接口本身不贡献固定文案。 @@ -95,7 +95,7 @@ Agent *创建* 由实现 `AgentFactory` 的插件（`dsh-agent-loop`）提供， ### Agent 作用域的请求组合 -#### 模型所见 +#### 模型看到的内容 通过 `agent.ctx` 进行的注册可以遮蔽提示词段或工具，也可以在未发布 setup 期间安装仅适用于该 agent 的拦截器。 diff --git a/packages/core/system-prompt/README.i18n.yaml b/packages/core/system-prompt/README.i18n.yaml index a0dde568b2..1d1430b228 100644 --- a/packages/core/system-prompt/README.i18n.yaml +++ b/packages/core/system-prompt/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/core/system-prompt/README.md README.md: 79badba0b84b27c01f25e9c31b5df78c556411ea -README.zh.md: cf0c2b950f7a0d9c3752952e850a845806bdfc40 +README.zh.md: fb3ed08bc9ea546033acac3b577980f500ce243d diff --git a/packages/core/system-prompt/README.zh.md b/packages/core/system-prompt/README.zh.md index cf0c2b950f..fb3ed08bc9 100644 --- a/packages/core/system-prompt/README.zh.md +++ b/packages/core/system-prompt/README.zh.md @@ -46,7 +46,7 @@ ### 系统提示词 -#### 模型所见 +#### 模型看到的内容 每次组装都从下方 harness 身份开始，然后在严格变量插值后追加已配置 persona 与有序插件段。空段会消失；带作用域的段和变量可以为一个 agent 遮蔽全局项。最终 `system-prompt/assemble` waterfall 结果是权威来源，因此专家监听器的变更决定交付的提示词与工具 schema。 @@ -66,7 +66,7 @@ You are an AI agent powered by the DeepSeek Harness SDK. ### 工具 schema -#### 模型所见 +#### 模型看到的内容 对于已交付工具，模型会收到[生成工具 schema](../../../docs/tool-catalog.md#tool-package-map) 中对每个 agent 可见的子集；限制与组装拦截完成后，按配置或字典序排列。扩展可以通过同一注册表贡献其他定义。段与 schema 提供方是独立的组装输入，因此工具限制不会移除独立注册的引导。 diff --git a/packages/core/tools/README.i18n.yaml b/packages/core/tools/README.i18n.yaml index 924a9137e4..429e76ed6a 100644 --- a/packages/core/tools/README.i18n.yaml +++ b/packages/core/tools/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/core/tools/README.md README.md: e5adb153e77d7a2d8c4068b016194ab6abb6473e -README.zh.md: fd78983b065dce00628405084095f0642e8e7a39 +README.zh.md: c67a2f2ee4ac2a9d587c6efbf2b5c60d14fc58c2 diff --git a/packages/core/tools/README.zh.md b/packages/core/tools/README.zh.md index fd78983b06..c67a2f2ee4 100644 --- a/packages/core/tools/README.zh.md +++ b/packages/core/tools/README.zh.md @@ -129,7 +129,7 @@ agent loop 将连续的 `parallel` 调用归入有界滚动池，并把每个 `e ### 普通工具 schema -#### 模型所见 +#### 模型看到的内容 在普通模式下，模型会看到每个可见定义的确切名称、描述和 JSON schema；已交付定义记录在生成的[工具包映射和 schema 章节](../../../docs/tool-catalog.md#tool-package-map)中。agent 作用域的限制、遮蔽和扩展注册会改变该 agent 的最终工具集合。 @@ -143,7 +143,7 @@ agent loop 将连续的 `parallel` 调用归入有界滚动池，并把每个 `e ### Code Mode schema 与系统提示词 -#### 模型所见 +#### 模型看到的内容 Code Mode 会公开生成的 [`run_code` schema](../../../docs/tool-catalog.md#deepseek-aidsh-tools)、下方 SDK 说明，以及生成的精确 `declare const tools` 块。`both` 会同时公开普通 schema 与此 Code Mode 接口。 @@ -172,7 +172,7 @@ The available tools: ### 工具调用历史与结果 -#### 模型所见 +#### 模型看到的内容 循环会保留模型发出的参数和注册表的最终内容。任何抛出或被拒绝的调用都会恰好变为 `Error: `。Code Mode 只返回外层程序打印的行和呈现后的返回值；两者都为空时返回 `(run_code completed with no output)`；失败时返回 `Error: code run failed (): `，并根据是否存在已捕获内容，在其后附加 `Captured output:` 与捕获的行。内部分发事件只保留在日志中；后置执行监听器可以在结果之后追加带来源归属的上下文。 @@ -184,7 +184,7 @@ The available tools: 仅追加；新的可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **并发策略不是事件 seam**：`executionMode()` 直接读取已解析的工具定义；插件只能在自身拥有的定义上声明分类器。 - **`tools/pre-execute` 有意不允许改写 `exec.arguments`**：否则日志记录和呈现的参数会与实际运行内容失去同步；改写设计记录在[拟议的 Agent Note](../../../.agents/notes/proposed/feature/2026-06-30-pre-tool-input-rewrite.md)中。 diff --git a/packages/examples/cli-demo/README.i18n.yaml b/packages/examples/cli-demo/README.i18n.yaml index e416200800..f73cad16df 100644 --- a/packages/examples/cli-demo/README.i18n.yaml +++ b/packages/examples/cli-demo/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/examples/cli-demo/README.md README.md: b8f2bde962738a1a23f0e57218ab0f90e8e0b705 -README.zh.md: f91e87517118afaaff8f2ca85f2bd4d12e6d6d16 +README.zh.md: 0e03375ced4e087d44eed7ff33666abf1f2cec10 diff --git a/packages/examples/cli-demo/README.zh.md b/packages/examples/cli-demo/README.zh.md index f91e875171..0e03375ced 100644 --- a/packages/examples/cli-demo/README.zh.md +++ b/packages/examples/cli-demo/README.zh.md @@ -59,7 +59,7 @@ headless-agent 叶节点提供本地 bash、文件系统、skill、subagent、 ### 单次任务轮次 -#### 模型所见 +#### 模型看到的内容 任务位置参数会成为一条用户消息。通过 `dsh-agent-spine-demo`，顶层 agent 还会收到已配置的工作区指令与 persona、skill 目录、可见工具 schema，以及同一轮次后续步骤所需的保留工具结果。 diff --git a/packages/examples/tui-demo/README.i18n.yaml b/packages/examples/tui-demo/README.i18n.yaml index a72f3c6487..a9815be3a3 100644 --- a/packages/examples/tui-demo/README.i18n.yaml +++ b/packages/examples/tui-demo/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/examples/tui-demo/README.md README.md: 058ebe87af5f041bd19fbfb205a97753ccacf6b9 -README.zh.md: 2309873b75355bc3cac5496ba95be2349886f8c4 +README.zh.md: 43681e9c77cbd77459ec0539b69e0ab73274d2c1 diff --git a/packages/examples/tui-demo/README.zh.md b/packages/examples/tui-demo/README.zh.md index 2309873b75..43681e9c77 100644 --- a/packages/examples/tui-demo/README.zh.md +++ b/packages/examples/tui-demo/README.zh.md @@ -78,7 +78,7 @@ ### 交互式终端轮次 -#### 模型所见 +#### 模型看到的内容 每次非空、非命令的编辑器提交都会成为用户消息；运行中轮次内的提交成为 steering（中途引导）。斜杠命令输入和输出仍只面向人类，而已接受的 `/goal` 变更会追加领域拥有的模型可见状态。共享主干提供已配置的 persona、workspace 指令、skill 目录、目标控制和可见工具 schema。TUI 渲染本身对模型不可见。 @@ -92,7 +92,7 @@ ### 人类问题答案 -#### 模型所见 +#### 模型看到的内容 `ask_user_question` 会保留工具调用，以及 `dsh-tool-ask-user` 定义的精简答案或稳定中断错误。问题 overlay 只在终端显示。 diff --git a/packages/goal/command-goal/README.i18n.yaml b/packages/goal/command-goal/README.i18n.yaml index 519496e950..5082633d83 100644 --- a/packages/goal/command-goal/README.i18n.yaml +++ b/packages/goal/command-goal/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/goal/command-goal/README.md README.md: 8e1a5b417467c8701ea935e25acfece11c5a70d4 -README.zh.md: b6eaa5e49596da529b253b84db3e09e234aef26b +README.zh.md: 66f237ac7ea8ef5d158917998b0dfd49189289f1 diff --git a/packages/goal/command-goal/README.zh.md b/packages/goal/command-goal/README.zh.md index b6eaa5e495..66f237ac7e 100644 --- a/packages/goal/command-goal/README.zh.md +++ b/packages/goal/command-goal/README.zh.md @@ -50,7 +50,7 @@ TUI 应用默认启用完整的持久 goal 栈和此命令。ACP（Agent Client 命令发现与直接输出不会影响缓存。变更会追加到可复用历史前缀之后；后续压缩可能替换派生历史后缀。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **仅纯文本交互**：通用命令注册表没有模态编辑表单或替换确认回调；内联 edit 与显式 clear 能在不同适配器中保持明确且一致的破坏性意图。 - **没有逐命令 Round 上限参数**：`defaultMaxGoalRounds` 仍是部署配置；用户直接请求时，可以要求模型通过另行授权的 goal 工具编辑 `max_goal_rounds`。 diff --git a/packages/goal/goal-session/README.i18n.yaml b/packages/goal/goal-session/README.i18n.yaml index 76927285ca..c0c9f24f89 100644 --- a/packages/goal/goal-session/README.i18n.yaml +++ b/packages/goal/goal-session/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/goal/goal-session/README.md README.md: 6a1c3b9455c93762c2458109c753588ce9a08d9a -README.zh.md: 45e5fb568953bf5b92ea51d89c965f8e1555d813 +README.zh.md: 4162411bf2dbeebbec8da6433c71e176057c4277 diff --git a/packages/goal/goal-session/README.zh.md b/packages/goal/goal-session/README.zh.md index 45e5fb5689..4162411bf2 100644 --- a/packages/goal/goal-session/README.zh.md +++ b/packages/goal/goal-session/README.zh.md @@ -64,7 +64,7 @@ 在一个 epoch 内仅追加：每个已准入 Round 都会在可复用前缀后扩展现有对话。压缩可能替换派生历史后缀，并移动可复用边界。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **没有独立评估器**：面向模型的 goal 策略会判断证据是否足以完成，以及 blocker 在语义上是否未变；评估器支持的认证仍保持暂缓。 - **只在同一会话执行**：此包（package）有意不 spawn 新 agent、不 fork 会话前缀，也不实现 Ralph 风格的独立尝试；该工作流属于单独的插件层。 diff --git a/packages/goal/goal/README.i18n.yaml b/packages/goal/goal/README.i18n.yaml index c037bc9046..1c724ef9c0 100644 --- a/packages/goal/goal/README.i18n.yaml +++ b/packages/goal/goal/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/goal/goal/README.md README.md: 45d7ac2e1c8fbd60ab2bc8b917b326d20da02ec1 -README.zh.md: dd6eb2169411c6b2f89b659317f0a6f0c9c5d55e +README.zh.md: b657d1d52f75657ba44b99306e4621aa82688e96 diff --git a/packages/goal/goal/README.zh.md b/packages/goal/goal/README.zh.md index dd6eb21694..b657d1d52f 100644 --- a/packages/goal/goal/README.zh.md +++ b/packages/goal/goal/README.zh.md @@ -49,7 +49,7 @@ 在一个 epoch 内仅追加：每项变更都位于可复用请求前缀和既有历史之后。压缩可能替换派生历史后缀，并移动可复用边界。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **只负责状态，不负责任务调度**：此包（package）不决定已启用续行的目标何时继续，不重试异常失败，也不取消活跃轮次；这些策略属于 agent seam 消费方。 - **只有 Round 数量预算**：`maxGoalRounds` 不计量 token、货币、挂钟时间或提供方配额。 diff --git a/packages/goal/tool-goal/README.i18n.yaml b/packages/goal/tool-goal/README.i18n.yaml index 4fce3342d4..3b9dd9f964 100644 --- a/packages/goal/tool-goal/README.i18n.yaml +++ b/packages/goal/tool-goal/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/goal/tool-goal/README.md README.md: aaed61dd517aeb2f94efa22c34c64d1068155d46 -README.zh.md: 047b783219c06cf097cbfdc9d49c4eda4eb744cc +README.zh.md: 5365b64ef65fb3d3f00e19357327479ebd8285a8 diff --git a/packages/goal/tool-goal/README.zh.md b/packages/goal/tool-goal/README.zh.md index 047b783219..5365b64ef6 100644 --- a/packages/goal/tool-goal/README.zh.md +++ b/packages/goal/tool-goal/README.zh.md @@ -71,7 +71,7 @@ Use goal tools for one long-running completion objective in the current session. schema 的定义与可见性不变时，前缀保持稳定。调用、结果和生成的 goal 快照会追加到可复用请求前缀之后，不会使更早条目失效。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **语义意图仍由模型判断**：执行只能证明人类直接来源，无法证明请求是否足够重大而值得创建 goal。 - **阻塞条件是否相同仍由模型判断**：运行时强制统计互不重复的已准入 Goal Round，而不判断障碍在语义上是否等价；独立评估器的实现暂缓。 diff --git a/packages/guard/README.i18n.yaml b/packages/guard/README.i18n.yaml index 2e18273829..c323a9b295 100644 --- a/packages/guard/README.i18n.yaml +++ b/packages/guard/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/guard/README.md README.md: b7375fd2bb12ae0cec94b13e6a1012c6f143bdad -README.zh.md: 381599b523a9f729be2ce4c7ad5b6577f234eb5d +README.zh.md: bba5c144d0663266e4327e388b9915cde176ce08 diff --git a/packages/guard/README.zh.md b/packages/guard/README.zh.md index 381599b523..bba5c144d0 100644 --- a/packages/guard/README.zh.md +++ b/packages/guard/README.zh.md @@ -6,6 +6,6 @@ | 包 | 职责 | ctx 键 | |---|---|---| -| `repeat-tool-guard/` | 当 agent 对完全相同的工具调用反复循环时给出提示 | （监听 `ctx.tools` 的 waterfall（瀑布式事件）） | +| `repeat-tool-guard/` | 当 agent 对完全相同的工具调用反复循环时给出提示 | （监听 `ctx.tools` 的 waterfall，即瀑布式事件） | 提示以 `additionalContexts` 形式附在 `tools/post-execute` 决策中传递；agent loop 会在该步骤的工具结果之后，将其追加为有日志记录、来源为插件的 `user/message` 事件（参见[工具包](../core/tools)）。因此，guard 告诉模型的所有内容都能从会话日志中重建。 diff --git a/packages/guard/repeat-tool-guard/README.i18n.yaml b/packages/guard/repeat-tool-guard/README.i18n.yaml index a0c2c44c62..4863dcd147 100644 --- a/packages/guard/repeat-tool-guard/README.i18n.yaml +++ b/packages/guard/repeat-tool-guard/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/guard/repeat-tool-guard/README.md README.md: 226dba10239031e8e79bd5698e77c213688ce579 -README.zh.md: 6338799bd832305af516aad769816a50836a0102 +README.zh.md: fd6e291d6fe9f286d3dc3f921518f596f3749e3e diff --git a/packages/guard/repeat-tool-guard/README.zh.md b/packages/guard/repeat-tool-guard/README.zh.md index 6338799bd8..fd6e291d6f 100644 --- a/packages/guard/repeat-tool-guard/README.zh.md +++ b/packages/guard/repeat-tool-guard/README.zh.md @@ -84,7 +84,7 @@ The repeated calls are not making progress. Do not call this tool with these exa 仅追加；新出现的内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **仅检测精确匹配**：规范化过程会对键进行深度排序，因此近似变体（稍作修改的路径、值内增加的空白）可以绕过链；在没有需求证据前，不采用模糊匹配。 - **压缩（compaction）不会重置链**：跨越压缩检查点的链会继续计数。 diff --git a/packages/sdk/create-sdk/README.i18n.yaml b/packages/sdk/create-sdk/README.i18n.yaml index 5a9dddd032..27609d9a11 100644 --- a/packages/sdk/create-sdk/README.i18n.yaml +++ b/packages/sdk/create-sdk/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/sdk/create-sdk/README.md README.md: aa09236832a50abdcd2b158e0561db26bce19cf6 -README.zh.md: fa4fc7c25614e96615116ac486569ea0b7eecfdd +README.zh.md: a4685e66bc3eb7924dd247a7b6b420f6bcc70990 diff --git a/packages/sdk/create-sdk/README.zh.md b/packages/sdk/create-sdk/README.zh.md index fa4fc7c256..a4685e66bc 100644 --- a/packages/sdk/create-sdk/README.zh.md +++ b/packages/sdk/create-sdk/README.zh.md @@ -20,6 +20,6 @@ 不会直接导致 KV Cache 失效；由具名消费方负责请求前缀变更。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **无头本地插件**：无头 spec 会提供项目答案和功能方案；目前还不能在 spec 中表达本地插件脚手架（交互式 none／plugin／tool 选择），默认使用 none。 diff --git a/packages/sdk/helper/README.i18n.yaml b/packages/sdk/helper/README.i18n.yaml index 73cc0748f2..8842e34d26 100644 --- a/packages/sdk/helper/README.i18n.yaml +++ b/packages/sdk/helper/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/sdk/helper/README.md README.md: 8c6ed9e87be0a97af67849793edb7fa30ffb33ab -README.zh.md: 81275d08670d56c95e1d224601545861768ea9fe +README.zh.md: e8844aab14dd0494144251de5e0a9f5cfcaf37be diff --git a/packages/sdk/helper/README.zh.md b/packages/sdk/helper/README.zh.md index 81275d0867..e8844aab14 100644 --- a/packages/sdk/helper/README.zh.md +++ b/packages/sdk/helper/README.zh.md @@ -24,6 +24,6 @@ 无；此包既不组装也不发送提供方请求。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **提交不具备跨文件事务性**：每次写入前都会检测外部修改，但后续失败不会回滚已经写入的文件。 diff --git a/packages/sdk/scripts/README.i18n.yaml b/packages/sdk/scripts/README.i18n.yaml index ac88dcc48e..b148eb76ab 100644 --- a/packages/sdk/scripts/README.i18n.yaml +++ b/packages/sdk/scripts/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/sdk/scripts/README.md README.md: 9a696bf5a4de9a80f0741f07a7e753733bc2f998 -README.zh.md: f209ef753bb63fd576d4579aadc28b5bee26e4a4 +README.zh.md: cf9fc2cbbe467eb86e89d9eb77e9bc34860b5a3a diff --git a/packages/sdk/scripts/README.zh.md b/packages/sdk/scripts/README.zh.md index f209ef753b..cf9fc2cbbe 100644 --- a/packages/sdk/scripts/README.zh.md +++ b/packages/sdk/scripts/README.zh.md @@ -32,6 +32,6 @@ 不会直接导致 KV Cache 失效；由具名消费方负责请求前缀变更。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **启动器参数没有 schema**：`start` 和 `dev` 会保留 Node `parseArgs()` 输出，而不会验证项目专用标志。 diff --git a/packages/sdk/sdk-client/README.i18n.yaml b/packages/sdk/sdk-client/README.i18n.yaml index 19895f1276..c0bf2706ff 100644 --- a/packages/sdk/sdk-client/README.i18n.yaml +++ b/packages/sdk/sdk-client/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/sdk/sdk-client/README.md README.md: 3ac4de540401f6f40dab3e84f7005f91d024aee8 -README.zh.md: 0f076c7cfbe75447ce997ce3ce4394dc67a60862 +README.zh.md: 95fb6b2887a7bc748a610f7fedae4be1aa2af623 diff --git a/packages/sdk/sdk-client/README.zh.md b/packages/sdk/sdk-client/README.zh.md index 0f076c7cfb..95fb6b2887 100644 --- a/packages/sdk/sdk-client/README.zh.md +++ b/packages/sdk/sdk-client/README.zh.md @@ -43,7 +43,7 @@ console.log(result.status, result.finalResponse) 无；本包既不组装也不发送提供方请求。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **无捆绑运行时解析**——调用方显式指定运行时可执行文件；打包可执行文件的发现留在 Python 侧，直到出现 TypeScript 发行版消费方。 - **无轮次中取消**——协议层没有提示词取消方法；放弃轮次意味着关闭运行时（见协议的 [已知限制](../sdk-protocol/README.md)）。 diff --git a/packages/sdk/sdk-protocol/README.i18n.yaml b/packages/sdk/sdk-protocol/README.i18n.yaml index b111645b0f..7eec4f64dd 100644 --- a/packages/sdk/sdk-protocol/README.i18n.yaml +++ b/packages/sdk/sdk-protocol/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/sdk/sdk-protocol/README.md README.md: 62b26d4a82d358fa4efcb7ab84036e5f4848057f -README.zh.md: 0af56e689035b1d95c589e62c9ee909aef295738 +README.zh.md: 11677c6119c7da407d95ee38ad9f8f7a552c15de diff --git a/packages/sdk/sdk-protocol/README.zh.md b/packages/sdk/sdk-protocol/README.zh.md index 0af56e6890..11677c6119 100644 --- a/packages/sdk/sdk-protocol/README.zh.md +++ b/packages/sdk/sdk-protocol/README.zh.md @@ -32,7 +32,7 @@ DeepSeek Harness SDK 运行时的共享协议格式（wire format）：一个按 无；此包既不组装也不发送提供方请求。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **无协议版本协商**——握手只携带 `serverInfo.version`（`0.0.1`，客户端不校验）；处于预发布阶段，无兼容承诺。 - **无取消与会话关闭方法**——客户端放弃轮次的方式是关闭运行时进程；见 [`dsh-jsonrpc` README](../../ui/jsonrpc/README.md)。 diff --git a/packages/sdk/telemetry/README.i18n.yaml b/packages/sdk/telemetry/README.i18n.yaml index 6c5465593e..b7bd3df0d5 100644 --- a/packages/sdk/telemetry/README.i18n.yaml +++ b/packages/sdk/telemetry/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/sdk/telemetry/README.md README.md: 1d33915f36e0af10eedac5f9ab34f2534268a327 -README.zh.md: 21f241f41f625c9f60773a8c8d49e567729ecc8f +README.zh.md: d71aa36be66a250056dd20a1ca9a88836b28c184 diff --git a/packages/sdk/telemetry/README.zh.md b/packages/sdk/telemetry/README.zh.md index 21f241f41f..d71aa36be6 100644 --- a/packages/sdk/telemetry/README.zh.md +++ b/packages/sdk/telemetry/README.zh.md @@ -24,7 +24,7 @@ Consent 由 `cordis.yml` 中的 telemetry 配置项承载，因此禁用 telemet 无；此包既不组装也不发送提供方请求。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **占位端点**：`DSH_TELEMETRY_ENDPOINT` 指向 `.invalid`，直到设置真实端点。 - **脱敏依赖启发式规则**：这只是保守后备，不是保证；密钥应存放于 `.env`，而该文件绝不会被读取或上报。 diff --git a/packages/session-persistence/session-checkpoint-policy/README.i18n.yaml b/packages/session-persistence/session-checkpoint-policy/README.i18n.yaml index c86263e81c..2ec207d786 100644 --- a/packages/session-persistence/session-checkpoint-policy/README.i18n.yaml +++ b/packages/session-persistence/session-checkpoint-policy/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/session-persistence/session-checkpoint-policy/README.md README.md: aba0f00a2960eca3db06dda267cc954f602c1b09 -README.zh.md: 96575d8596bb73bf920a04a4fe9e331e0d1d600b +README.zh.md: ae403302f86b9fadc964c7963d3a454dd14180d3 diff --git a/packages/session-persistence/session-checkpoint-policy/README.zh.md b/packages/session-persistence/session-checkpoint-policy/README.zh.md index 96575d8596..ae403302f8 100644 --- a/packages/session-persistence/session-checkpoint-policy/README.zh.md +++ b/packages/session-persistence/session-checkpoint-policy/README.zh.md @@ -26,7 +26,7 @@ ### 中断调用 -#### 模型所见 +#### 模型看到的内容 插件不添加提示词或工具 schema。工具检查点后、结果前的硬崩溃会留下持久的未匹配调用；会话恢复会提供模型可见的 `TOOL_OUTCOME_UNKNOWN` 结果，该结果由 `dsh-session` 负责。该消息允许重试只读或幂等工作，并要求对可能有副作用的调用验证状态或请求用户确认。 @@ -38,7 +38,7 @@ 修复结果追加在可重用前缀之后，因此不会使较早的缓存条目失效。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - 该策略以持久方式记录执行意图，而非为通用副作用提供恰好一次保证。当提供方支持时，有副作用的工具应将 `exec.callId` 作为幂等键转发。 - 流式 `assistant/chunk` 事件没有每分片检查点。它们在下一个语义检查点到达存储，因此硬崩溃可能丢失当前部分响应。 diff --git a/packages/session-persistence/session-persistence-jsonl/README.i18n.yaml b/packages/session-persistence/session-persistence-jsonl/README.i18n.yaml index 699d22c79c..5368aabeb3 100644 --- a/packages/session-persistence/session-persistence-jsonl/README.i18n.yaml +++ b/packages/session-persistence/session-persistence-jsonl/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/session-persistence/session-persistence-jsonl/README.md README.md: ab6ecd28f12bd167aeac789d1565705e167d60f4 -README.zh.md: 2e9d611cf8a73b3aec8e363dc2ff45c9d4827a85 +README.zh.md: 16e0afa98c08710d298aa1487ddd8e51e1dc55c9 diff --git a/packages/session-persistence/session-persistence-jsonl/README.zh.md b/packages/session-persistence/session-persistence-jsonl/README.zh.md index 2e9d611cf8..16e0afa98c 100644 --- a/packages/session-persistence/session-persistence-jsonl/README.zh.md +++ b/packages/session-persistence/session-persistence-jsonl/README.zh.md @@ -53,7 +53,7 @@ JSONL 持久会话存储后端：`SessionPersistence` 的一个具体实现（`d ### 恢复的对话历史 -#### 模型所见 +#### 模型看到的内容 JSONL 存储不影响当前提示词或 schema。加载会恢复已存储的呈现历史，并保留之前的请求 header 用于重建；新 loop 组合当前 envelope。恢复会用 `TOOL_NOT_STARTED` 平衡没有已持久化调用的 assistant 请求；已有已持久化调用但无结果时则变为 `TOOL_OUTCOME_UNKNOWN`，它要求模型只重试只读或幂等工作，并验证可能的副作用或询问用户。原始 `assistant/chunk` 记录不会重复生成消息。 @@ -65,7 +65,7 @@ JSONL 存储不影响当前提示词或 schema。加载会恢复已存储的呈 JSONL 存储不修改实时请求前缀。只有重建历史、当前 envelope 和模型路由匹配时，恢复 loop 才能重用提供方缓存；崩溃修复结果仅追加。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **只加载已配置编码和当前 `SESSION_FORMAT_VERSION` (v0)**：更改压缩需要独立/全新根，或选择遗留原始 mode；预发布格式没有迁移。 - **平铺文件存储布局不加载**：加载前使用独立根，或将预发布产物移入项目/会话目录布局。 diff --git a/packages/session-persistence/session-persistence-sqlite/README.i18n.yaml b/packages/session-persistence/session-persistence-sqlite/README.i18n.yaml index c51fd2250a..8dea06ca1f 100644 --- a/packages/session-persistence/session-persistence-sqlite/README.i18n.yaml +++ b/packages/session-persistence/session-persistence-sqlite/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/session-persistence/session-persistence-sqlite/README.md README.md: 394b10a70fc757d75f19178050c0d63699a59e54 -README.zh.md: 832b46a0c072daf8e922e170dae81b4512ccb8e9 +README.zh.md: 6d2a47aa64cee59c35c558e1923a112b0d72f58b diff --git a/packages/session-persistence/session-persistence-sqlite/README.zh.md b/packages/session-persistence/session-persistence-sqlite/README.zh.md index 832b46a0c0..6d2a47aa64 100644 --- a/packages/session-persistence/session-persistence-sqlite/README.zh.md +++ b/packages/session-persistence/session-persistence-sqlite/README.zh.md @@ -41,7 +41,7 @@ interface Config { ### 恢复的对话历史 -#### 模型所见 +#### 模型看到的内容 SQLite 存储不影响当前提示词或 schema。加载会恢复与 JSONL 相同的呈现历史，并保留之前的 header 用于重建；新 loop 组合当前 envelope。恢复会用 `TOOL_NOT_STARTED` 平衡没有已持久化调用的 assistant 请求；已有已持久化调用但无结果时则变为 `TOOL_OUTCOME_UNKNOWN`，它要求模型只重试只读或幂等工作，并验证可能的副作用或询问用户。行元数据和原始分片不会成为消息。 @@ -53,7 +53,7 @@ SQLite 存储不影响当前提示词或 schema。加载会恢复与 JSONL 相 SQLite 存储不修改当前请求前缀。只有重建历史、当前 envelope 和模型路由匹配时，恢复 loop 才能重用提供方缓存；崩溃修复结果会追加到末尾。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **`DatabaseSync` 是同步的**：每个 append 事务在整个期间阻塞事件循环；对本地存储可接受，对繁忙多会话服务器是吞吐上限。 - **写入争用无等待或重试策略**：后端不设置 busy timeout，也不重试 locked-database 错误，因此其他连接持有写事务时操作立即拒绝。 diff --git a/packages/session-query/session-query-sqlite/README.i18n.yaml b/packages/session-query/session-query-sqlite/README.i18n.yaml index 31c8614aa4..ce6efd6cfc 100644 --- a/packages/session-query/session-query-sqlite/README.i18n.yaml +++ b/packages/session-query/session-query-sqlite/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/session-query/session-query-sqlite/README.md README.md: ceffb3ac25bc8b5252d6cc40cd6389839dfce1e2 -README.zh.md: 2824e26dab13f73ad0d3d893a2d3554992f8fb93 +README.zh.md: 33afe99c3e065e231692e162549aef8e28e542e3 diff --git a/packages/session-query/session-query-sqlite/README.zh.md b/packages/session-query/session-query-sqlite/README.zh.md index 2824e26dab..33afe99c3e 100644 --- a/packages/session-query/session-query-sqlite/README.zh.md +++ b/packages/session-query/session-query-sqlite/README.zh.md @@ -42,7 +42,7 @@ 无。该可信搜索后端只向调用方返回命中，不注册面向模型的提示词、schema、工具或消息。 -#### KV 缓存影响 +#### KV Cache 影响 无；该包既不组装也不发送提供方请求。 diff --git a/packages/session-query/session-query/README.i18n.yaml b/packages/session-query/session-query/README.i18n.yaml index 97911e34f4..3a122bbf43 100644 --- a/packages/session-query/session-query/README.i18n.yaml +++ b/packages/session-query/session-query/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/session-query/session-query/README.md README.md: ebc577975f874a1a60c84061f9148282742bfdf2 -README.zh.md: 64bc21880d44dfb2b03757d79cf24c3ee6d79218 +README.zh.md: df504e8ae5172fa783769a6fa39830c446688e29 diff --git a/packages/session-query/session-query/README.zh.md b/packages/session-query/session-query/README.zh.md index 64bc21880d..df504e8ae5 100644 --- a/packages/session-query/session-query/README.zh.md +++ b/packages/session-query/session-query/README.zh.md @@ -50,7 +50,7 @@ 无；该包既不组装也不发送提供方请求。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - **无调用方授权**：这是上下文范围内的可信基础设施；未来的模型工具或 UI 必须限制调用方可检查的会话。 - **无注册表或面向模型工具**：尚未提供提取器和搜索提供方注册表、递归事件来源遍历以及面向模型的工具。[跟踪决策](../../../.agents/notes/implemented/feature/2026-07-13-session-query-tracing.md) 负责关系语义；SQLite 归属和 tokenizer 决策位于[已实现搜索记录](../../../.agents/notes/implemented/feature/2026-07-10-sqlite-session-query-provider.md)。 diff --git a/packages/session-query/tool-session-query/README.i18n.yaml b/packages/session-query/tool-session-query/README.i18n.yaml index 6ca382ba08..e86449af9c 100644 --- a/packages/session-query/tool-session-query/README.i18n.yaml +++ b/packages/session-query/tool-session-query/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/session-query/tool-session-query/README.md README.md: d973daf1124c4be05f7335b18661d431d45be39f -README.zh.md: 1f5037c0474423cd1d4b5323e53316940c270baa +README.zh.md: b27d79a905a029d3750f24573e3c32785a314015 diff --git a/packages/session-query/tool-session-query/README.zh.md b/packages/session-query/tool-session-query/README.zh.md index 1f5037c047..b27d79a905 100644 --- a/packages/session-query/tool-session-query/README.zh.md +++ b/packages/session-query/tool-session-query/README.zh.md @@ -23,7 +23,7 @@ ### 系统提示词 -#### 模型所见 +#### 模型看到的内容 模型会收到一个固定的既往历史指引章节。 @@ -37,13 +37,13 @@ Use session_search to find relevant work from prior sessions, or session_event_s 插件挂载期间，每次请求都存在一个固定精简章节。 -#### KV 缓存影响 +#### KV Cache 影响 插件和指引文本不变时，前缀稳定。 ### 工具 schema -#### 模型所见 +#### 模型看到的内容 模型会看到生成的 [`session_search`、`session_event_search`、`session_trace`、`session_event_trace` 和 `session_event_read` schema](../../../docs/tool-catalog.md#deepseek-aidsh-tool-session-query)。搜索过滤器会增加固定 schema token，而游标、工作区路径、输出分页和模型可控结果上限仍不存在。 @@ -51,13 +51,13 @@ Use session_search to find relevant work from prior sessions, or session_event_s 可见期间，每次请求都会发送 5 个固定只读 schema。 -#### KV 缓存影响 +#### KV Cache 影响 工具可见性和定义不变时，前缀稳定。 ### 工具结果 -#### 模型所见 +#### 模型看到的内容 每次成功调用都会发出一个纯文本块。搜索结果包含标题和最佳匹配摘录；跟踪包含全部已授权关系；事件读取包含未经删节的目标 JSON。通用 spill 策略可以将过大的内联文本替换为预览、不透明定位信息和取回指引。 @@ -65,11 +65,11 @@ Use session_search to find relevant work from prior sessions, or session_event_s 结果取决于数据，并保留在已记录工具历史中直到压缩（compaction）；`maxSearchResults` 限制搜索命中数。 -#### KV 缓存影响 +#### KV Cache 影响 仅追加的结果文本位于可重用请求前缀之后，不会使较早的缓存条目失效。 -## 已知限制与待完成工作 +## 已知限制与暂缓事项 - 搜索最多返回部署上限，匹配更多时会请模型缩小查询；不提供延续 token。 - 工作区身份使用保守的字符串精确 `cwd` 相等性，因此符号链接等价的路径不共享权限。 diff --git a/packages/session-title/session-title-all-messages-llm/README.i18n.yaml b/packages/session-title/session-title-all-messages-llm/README.i18n.yaml index 35f9ed8dd5..54909b457e 100644 --- a/packages/session-title/session-title-all-messages-llm/README.i18n.yaml +++ b/packages/session-title/session-title-all-messages-llm/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/session-title/session-title-all-messages-llm/README.md README.md: 25ec92432b5c2d18624f2f4d851552ee2b3bf5d0 -README.zh.md: fac40f1a5d1432dd07badc786408cda561b45cd0 +README.zh.md: 947aa614741b2b0bd50e70f1d273a625a5624cc6 diff --git a/packages/session-title/session-title-all-messages-llm/README.zh.md b/packages/session-title/session-title-all-messages-llm/README.zh.md index fac40f1a5d..947aa61474 100644 --- a/packages/session-title/session-title-all-messages-llm/README.zh.md +++ b/packages/session-title/session-title-all-messages-llm/README.zh.md @@ -22,7 +22,7 @@ 不会使主请求的 KV Cache 失效。每条提示词后，辅助输入都会增长或变化，因此提供方专用缓存复用会在第一个变化的 JSON token 处结束。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - 输入溢出时保留先前标题；对于很长的会话，此提供方没有基于摘要继续生成摘要的机制或保留策略。 - 它平等对待所有符合条件的用户消息，不提供权重、过滤或手动标题优先级。 diff --git a/packages/session-title/session-title-first-message-llm/README.i18n.yaml b/packages/session-title/session-title-first-message-llm/README.i18n.yaml index 03faf16a73..1353b0b4e6 100644 --- a/packages/session-title/session-title-first-message-llm/README.i18n.yaml +++ b/packages/session-title/session-title-first-message-llm/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/session-title/session-title-first-message-llm/README.md README.md: c24d4de1fa945d11b5a868cad88a94ed14ad3891 -README.zh.md: d332f83800ad601be2184568c2341d4d36806a85 +README.zh.md: 1f864b16c473654d0a52716cddbe26fe087860dc diff --git a/packages/session-title/session-title-first-message-llm/README.zh.md b/packages/session-title/session-title-first-message-llm/README.zh.md index d332f83800..1f864b16c4 100644 --- a/packages/session-title/session-title-first-message-llm/README.zh.md +++ b/packages/session-title/session-title-first-message-llm/README.zh.md @@ -22,7 +22,7 @@ 不会使主请求的 KV Cache 失效。辅助请求使用已配置或已记录路由，其缓存行为由提供方决定。 -## 已知限制与暂缓工作 +## 已知限制与暂缓事项 - 对于长期会话，第一条消息可能不再具有代表性；如果后续提示词应触发重新生成标题，请使用全消息提供方。 - fork 会保留继承的标题，绝不会自动运行此提供方，即使其预置的首消息来自父会话。 diff --git a/packages/skill/tool-skill/README.i18n.yaml b/packages/skill/tool-skill/README.i18n.yaml index 142ff54cbe..6cb393022f 100644 --- a/packages/skill/tool-skill/README.i18n.yaml +++ b/packages/skill/tool-skill/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/skill/tool-skill/README.md README.md: 6b0af04a15bfda985be3e04868f18b9af702eae7 -README.zh.md: 6c7d5e55cbfd4b8914fc3f65ec9a7c15bf672356 +README.zh.md: b2f073491a7c6d3c1cb0d6020d619ae725fed305 diff --git a/packages/skill/tool-skill/README.zh.md b/packages/skill/tool-skill/README.zh.md index 6c7d5e55cb..b2f073491a 100644 --- a/packages/skill/tool-skill/README.zh.md +++ b/packages/skill/tool-skill/README.zh.md @@ -30,7 +30,7 @@ ### 会话目录 -#### 模型所见 +#### 模型看到的内容 如果存在模型可调用 skill，且可见的正是这个 `skill` 工具，agent 会收到下方目录模板，其中包含每个已排序 skill 的一条随数据而定的条目。该目录是一条持久的用户角色消息。 @@ -58,7 +58,7 @@ If the user names a skill, or the task clearly matches a skill's description, ca ### 工具 schema -#### 模型所见 +#### 模型看到的内容 模型会看到生成的 [`skill` schema](../../../docs/tool-catalog.md#deepseek-aidsh-tool-skill)。 @@ -72,7 +72,7 @@ If the user names a skill, or the task clearly matches a skill's description, ca ### 工具结果 -#### 模型所见 +#### 模型看到的内容 成功调用使用下方结果模板，以及提供方管理的资源指引、目录资源指引、URL 资源指引或不透明资源指引。 @@ -128,7 +128,7 @@ Load referenced resources only as needed. ### 工具错误 -#### 模型所见 +#### 模型看到的内容 无效或陈旧选择会精确返回 `Error: invalid skill name ""`、`Error: skill "" is unknown or no longer available` 或 `Error: skill "" is not available for model invocation`。提供方抛出的查找文本取决于数据，并接收同一个 `Error: ` 包装层。 diff --git a/packages/spill/spill-policy/README.i18n.yaml b/packages/spill/spill-policy/README.i18n.yaml index b0df18745d..8d4746fc4c 100644 --- a/packages/spill/spill-policy/README.i18n.yaml +++ b/packages/spill/spill-policy/README.i18n.yaml @@ -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-policy/README.md README.md: 7638f62c0426964d83d7a635ebf73d0f117abd78 -README.zh.md: 52fa9946f221efa92e74e983f67753af560109b5 +README.zh.md: 522a0dafba621a808bc9e8c007b01274edf11dd3 diff --git a/packages/spill/spill-policy/README.zh.md b/packages/spill/spill-policy/README.zh.md index 52fa9946f2..522a0dafba 100644 --- a/packages/spill/spill-policy/README.zh.md +++ b/packages/spill/spill-policy/README.zh.md @@ -40,7 +40,7 @@ ### 过大的纯文本结果 -#### 模型所见 +#### 模型看到的内容 大小不超过 `maxInlineBytes` 的结果、嵌套结果、`read` 结果、被阻止的决策和包含非文本块的结果都保持不变。过大的纯文本呈现结果会变为有界的首尾预览，后面附加 `(Omitted bytes. Full formatted result stored at: . )`；存储失败或没有会话所有者时，原始结果仍然可见。 diff --git a/packages/timeout/timeout-policy/README.i18n.yaml b/packages/timeout/timeout-policy/README.i18n.yaml index 4db58cd589..94509e3669 100644 --- a/packages/timeout/timeout-policy/README.i18n.yaml +++ b/packages/timeout/timeout-policy/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/timeout/timeout-policy/README.md README.md: 3e5769e2f8b95392e9d489659c6bae634ab3ff18 -README.zh.md: a00719334974abe731a233582ad76948692c7e5d +README.zh.md: 8d69e7d4aacb70beb5eaaa63c74a0759e0038ec5 diff --git a/packages/timeout/timeout-policy/README.zh.md b/packages/timeout/timeout-policy/README.zh.md index a007193349..8d69e7d4aa 100644 --- a/packages/timeout/timeout-policy/README.zh.md +++ b/packages/timeout/timeout-policy/README.zh.md @@ -39,7 +39,7 @@ ### 条件工具结果 -#### 模型所见内容 +#### 模型看到的内容 此插件不添加提示词或 schema。如果已声明的截止时间先到，它会将提供方结果替换为 `Error: tool call timed out after ms` 与结构化 `TOOL_TIMEOUT`；否则原结果保持不变。 diff --git a/packages/todo/tool-todo/README.i18n.yaml b/packages/todo/tool-todo/README.i18n.yaml index 8640052f88..603d2cfef0 100644 --- a/packages/todo/tool-todo/README.i18n.yaml +++ b/packages/todo/tool-todo/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/todo/tool-todo/README.md README.md: b05ef43e7137dcf5678b1f1ad6d8c00b8a43baef -README.zh.md: 672af2bf60c7b34554957ffd43197389596840e8 +README.zh.md: 88a9f5d69ff52dcedbd8f27a4ace5fde3e0dc5a2 diff --git a/packages/todo/tool-todo/README.zh.md b/packages/todo/tool-todo/README.zh.md index 672af2bf60..88a9f5d69f 100644 --- a/packages/todo/tool-todo/README.zh.md +++ b/packages/todo/tool-todo/README.zh.md @@ -34,7 +34,7 @@ ### 工具 schema -#### 模型所见内容 +#### 模型看到的内容 模型会看到生成的 [`todo_write` schema](../../../docs/tool-catalog.md#deepseek-aidsh-tool-todo)。 @@ -48,7 +48,7 @@ ### 工具调用历史与结果 -#### 模型所见内容 +#### 模型看到的内容 每个 assistant 工具调用都会在参数中保留整个替换列表。成功时原样返回 `Updated todo list: pending, in progress, completed.`。稳定失败文本为 ``Error: invalid todo: `content` must be a non-empty string``、`Error: invalid todos: duplicate content ""`、`Error: invalid todos: at most one task may be in_progress, got ` 和 `Error: todo_write requires an owning agent session`。完整 `todo/write` 会话事件是 UI 与回放状态，而非第二条模型消息。 diff --git a/packages/util/retention/README.i18n.yaml b/packages/util/retention/README.i18n.yaml index 57464000d9..dc9529004b 100644 --- a/packages/util/retention/README.i18n.yaml +++ b/packages/util/retention/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/util/retention/README.md README.md: d257075a67b35e92bce53a88fc6d002f4f4d5d9b -README.zh.md: 73023d83d1ac04e1bfdd63c1aea4021e739562c4 +README.zh.md: c97c1d5afe504c54851f35b86d7bb893b32bcea4 diff --git a/packages/util/retention/README.zh.md b/packages/util/retention/README.zh.md index 73023d83d1..c97c1d5afe 100644 --- a/packages/util/retention/README.zh.md +++ b/packages/util/retention/README.zh.md @@ -87,7 +87,7 @@ const footer = formatRetentionNotice( 通过渲染保留内容和省略元数据的工具消费方间接影响模型。 -#### KV 缓存影响 +#### KV Cache 影响 不会直接导致 KV Cache 失效；请求前缀变更由上述消费方负责。 diff --git a/packages/util/timeout/README.i18n.yaml b/packages/util/timeout/README.i18n.yaml index ebcd926918..0436cc4d34 100644 --- a/packages/util/timeout/README.i18n.yaml +++ b/packages/util/timeout/README.i18n.yaml @@ -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: 11c55a45a1255e14fb551e42ba3965453dbd94ae -README.zh.md: af1bfd9a215aa219d9fde1cec7cfee9a3dd2e55b +README.zh.md: 8b63f00595139f9af2e9a31e8ab3c3494088e0ff diff --git a/packages/util/timeout/README.zh.md b/packages/util/timeout/README.zh.md index af1bfd9a21..8b63f00595 100644 --- a/packages/util/timeout/README.zh.md +++ b/packages/util/timeout/README.zh.md @@ -58,7 +58,7 @@ export async function runWithDeadline(upstream: AbortSignal | undefined, timeout 通过 `dsh-timeout-policy` 等消费方间接影响模型；消费方可能会将提供方结果替换为已保留的超时错误，或抑制延迟结果。 -#### KV 缓存影响 +#### KV Cache 影响 不会直接导致 KV Cache 失效；请求前缀变更由上述消费方负责。 diff --git a/packages/workspace/workspace/README.i18n.yaml b/packages/workspace/workspace/README.i18n.yaml index d3fd54be45..a24e81d977 100644 --- a/packages/workspace/workspace/README.i18n.yaml +++ b/packages/workspace/workspace/README.i18n.yaml @@ -3,4 +3,4 @@ # after editing either side, bring the other along and re-record with: # pnpm run verify-translation-pairing --write packages/workspace/workspace/README.md README.md: bee3e4fcb5dded273f30942ee2e42ee93b839e62 -README.zh.md: 64041929046cdf109bdab0dd4c2f792b4622cf83 +README.zh.md: 9a052f796fb7cc8756999bdc9b2ce905805730ab diff --git a/packages/workspace/workspace/README.zh.md b/packages/workspace/workspace/README.zh.md index 6404192904..9a052f796f 100644 --- a/packages/workspace/workspace/README.zh.md +++ b/packages/workspace/workspace/README.zh.md @@ -24,7 +24,7 @@ DeepSeek Harness 的 Workspace 实体注册表（`ctx.workspace`）：通过领 ### Workspace 记录与会话记账 -#### 模型所见内容 +#### 模型看到的内容 没有。`ctx.workspace` 只向宿主侧消费方提供 workspace 记录：此包不注册工具、不注入提示词、不写入会话事件，因此没有请求字段会携带此包数据。