docs(i18n): standardize reviewed README headings

This commit is contained in:
xjt
2026-07-29 20:16:45 +08:00
parent e1481e2d98
commit de0348bd9e
78 changed files with 101 additions and 101 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/acp/acp/README.md
README.md: 1b188b994d17ce56e8d5df019ddef755338fcc88
README.zh.md: 6df70034e9de8464510f6af8e013bf7d1bc1c568
README.zh.md: c1e7d045b55119b62ad44d81071188e1ed6110d5

View File

@@ -45,7 +45,7 @@
### 提示词文本
#### 模型所见内容
#### 模型看到的内容
`session/prompt` 文本块会原样拼接为一条用户消息;基线资源链接会在该消息中表示为带方括号的 `[resource_link name=… uri=…]` 引用,模型可以使用自身工具打开它。协议元数据、客户端能力、权限选择和 session id 绝不进入模型请求。
@@ -59,7 +59,7 @@
### 权限决策
#### 模型所见内容
#### 模型看到的内容
不会直接看到任何内容。所属工具通过常规工具结果路径记录其结果:允许、拒绝、取消或不可用。

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/bash/bash-local/README.md
README.md: 694b7a7686ea6c38da5a354ff6b6e6d2c4520706
README.zh.md: 16c8ca50a0fc1671ea07024f35b1234f6a4df49a
README.zh.md: c56543f26965effebaf020dd8d9d4ba130cd9b17

View File

@@ -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 <command>` 作为受管进程组 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 <command>` 作为受管进程组 spawn并负责所有 Bash 层职责(命令默认值补全与上限、超时与取消分类、适合模型的终端环境,以及后台读取时面向模型的 stdout/stderr 合并)。以 spill 文件兜底的有界输出、凭据清除、kill 升级dispose资源释放等进程组机制则由 subprocess 服务负责。
包根目录导出默认与具名的 `LocalBashExecutor` 插件及其 `Config`

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/client/ui-skill/README.md
README.md: 4838be893c1d5422cc707cb0d7542a056be41fa7
README.zh.md: 965682622f0f550f50832bb98d9ca512437fb14c
README.zh.md: ed582128246a62297f555f8abe09f427cb9d256a

View File

@@ -12,7 +12,7 @@ skill技能引用 source 的浏览器端:把 `/` 触发的 `skill` sourc
### 用户提示词中的 skill 引用文本
#### 模型所见
#### 模型看到的内容
被 pick 的候选会把字面文本 `/name ` 落进草稿(决策 21纯文本`<skill>` 标签);该文本原样进入普通用户消息(`session.prompt`)到达模型,没有专用内容块、提示词 section 或 host 侧展开。与实际 skill 的关联在模型侧建立且不确定:会话前缀已携带 skill 目录(由 `dsh-tool-skill` 渲染),引用名称与目录条目匹配,正是这一点引导模型去加载它。

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/client/ui-subagent/README.md
README.md: 7a70add139eae7bc507469b4fe7170359efdec31
README.zh.md: d16bc1d90bff410fc7254856e16bdffe81a1703e
README.zh.md: 4ff79780fd33a47a0a45695ab9feda15cd1763cd

View File

@@ -12,7 +12,7 @@ subagent 引用 source 的浏览器半侧:把 `@` 触发的 `subagent` source
### 用户提示词中的 subagent label 文本
#### 模型所见
#### 模型看到的内容
被 pick 的候选会把字面文本 `@label`(子会话的显示标题)落进草稿;该文本原样进入普通用户消息(`session.prompt`)到达模型,没有专用内容块、提示词 section 或 host 侧解析。目前不存在任何消费语义:模型看到的是纯文本,只能自行解读。

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/code-runtime/code-runtime-worker/README.md
README.md: 83c9a398970831e88cb3ef5d71d3f175da97d1f1
README.zh.md: d6f56d509ffb01515d3970f2717ac4daa6fe2121
README.zh.md: 3a4714fab55b85ffeb237d2a9fd0615ae4789bcf

View File

@@ -44,7 +44,7 @@ SDK 对外提供默认及具名导出的 `WorkerCodeRuntime` 类,以及 `Confi
不会直接失效;由上述消费方负责请求前缀变更。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **程序派生的 OS 进程在程序终止后仍会存活**`worker.terminate()` 只结束线程,比 bash-local 的进程组终止更弱;在容器后端出现前,孤儿进程清理属于部署职责。
- **类型剥离依赖 Node 的实验性 `stripTypeScriptTypes` API**依赖的行为由单元测试固定如其发生变化amarosucrase 是已经点名的直接替代品。

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/code-runtime/code-runtime/README.md
README.md: c7a2d519e47d160f5ab123bfc887e7e9f24ec602
README.zh.md: 9cb22190bc5e42c16d3a59e7b9754355669c91bc
README.zh.md: 9103e7490e2fccb071cd8a234b224bc17514253e

View File

@@ -28,7 +28,7 @@
不会直接失效;由上述消费方负责请求前缀变更。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **`run()` 是一次性的**`logs` 只有在 `CodeRunResult` resolve 后才能获得seam 不提供正在运行的程序所产生输出的流式日志或进度接口。
- **持久 REPL 风格内核已记录为未来工作**:在持久内核后端带来自己的日志方案前,运行之间不保留状态的契约继续有效(参见 [Code Mode Agent Note](../../../.agents/notes/implemented/feature/2026-06-15-code-mode.md))。

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/core/agent-loop/README.md
README.md: 6bb8b12af69f54c2a75cd672e4d3802887808c76
README.zh.md: d763f72ff1ac4520a49e6273d680aeab2bb4e0a5
README.zh.md: 80a01f3e3fdddba8c243cad28c43072148af1dd9

View File

@@ -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-<uuid>`;确切的恢复或创建行为要求显式提供稳定的 `sessionId`,而 `resumeSessionId` 要求已有持久化历史。

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/core/agent/README.md
README.md: 9ca79f28506b133a555bd7d1e984386c715fd9d6
README.zh.md: 1c3862ef7729b34902bdac543b58dd541a59e5ab
README.zh.md: a32f75431a6d7ced64ae2f2171b6aa924d23de3e

View File

@@ -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 的拦截器。

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/core/system-prompt/README.md
README.md: 79badba0b84b27c01f25e9c31b5df78c556411ea
README.zh.md: cf0c2b950f7a0d9c3752952e850a845806bdfc40
README.zh.md: fb3ed08bc9ea546033acac3b577980f500ce243d

View File

@@ -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 提供方是独立的组装输入,因此工具限制不会移除独立注册的引导。

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/core/tools/README.md
README.md: e5adb153e77d7a2d8c4068b016194ab6abb6473e
README.zh.md: fd78983b065dce00628405084095f0642e8e7a39
README.zh.md: c67a2f2ee4ac2a9d587c6efbf2b5c60d14fc58c2

View File

@@ -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: <message>`。Code Mode 只返回外层程序打印的行和呈现后的返回值;两者都为空时返回 `(run_code completed with no output)`;失败时返回 `Error: code run failed (<kind>): <message>`,并根据是否存在已捕获内容,在其后附加 `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)中。

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/examples/cli-demo/README.md
README.md: b8f2bde962738a1a23f0e57218ab0f90e8e0b705
README.zh.md: f91e87517118afaaff8f2ca85f2bd4d12e6d6d16
README.zh.md: 0e03375ced4e087d44eed7ff33666abf1f2cec10

View File

@@ -59,7 +59,7 @@ headless-agent 叶节点提供本地 bash、文件系统、skill、subagent、
### 单次任务轮次
#### 模型所见
#### 模型看到的内容
任务位置参数会成为一条用户消息。通过 `dsh-agent-spine-demo`,顶层 agent 还会收到已配置的工作区指令与 persona、skill 目录、可见工具 schema以及同一轮次后续步骤所需的保留工具结果。

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/examples/tui-demo/README.md
README.md: 058ebe87af5f041bd19fbfb205a97753ccacf6b9
README.zh.md: 2309873b75355bc3cac5496ba95be2349886f8c4
README.zh.md: 43681e9c77cbd77459ec0539b69e0ab73274d2c1

View File

@@ -78,7 +78,7 @@
### 交互式终端轮次
#### 模型所见
#### 模型看到的内容
每次非空、非命令的编辑器提交都会成为用户消息;运行中轮次内的提交成为 steering中途引导。斜杠命令输入和输出仍只面向人类而已接受的 `/goal` 变更会追加领域拥有的模型可见状态。共享主干提供已配置的 persona、workspace 指令、skill 目录、目标控制和可见工具 schema。TUI 渲染本身对模型不可见。
@@ -92,7 +92,7 @@
### 人类问题答案
#### 模型所见
#### 模型看到的内容
`ask_user_question` 会保留工具调用,以及 `dsh-tool-ask-user` 定义的精简答案或稳定中断错误。问题 overlay 只在终端显示。

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/goal/command-goal/README.md
README.md: 8e1a5b417467c8701ea935e25acfece11c5a70d4
README.zh.md: b6eaa5e49596da529b253b84db3e09e234aef26b
README.zh.md: 66f237ac7ea8ef5d158917998b0dfd49189289f1

View File

@@ -50,7 +50,7 @@ TUI 应用默认启用完整的持久 goal 栈和此命令。ACPAgent Client
命令发现与直接输出不会影响缓存。变更会追加到可复用历史前缀之后;后续压缩可能替换派生历史后缀。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **仅纯文本交互**:通用命令注册表没有模态编辑表单或替换确认回调;内联 edit 与显式 clear 能在不同适配器中保持明确且一致的破坏性意图。
- **没有逐命令 Round 上限参数**`defaultMaxGoalRounds` 仍是部署配置;用户直接请求时,可以要求模型通过另行授权的 goal 工具编辑 `max_goal_rounds`

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/goal/goal-session/README.md
README.md: 6a1c3b9455c93762c2458109c753588ce9a08d9a
README.zh.md: 45e5fb568953bf5b92ea51d89c965f8e1555d813
README.zh.md: 4162411bf2dbeebbec8da6433c71e176057c4277

View File

@@ -64,7 +64,7 @@
在一个 epoch 内仅追加:每个已准入 Round 都会在可复用前缀后扩展现有对话。压缩可能替换派生历史后缀,并移动可复用边界。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **没有独立评估器**:面向模型的 goal 策略会判断证据是否足以完成,以及 blocker 在语义上是否未变;评估器支持的认证仍保持暂缓。
- **只在同一会话执行**此包package有意不 spawn 新 agent、不 fork 会话前缀,也不实现 Ralph 风格的独立尝试;该工作流属于单独的插件层。

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/goal/goal/README.md
README.md: 45d7ac2e1c8fbd60ab2bc8b917b326d20da02ec1
README.zh.md: dd6eb2169411c6b2f89b659317f0a6f0c9c5d55e
README.zh.md: b657d1d52f75657ba44b99306e4621aa82688e96

View File

@@ -49,7 +49,7 @@
在一个 epoch 内仅追加:每项变更都位于可复用请求前缀和既有历史之后。压缩可能替换派生历史后缀,并移动可复用边界。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **只负责状态,不负责任务调度**此包package不决定已启用续行的目标何时继续不重试异常失败也不取消活跃轮次这些策略属于 agent seam 消费方。
- **只有 Round 数量预算**`maxGoalRounds` 不计量 token、货币、挂钟时间或提供方配额。

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/goal/tool-goal/README.md
README.md: aaed61dd517aeb2f94efa22c34c64d1068155d46
README.zh.md: 047b783219c06cf097cbfdc9d49c4eda4eb744cc
README.zh.md: 5365b64ef65fb3d3f00e19357327479ebd8285a8

View File

@@ -71,7 +71,7 @@ Use goal tools for one long-running completion objective in the current session.
schema 的定义与可见性不变时,前缀保持稳定。调用、结果和生成的 goal 快照会追加到可复用请求前缀之后,不会使更早条目失效。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **语义意图仍由模型判断**:执行只能证明人类直接来源,无法证明请求是否足够重大而值得创建 goal。
- **阻塞条件是否相同仍由模型判断**:运行时强制统计互不重复的已准入 Goal Round而不判断障碍在语义上是否等价独立评估器的实现暂缓。

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/guard/README.md
README.md: b7375fd2bb12ae0cec94b13e6a1012c6f143bdad
README.zh.md: 381599b523a9f729be2ce4c7ad5b6577f234eb5d
README.zh.md: bba5c144d0663266e4327e388b9915cde176ce08

View File

@@ -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 告诉模型的所有内容都能从会话日志中重建。

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/guard/repeat-tool-guard/README.md
README.md: 226dba10239031e8e79bd5698e77c213688ce579
README.zh.md: 6338799bd832305af516aad769816a50836a0102
README.zh.md: fd6e291d6fe9f286d3dc3f921518f596f3749e3e

View File

@@ -84,7 +84,7 @@ The repeated calls are not making progress. Do not call this tool with these exa
仅追加;新出现的内容位于可复用请求前缀之后,不会使现有 KV-cache 条目失效。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **仅检测精确匹配**:规范化过程会对键进行深度排序,因此近似变体(稍作修改的路径、值内增加的空白)可以绕过链;在没有需求证据前,不采用模糊匹配。
- **压缩compaction不会重置链**:跨越压缩检查点的链会继续计数。

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/sdk/create-sdk/README.md
README.md: aa09236832a50abdcd2b158e0561db26bce19cf6
README.zh.md: fa4fc7c25614e96615116ac486569ea0b7eecfdd
README.zh.md: a4685e66bc3eb7924dd247a7b6b420f6bcc70990

View File

@@ -20,6 +20,6 @@
不会直接导致 KV Cache 失效;由具名消费方负责请求前缀变更。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **无头本地插件**:无头 spec 会提供项目答案和功能方案;目前还不能在 spec 中表达本地插件脚手架(交互式 noneplugintool 选择),默认使用 none。

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/sdk/helper/README.md
README.md: 8c6ed9e87be0a97af67849793edb7fa30ffb33ab
README.zh.md: 81275d08670d56c95e1d224601545861768ea9fe
README.zh.md: e8844aab14dd0494144251de5e0a9f5cfcaf37be

View File

@@ -24,6 +24,6 @@
无;此包既不组装也不发送提供方请求。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **提交不具备跨文件事务性**:每次写入前都会检测外部修改,但后续失败不会回滚已经写入的文件。

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/sdk/scripts/README.md
README.md: 9a696bf5a4de9a80f0741f07a7e753733bc2f998
README.zh.md: f209ef753bb63fd576d4579aadc28b5bee26e4a4
README.zh.md: cf9fc2cbbe467eb86e89d9eb77e9bc34860b5a3a

View File

@@ -32,6 +32,6 @@
不会直接导致 KV Cache 失效;由具名消费方负责请求前缀变更。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **启动器参数没有 schema**`start``dev` 会保留 Node `parseArgs()` 输出,而不会验证项目专用标志。

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/sdk/sdk-client/README.md
README.md: 3ac4de540401f6f40dab3e84f7005f91d024aee8
README.zh.md: 0f076c7cfbe75447ce997ce3ce4394dc67a60862
README.zh.md: 95fb6b2887a7bc748a610f7fedae4be1aa2af623

View File

@@ -43,7 +43,7 @@ console.log(result.status, result.finalResponse)
无;本包既不组装也不发送提供方请求。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **无捆绑运行时解析**——调用方显式指定运行时可执行文件;打包可执行文件的发现留在 Python 侧,直到出现 TypeScript 发行版消费方。
- **无轮次中取消**——协议层没有提示词取消方法;放弃轮次意味着关闭运行时(见协议的 [已知限制](../sdk-protocol/README.md))。

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/sdk/sdk-protocol/README.md
README.md: 62b26d4a82d358fa4efcb7ab84036e5f4848057f
README.zh.md: 0af56e689035b1d95c589e62c9ee909aef295738
README.zh.md: 11677c6119c7da407d95ee38ad9f8f7a552c15de

View File

@@ -32,7 +32,7 @@ DeepSeek Harness SDK 运行时的共享协议格式wire format一个按
无;此包既不组装也不发送提供方请求。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **无协议版本协商**——握手只携带 `serverInfo.version``0.0.1`,客户端不校验);处于预发布阶段,无兼容承诺。
- **无取消与会话关闭方法**——客户端放弃轮次的方式是关闭运行时进程;见 [`dsh-jsonrpc` README](../../ui/jsonrpc/README.md)。

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/sdk/telemetry/README.md
README.md: 1d33915f36e0af10eedac5f9ab34f2534268a327
README.zh.md: 21f241f41f625c9f60773a8c8d49e567729ecc8f
README.zh.md: d71aa36be66a250056dd20a1ca9a88836b28c184

View File

@@ -24,7 +24,7 @@ Consent 由 `cordis.yml` 中的 telemetry 配置项承载,因此禁用 telemet
无;此包既不组装也不发送提供方请求。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- **占位端点**`DSH_TELEMETRY_ENDPOINT` 指向 `.invalid`,直到设置真实端点。
- **脱敏依赖启发式规则**:这只是保守后备,不是保证;密钥应存放于 `.env`,而该文件绝不会被读取或上报。

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/session-persistence/session-checkpoint-policy/README.md
README.md: aba0f00a2960eca3db06dda267cc954f602c1b09
README.zh.md: 96575d8596bb73bf920a04a4fe9e331e0d1d600b
README.zh.md: ae403302f86b9fadc964c7963d3a454dd14180d3

View File

@@ -26,7 +26,7 @@
### 中断调用
#### 模型所见
#### 模型看到的内容
插件不添加提示词或工具 schema。工具检查点后、结果前的硬崩溃会留下持久的未匹配调用会话恢复会提供模型可见的 `TOOL_OUTCOME_UNKNOWN` 结果,该结果由 `dsh-session` 负责。该消息允许重试只读或幂等工作,并要求对可能有副作用的调用验证状态或请求用户确认。
@@ -38,7 +38,7 @@
修复结果追加在可重用前缀之后,因此不会使较早的缓存条目失效。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- 该策略以持久方式记录执行意图,而非为通用副作用提供恰好一次保证。当提供方支持时,有副作用的工具应将 `exec.callId` 作为幂等键转发。
- 流式 `assistant/chunk` 事件没有每分片检查点。它们在下一个语义检查点到达存储,因此硬崩溃可能丢失当前部分响应。

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/session-persistence/session-persistence-jsonl/README.md
README.md: ab6ecd28f12bd167aeac789d1565705e167d60f4
README.zh.md: 2e9d611cf8a73b3aec8e363dc2ff45c9d4827a85
README.zh.md: 16e0afa98c08710d298aa1487ddd8e51e1dc55c9

View File

@@ -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预发布格式没有迁移。
- **平铺文件存储布局不加载**:加载前使用独立根,或将预发布产物移入项目/会话目录布局。

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/session-persistence/session-persistence-sqlite/README.md
README.md: 394b10a70fc757d75f19178050c0d63699a59e54
README.zh.md: 832b46a0c072daf8e922e170dae81b4512ccb8e9
README.zh.md: 6d2a47aa64cee59c35c558e1923a112b0d72f58b

View File

@@ -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 错误,因此其他连接持有写事务时操作立即拒绝。

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/session-query/session-query-sqlite/README.md
README.md: ceffb3ac25bc8b5252d6cc40cd6389839dfce1e2
README.zh.md: 2824e26dab13f73ad0d3d893a2d3554992f8fb93
README.zh.md: 33afe99c3e065e231692e162549aef8e28e542e3

View File

@@ -42,7 +42,7 @@
无。该可信搜索后端只向调用方返回命中不注册面向模型的提示词、schema、工具或消息。
#### KV 缓存影响
#### KV Cache 影响
无;该包既不组装也不发送提供方请求。

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/session-query/session-query/README.md
README.md: ebc577975f874a1a60c84061f9148282742bfdf2
README.zh.md: 64bc21880d44dfb2b03757d79cf24c3ee6d79218
README.zh.md: df504e8ae5172fa783769a6fa39830c446688e29

View File

@@ -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)。

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/session-query/tool-session-query/README.md
README.md: d973daf1124c4be05f7335b18661d431d45be39f
README.zh.md: 1f5037c0474423cd1d4b5323e53316940c270baa
README.zh.md: b27d79a905a029d3750f24573e3c32785a314015

View File

@@ -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` 相等性,因此符号链接等价的路径不共享权限。

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/session-title/session-title-all-messages-llm/README.md
README.md: 25ec92432b5c2d18624f2f4d851552ee2b3bf5d0
README.zh.md: fac40f1a5d1432dd07badc786408cda561b45cd0
README.zh.md: 947aa614741b2b0bd50e70f1d273a625a5624cc6

View File

@@ -22,7 +22,7 @@
不会使主请求的 KV Cache 失效。每条提示词后,辅助输入都会增长或变化,因此提供方专用缓存复用会在第一个变化的 JSON token 处结束。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- 输入溢出时保留先前标题;对于很长的会话,此提供方没有基于摘要继续生成摘要的机制或保留策略。
- 它平等对待所有符合条件的用户消息,不提供权重、过滤或手动标题优先级。

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/session-title/session-title-first-message-llm/README.md
README.md: c24d4de1fa945d11b5a868cad88a94ed14ad3891
README.zh.md: d332f83800ad601be2184568c2341d4d36806a85
README.zh.md: 1f864b16c473654d0a52716cddbe26fe087860dc

View File

@@ -22,7 +22,7 @@
不会使主请求的 KV Cache 失效。辅助请求使用已配置或已记录路由,其缓存行为由提供方决定。
## 已知限制与暂缓工作
## 已知限制与暂缓事项
- 对于长期会话,第一条消息可能不再具有代表性;如果后续提示词应触发重新生成标题,请使用全消息提供方。
- fork 会保留继承的标题,绝不会自动运行此提供方,即使其预置的首消息来自父会话。

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/skill/tool-skill/README.md
README.md: 6b0af04a15bfda985be3e04868f18b9af702eae7
README.zh.md: 6c7d5e55cbfd4b8914fc3f65ec9a7c15bf672356
README.zh.md: b2f073491a7c6d3c1cb0d6020d619ae725fed305

View File

@@ -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 "<name>"``Error: skill "<name>" is unknown or no longer available``Error: skill "<name>" is not available for model invocation`。提供方抛出的查找文本取决于数据,并接收同一个 `Error: <message>` 包装层。

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-policy/README.md
README.md: 7638f62c0426964d83d7a635ebf73d0f117abd78
README.zh.md: 52fa9946f221efa92e74e983f67753af560109b5
README.zh.md: 522a0dafba621a808bc9e8c007b01274edf11dd3

View File

@@ -40,7 +40,7 @@
### 过大的纯文本结果
#### 模型所见
#### 模型看到的内容
大小不超过 `maxInlineBytes` 的结果、嵌套结果、`read` 结果、被阻止的决策和包含非文本块的结果都保持不变。过大的纯文本呈现结果会变为有界的首尾预览,后面附加 `(Omitted <bytes> bytes. Full formatted result stored at: <locator>. <retrievalHint>)`;存储失败或没有会话所有者时,原始结果仍然可见。

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/timeout/timeout-policy/README.md
README.md: 3e5769e2f8b95392e9d489659c6bae634ab3ff18
README.zh.md: a00719334974abe731a233582ad76948692c7e5d
README.zh.md: 8d69e7d4aacb70beb5eaaa63c74a0759e0038ec5

View File

@@ -39,7 +39,7 @@
### 条件工具结果
#### 模型所见内容
#### 模型看到的内容
此插件不添加提示词或 schema。如果已声明的截止时间先到它会将提供方结果替换为 `Error: tool call timed out after <ms>ms` 与结构化 `TOOL_TIMEOUT`;否则原结果保持不变。

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/todo/tool-todo/README.md
README.md: b05ef43e7137dcf5678b1f1ad6d8c00b8a43baef
README.zh.md: 672af2bf60c7b34554957ffd43197389596840e8
README.zh.md: 88a9f5d69ff52dcedbd8f27a4ace5fde3e0dc5a2

View File

@@ -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> pending, <inProgress> in progress, <completed> completed.`。稳定失败文本为 ``Error: invalid todo: `content` must be a non-empty string``、`Error: invalid todos: duplicate content "<content>"`、`Error: invalid todos: at most one task may be in_progress, got <count>` 和 `Error: todo_write requires an owning agent session`。完整 `todo/write` 会话事件是 UI 与回放状态,而非第二条模型消息。

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/util/retention/README.md
README.md: d257075a67b35e92bce53a88fc6d002f4f4d5d9b
README.zh.md: 73023d83d1ac04e1bfdd63c1aea4021e739562c4
README.zh.md: c97c1d5afe504c54851f35b86d7bb893b32bcea4

View File

@@ -87,7 +87,7 @@ const footer = formatRetentionNotice(
通过渲染保留内容和省略元数据的工具消费方间接影响模型。
#### KV 缓存影响
#### KV Cache 影响
不会直接导致 KV Cache 失效;请求前缀变更由上述消费方负责。

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/util/timeout/README.md
README.md: 11c55a45a1255e14fb551e42ba3965453dbd94ae
README.zh.md: af1bfd9a215aa219d9fde1cec7cfee9a3dd2e55b
README.zh.md: 8b63f00595139f9af2e9a31e8ab3c3494088e0ff

View File

@@ -58,7 +58,7 @@ export async function runWithDeadline(upstream: AbortSignal | undefined, timeout
通过 `dsh-timeout-policy` 等消费方间接影响模型;消费方可能会将提供方结果替换为已保留的超时错误,或抑制延迟结果。
#### KV 缓存影响
#### KV Cache 影响
不会直接导致 KV Cache 失效;请求前缀变更由上述消费方负责。

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/workspace/workspace/README.md
README.md: bee3e4fcb5dded273f30942ee2e42ee93b839e62
README.zh.md: 64041929046cdf109bdab0dd4c2f792b4622cf83
README.zh.md: 9a052f796fb7cc8756999bdc9b2ce905805730ab

View File

@@ -24,7 +24,7 @@ DeepSeek Harness 的 Workspace 实体注册表(`ctx.workspace`):通过领
### Workspace 记录与会话记账
#### 模型所见内容
#### 模型看到的内容
没有。`ctx.workspace` 只向宿主侧消费方提供 workspace 记录:此包不注册工具、不注入提示词、不写入会话事件,因此没有请求字段会携带此包数据。