docs(i18n): address automated review
This commit is contained in:
j-xiang
@@ -37,7 +37,6 @@
|
|||||||
| agent harness | agent harness | agent harness（智能体框架） | | agent 组合词（agent harness/workflow/loop/skill 等）整体保留英文；未括注过 agent 时首现按对应组合词或 agent 行处理 |
|
| agent harness | agent harness | agent harness（智能体框架） | | agent 组合词（agent harness/workflow/loop/skill 等）整体保留英文；未括注过 agent 时首现按对应组合词或 agent 行处理 |
|
||||||
| agent loop | agent loop | agent loop（智能体循环） | | |
|
| agent loop | agent loop | agent loop（智能体循环） | | |
|
||||||
| blob hash | blob hash | | | `git hash-object` 的结果 |
|
| blob hash | blob hash | | | `git hash-object` 的结果 |
|
||||||
| capability seam | 能力 seam | | 功能 seam、能力接缝 | 本仓库接口、实现与消费方分离的命名架构概念；普通 `seam` 仍按其词条处理 |
|
|
||||||
| Cordis | Cordis | | | |
|
| Cordis | Cordis | | | |
|
||||||
| dispose | dispose | dispose（资源释放） | | |
|
| dispose | dispose | dispose（资源释放） | | |
|
||||||
| doc-sync | doc-sync | doc-sync（文档同步门禁） | | |
|
| doc-sync | doc-sync | doc-sync（文档同步门禁） | | |
|
||||||
@@ -82,6 +81,7 @@
|
|||||||
| build target | 构建目标 | | | |
|
| build target | 构建目标 | | | |
|
||||||
| cancel | 取消 | | | |
|
| cancel | 取消 | | | |
|
||||||
| canary test | canary 测试 | | 金丝雀测试 | 本仓库保留 `canary` |
|
| canary test | canary 测试 | | 金丝雀测试 | 本仓库保留 `canary` |
|
||||||
|
| capability seam | 能力 seam | | 功能 seam、能力接缝 | 本仓库接口、实现与消费方分离的命名架构概念；普通 `seam` 仍按其词条处理 |
|
||||||
| feature | 功能 | | 能力 | SDK 产品与工程模型中的可管理产品单元 |
|
| feature | 功能 | | 能力 | SDK 产品与工程模型中的可管理产品单元 |
|
||||||
| feature option | 功能选项 | | variant | 一项 SDK 功能内有限、可选择的实现或配置 |
|
| feature option | 功能选项 | | variant | 一项 SDK 功能内有限、可选择的实现或配置 |
|
||||||
| checkpoint | 检查点 | | | |
|
| checkpoint | 检查点 | | | |
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/client/runtime/README.md
|
# pnpm run verify-translation-pairing --write packages/client/runtime/README.md
|
||||||
README.md: 25eb60e2c95059ae918669c9f5169b6b8e9c6816
|
README.md: 25eb60e2c95059ae918669c9f5169b6b8e9c6816
|
||||||
README.zh.md: 6bb1523064a8317e05fc70e7330f92af6f073406
|
README.zh.md: 441ea19a0a1c54be438252017e6925bf6fbc8d5d
|
||||||
|
|||||||
@@ -40,4 +40,4 @@ SlotsService 分别为 renderer 提供 `useSessions` 与 `useWorkspaces` 的裸
|
|||||||
|
|
||||||
- **`loader.unload` 是 stub（抛出 not-implemented）**：完整链路（fiber dispose（资源释放） → 注册级联 → 样式移除）随 HMR（热模块替换）项目落地。
|
- **`loader.unload` 是 stub（抛出 not-implemented）**：完整链路（fiber dispose（资源释放） → 注册级联 → 样式移除）随 HMR（热模块替换）项目落地。
|
||||||
- **scope 拆卸由阶段驱动，目前只能有一个占用者**：已 staged 的会话精确跟随 `list.current`（staging 就是打开信号：事件窗口打开 ⟺ 会话位于 stage）；在 staged 状态下被移除的会话，其 scope 会冻结保留，直到 stage 转向其他会话，而非直到真实观察者数量降为零。解析（`binding()`／`scope()`）只是纯寻址，可安全用于渲染；渲染层经 `currentProvideInfo` observable 读取当前 bundle。并发 pane 落地时，staged 状态可以扩展为多 pane 列表。
|
- **scope 拆卸由阶段驱动，目前只能有一个占用者**：已 staged 的会话精确跟随 `list.current`（staging 就是打开信号：事件窗口打开 ⟺ 会话位于 stage）；在 staged 状态下被移除的会话，其 scope 会冻结保留，直到 stage 转向其他会话，而非直到真实观察者数量降为零。解析（`binding()`／`scope()`）只是纯寻址，可安全用于渲染；渲染层经 `currentProvideInfo` observable 读取当前 bundle。并发 pane 落地时，staged 状态可以扩展为多 pane 列表。
|
||||||
- **插件组合包从该包导入值时必须使用 `/client` 子路径**：裸包名不在 loader externals 表中，会内联第二个模块实例；其私有 scope-tag Symbol 永远无法匹配（空状态 P0 事故复盘）。
|
- **插件组合包从该包导入值时必须使用 `/client` 子路径**：裸包名不在 loader externals 表中，会内联第二个模块实例；其私有 scope-tag Symbol 永远无法匹配（空状态 P0 事故复盘（postmortem））。
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/client/web/README.md
|
# pnpm run verify-translation-pairing --write packages/client/web/README.md
|
||||||
README.md: a4325f5dbe8ddd9bbe77086eb16fdb7aed9adc83
|
README.md: a4325f5dbe8ddd9bbe77086eb16fdb7aed9adc83
|
||||||
README.zh.md: eb025e85163a9937af23f0624116b8033d736927
|
README.zh.md: d4cb7a43da4e9c84a401ee0a1ac8c30d4816926e
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/compact/compact-tool-result-prune/README.md
|
# pnpm run verify-translation-pairing --write packages/compact/compact-tool-result-prune/README.md
|
||||||
README.md: edeba52b189b3cee5530faf7efc04043a326917f
|
README.md: edeba52b189b3cee5530faf7efc04043a326917f
|
||||||
README.zh.md: ebf8f9d8ea424d585be4c3acb07ca8b70277d6ff
|
README.zh.md: 1b42a9db5d3288c6610e431c57403858a238c07a
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/context/workspace-context/README.md
|
# pnpm run verify-translation-pairing --write packages/context/workspace-context/README.md
|
||||||
README.md: df75b29dd3e8dbb504aac9e9885c32a809cbf70f
|
README.md: df75b29dd3e8dbb504aac9e9885c32a809cbf70f
|
||||||
README.zh.md: b1d7e8b703f2ee6d8a7d132f829c39246c56c00b
|
README.zh.md: 555e55464071261f5d1752b65ed6884c5452f4ae
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/examples/README.md
|
# pnpm run verify-translation-pairing --write packages/examples/README.md
|
||||||
README.md: c229cef22087ac290bf862d6b3e31fdb533858c4
|
README.md: c229cef22087ac290bf862d6b3e31fdb533858c4
|
||||||
README.zh.md: ce2fe3a27962c9ff3aa71452c731ce2ab2caf66e
|
README.zh.md: 208b9a138506785ea1dd2d83ddfbba29e4b7968e
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/examples/agent-spine-demo/README.md
|
# pnpm run verify-translation-pairing --write packages/examples/agent-spine-demo/README.md
|
||||||
README.md: 359e7153be2f480ba3fea4b06782acdc9f89ebb9
|
README.md: 359e7153be2f480ba3fea4b06782acdc9f89ebb9
|
||||||
README.zh.md: 4fd1d7c4206fb4259fada31c0f99493a639ee6e4
|
README.zh.md: fb435c8695b59a459fd3b3c9fd6f05156d4d1134
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/fs/fs-local/README.md
|
# pnpm run verify-translation-pairing --write packages/fs/fs-local/README.md
|
||||||
README.md: 6d344fa3fef7f6bda6c0daa50184661156a925a7
|
README.md: 6d344fa3fef7f6bda6c0daa50184661156a925a7
|
||||||
README.zh.md: cbaeb203206070db123cf9438d94b10d24902e5d
|
README.zh.md: 450ae712e219a39d346ea361ca2b658762834a13
|
||||||
|
|||||||
@@ -15,7 +15,7 @@ await ctx.plugin(LocalFileSystem, { cwd: process.cwd() })
|
|||||||
## 行为
|
## 行为
|
||||||
|
|
||||||
- **`resolve(path, opts?)`**：相对 `path` 在调用方提供 `opts.cwd` 时以该值为基准解析（面向模型的工具会传入调用 agent（智能体）的会话 cwd；见[每会话 cwd Agent Note（agent 决策记录）](../../../.agents/notes/implemented/architecture/2026-07-02-fs-per-session-cwd.md)），否则以 `config.cwd` 为基准（默认 `process.cwd()`）；绝对 `path` 会忽略两者。`opts.signal` 会在本地解析前后检查，远程同级后端则可以用它中止往返。`targetKey` 是文件的 `realpath`，因此经符号链接到达同一文件的两个输入路径会共享一个身份，写入/编辑落在链接目标上，同时保留链接。尚不存在的路径在父目录存在时使用 realpath 后的父目录加 basename；只有父目录无法解析时才回退到绝对路径。`displayPath` 是绝对但未经解析的路径。
|
- **`resolve(path, opts?)`**：相对 `path` 在调用方提供 `opts.cwd` 时以该值为基准解析（面向模型的工具会传入调用 agent（智能体）的会话 cwd；见[每会话 cwd Agent Note（agent 决策记录）](../../../.agents/notes/implemented/architecture/2026-07-02-fs-per-session-cwd.md)），否则以 `config.cwd` 为基准（默认 `process.cwd()`）；绝对 `path` 会忽略两者。`opts.signal` 会在本地解析前后检查，远程同级后端则可以用它中止往返。`targetKey` 是文件的 `realpath`，因此经符号链接到达同一文件的两个输入路径会共享一个身份，写入/编辑落在链接目标上，同时保留链接。尚不存在的路径在父目录存在时使用 realpath 后的父目录加 basename；只有父目录无法解析时才回退到绝对路径。`displayPath` 是绝对但未经解析的路径。
|
||||||
- **`stat` / `lstat`**：返回目标元数据；目标不存在时返回 `undefined`。`stat` 为已解析目标报告 `FsInfo`（`version` 是由 bigint `dev:ino:size:mtimeNs:ctimeNs` 派生的不透明 token，`type` 为 `file`/`directory`/`other`，`size` 以字节计）；路径形态的 `lstat` 不跟随最后一个符号链接，报告 `FsPathInfo`，因此可以返回 `symlink`。两者都会在异步元数据探测前后检查取消，因此异步探测进行期间发生的中止会报告 `FS_ABORTED`，而非已失效的“不存在”结果。
|
- **`stat` / `lstat`**：返回目标元数据；目标不存在时返回 `undefined`。`stat` 为已解析目标报告 `FsInfo`（`version` 是由 bigint `dev:ino:size:mtimeNs:ctimeNs` 派生的不透明 token，`type` 为 `file`/`directory`/`other`，`size` 以字节计）；路径形态的 `lstat` 不跟随最后一个符号链接，报告 `FsPathInfo`，因此可以返回 `symlink`。两者都会在异步元数据探测前后检查取消，因此异步探测进行期间发生的中止会报告 `FS_ABORTED`，而非已失效的「不存在」结果。
|
||||||
- **`readText` / `streamText`**：只支持 UTF-8。`readText` 读取整个文件；`streamText` 按分片流式读取（跨分片解码），因此超大文件无需整体保存在内存中。两者都会拒绝无效 UTF-8、包含 NUL 字节的二进制样本（`FS_NOT_TEXT`）以及非普通文件目标。`read` 工具（`@deepseek-ai/dsh-tool-fs`）按大小决定调用哪个方法，并负责行窗口逻辑。
|
- **`readText` / `streamText`**：只支持 UTF-8。`readText` 读取整个文件；`streamText` 按分片流式读取（跨分片解码），因此超大文件无需整体保存在内存中。两者都会拒绝无效 UTF-8、包含 NUL 字节的二进制样本（`FS_NOT_TEXT`）以及非普通文件目标。`read` 工具（`@deepseek-ai/dsh-tool-fs`）按大小决定调用哪个方法，并负责行窗口逻辑。
|
||||||
- **`listDir`**：按稳定的 `name.localeCompare()` 顺序列出一层目录。每个条目携带子项 basename、类型、解析后的子目标（`displayPath` 位于所列目录下，`targetKey` 是 realpath 身份）和低成本 stat 元数据（`version`，普通文件另有 `size`）。它绝不会打开或解码文件内容。缺失目标报告 `FS_NOT_FOUND`，文件/特殊文件目标报告 `FS_NOT_DIRECTORY`，已中止调用报告 `FS_ABORTED`，权限失败报告 `FS_PERMISSION_DENIED`，其他列出或子项元数据 I/O 失败报告 `FS_IO_ERROR`。损坏/消失的子项以无元数据的 `other` 返回，但解析子项时出现权限/I/O 失败会让整个列表以结构化 `FsError` 失败。
|
- **`listDir`**：按稳定的 `name.localeCompare()` 顺序列出一层目录。每个条目携带子项 basename、类型、解析后的子目标（`displayPath` 位于所列目录下，`targetKey` 是 realpath 身份）和低成本 stat 元数据（`version`，普通文件另有 `size`）。它绝不会打开或解码文件内容。缺失目标报告 `FS_NOT_FOUND`，文件/特殊文件目标报告 `FS_NOT_DIRECTORY`，已中止调用报告 `FS_ABORTED`，权限失败报告 `FS_PERMISSION_DENIED`，其他列出或子项元数据 I/O 失败报告 `FS_IO_ERROR`。损坏/消失的子项以无元数据的 `other` 返回，但解析子项时出现权限/I/O 失败会让整个列表以结构化 `FsError` 失败。
|
||||||
- **`writeText`**：原子写入。它会向排他打开的临时文件（`wx`、`0o600`）写入；该文件位于目标旁随机命名的私有暂存目录（`0o700`）内。完成写入和 fsync 后，以 rename 覆盖目标。现有文件的 mode 会保留，新文件默认为 `0o600`；Windows 上的新文件继承目标目录的 DACL，而替换会在写入前把目标 DACL 复制到空临时文件，并通过 `ReplaceFileW` 发布，使原访问策略得以保留（见 [Windows DACL 保留 Agent Note](../../../.agents/notes/implemented/bug-fix/2026-07-19-windows-atomic-write-dacl-preservation.md)）。`expected` 防护是可选（OPTIONAL）的：省略时无条件创建或覆盖；`createIfAbsent` 创建缺失目标并拒绝现有目标（`FS_NOT_OBSERVED`）；`replaceIfVersion` 只在观察到的版本上替换（目标缺失或版本不匹配均为 `FS_STALE_VERSION`）。
|
- **`writeText`**：原子写入。它会向排他打开的临时文件（`wx`、`0o600`）写入；该文件位于目标旁随机命名的私有暂存目录（`0o700`）内。完成写入和 fsync 后，以 rename 覆盖目标。现有文件的 mode 会保留，新文件默认为 `0o600`；Windows 上的新文件继承目标目录的 DACL，而替换会在写入前把目标 DACL 复制到空临时文件，并通过 `ReplaceFileW` 发布，使原访问策略得以保留（见 [Windows DACL 保留 Agent Note](../../../.agents/notes/implemented/bug-fix/2026-07-19-windows-atomic-write-dacl-preservation.md)）。`expected` 防护是可选（OPTIONAL）的：省略时无条件创建或覆盖；`createIfAbsent` 创建缺失目标并拒绝现有目标（`FS_NOT_OBSERVED`）；`replaceIfVersion` 只在观察到的版本上替换（目标缺失或版本不匹配均为 `FS_STALE_VERSION`）。
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/fs/tool-fs-search/README.md
|
# pnpm run verify-translation-pairing --write packages/fs/tool-fs-search/README.md
|
||||||
README.md: 88a80fb51d7161e6940a3460b7f506575592f9cb
|
README.md: 88a80fb51d7161e6940a3460b7f506575592f9cb
|
||||||
README.zh.md: 1cfe93bfad4b7df1bf2e31edb4c0ffc3550a0e73
|
README.zh.md: 128eb0b50b45a6a68cda66687a39b169b8f7d40e
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/goal/goal/README.md
|
# pnpm run verify-translation-pairing --write packages/goal/goal/README.md
|
||||||
README.md: 45d7ac2e1c8fbd60ab2bc8b917b326d20da02ec1
|
README.md: 45d7ac2e1c8fbd60ab2bc8b917b326d20da02ec1
|
||||||
README.zh.md: 320847f860df77583301ab77df75a7b88c83575f
|
README.zh.md: b4a31f9b1a702d66346c42c01b298cef21c63ae8
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/hooks/hooks-claude/README.md
|
# pnpm run verify-translation-pairing --write packages/hooks/hooks-claude/README.md
|
||||||
README.md: 24259c24ea35cd450f8ea27ca2cca423ed4406bd
|
README.md: 24259c24ea35cd450f8ea27ca2cca423ed4406bd
|
||||||
README.zh.md: dcf621d132972e3dbb8b82d4d0a20b738b37a0b2
|
README.zh.md: 8fb40ae8e5ce74ddcc6bf91dd3c5ff12ca55a65a
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/hooks/hooks-codex/README.md
|
# pnpm run verify-translation-pairing --write packages/hooks/hooks-codex/README.md
|
||||||
README.md: fd57762c6fb91e0ea47ec57c30bf9850bc488a33
|
README.md: fd57762c6fb91e0ea47ec57c30bf9850bc488a33
|
||||||
README.zh.md: 379c4c9dfa9734833c1ac18646140c472f04396d
|
README.zh.md: 1177130152209068c2e33cd808990fcc299b8f82
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/llm/llm-deepseek/README.md
|
# pnpm run verify-translation-pairing --write packages/llm/llm-deepseek/README.md
|
||||||
README.md: 7a2314ea2ca0fb6606310a4961fcbc658240a7b8
|
README.md: 7a2314ea2ca0fb6606310a4961fcbc658240a7b8
|
||||||
README.zh.md: b213877783767d52de4cc95458b43d65c74b83b4
|
README.zh.md: e8d941967c1d2f06df6a766c3508cb4e1f7a0122
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/sandbox/sandbox/README.md
|
# pnpm run verify-translation-pairing --write packages/sandbox/sandbox/README.md
|
||||||
README.md: 99f0641560937f66df6db76ae55c90595329792f
|
README.md: 99f0641560937f66df6db76ae55c90595329792f
|
||||||
README.zh.md: 1dad0066228114e496beb75497bfd4a2585efaed
|
README.zh.md: 74b8f6cb6d87650d043661eea8986335fb669395
|
||||||
|
|||||||
@@ -32,7 +32,7 @@ sandbox mode "<mode>" is requested but no sandbox backend is usable on this host
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/skill/tool-skill/README.md
|
# pnpm run verify-translation-pairing --write packages/skill/tool-skill/README.md
|
||||||
README.md: 6b0af04a15bfda985be3e04868f18b9af702eae7
|
README.md: 6b0af04a15bfda985be3e04868f18b9af702eae7
|
||||||
README.zh.md: c0926fdf262f31c4d651fb46d2a5eac8187cc065
|
README.zh.md: 6c7d5e55cbfd4b8914fc3f65ec9a7c15bf672356
|
||||||
|
|||||||
@@ -124,7 +124,7 @@ Load referenced resources only as needed.
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可重用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可重用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
### 工具错误
|
### 工具错误
|
||||||
|
|
||||||
@@ -138,7 +138,7 @@ Load referenced resources only as needed.
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可重用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可重用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/spill/spill-policy/README.md
|
# pnpm run verify-translation-pairing --write packages/spill/spill-policy/README.md
|
||||||
README.md: 7638f62c0426964d83d7a635ebf73d0f117abd78
|
README.md: 7638f62c0426964d83d7a635ebf73d0f117abd78
|
||||||
README.zh.md: a1786da58936ebc8ad12e8d27a47fd3736aa21c1
|
README.zh.md: 52fa9946f221efa92e74e983f67753af560109b5
|
||||||
|
|||||||
@@ -50,7 +50,7 @@
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可重用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可重用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/subagent/subagent-acp/README.md
|
# pnpm run verify-translation-pairing --write packages/subagent/subagent-acp/README.md
|
||||||
README.md: efcc77c442714a83631d009efb712fa7b8f5dfa0
|
README.md: efcc77c442714a83631d009efb712fa7b8f5dfa0
|
||||||
README.zh.md: f7043e4d6f5ff94a85f17d4081bbf3c2212a6a9c
|
README.zh.md: 247e1d75fe205b98603a1c58fcc7d3cf7967b383
|
||||||
|
|||||||
@@ -57,9 +57,9 @@ ACP 不声明任何启动时能力，因为当前进程无法强制执行远程
|
|||||||
|
|
||||||
## 进程边界
|
## 进程边界
|
||||||
|
|
||||||
子进程经由 [`dsh-subprocess`](../../subprocess/subprocess/README.md) seam spawn：共享的凭据清除先移除疑似凭据的环境变量和环境中已有的 `DSH_*` 名称，显式 `config.env` 值在清除之后合并（有意转发的 `DEEPSEEK_API_KEY` 会保留下来，`DSH_PERMISSION_MODE` 这类 `DSH_*` 部署事实也以同样的方式到达子进程——清除只丢弃其陈旧的同名环境值），stderr 会继承到父进程自身的流，dispose 则以本插件配置的宽限期运行该 seam 的协作式 stdin EOF→SIGTERM→SIGKILL 阶梯。ACP 协议格式是真正的序列化边界；同进程 subagent 值不会为防御目的而克隆。
|
子进程经由 [`dsh-subprocess`](../../subprocess/subprocess/README.md) seam spawn：共享的凭据清除先移除疑似凭据的环境变量和环境中已有的 `DSH_*` 名称，显式 `config.env` 值在清除之后合并（有意转发的 `DEEPSEEK_API_KEY` 会保留下来，`DSH_PERMISSION_MODE` 这类 `DSH_*` 部署事实也以同样的方式到达子进程——清除只丢弃其陈旧的同名环境值），stderr 会继承到父进程自身的流，dispose 则以本插件配置的宽限期运行该 seam 的协作式 stdin EOF→SIGTERM→SIGKILL 阶梯。ACP 协议格式（wire format）是真正的序列化边界；同进程 subagent 值不会为防御目的而克隆。
|
||||||
|
|
||||||
本包（package）没有默认导出。否则 Cordis loader 的解包会隐藏具名 `inject` 元数据；见[事故复盘 0001](../../../docs/postmortem/0001-acp-default-export-drops-inject.md)。
|
本包（package）没有默认导出。否则 Cordis loader 的解包会隐藏具名 `inject` 元数据；见[事故复盘（postmortem）0001](../../../docs/postmortem/0001-acp-default-export-drops-inject.md)。
|
||||||
|
|
||||||
无密钥测试通过真实 stdio 驱动脚本化 ACP 子进程，其中包括一个由 Loader 组合的 stdio 应用，用于端到端证明父会话 cwd 继承。带密钥 e2e 会驱动仓库中的真实 ACP agent；没有 `DEEPSEEK_API_KEY` 时自行跳过。
|
无密钥测试通过真实 stdio 驱动脚本化 ACP 子进程，其中包括一个由 Loader 组合的 stdio 应用，用于端到端证明父会话 cwd 继承。带密钥 e2e 会驱动仓库中的真实 ACP agent；没有 `DEEPSEEK_API_KEY` 时自行跳过。
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/subagent/subagent-dsh-sdk/README.md
|
# pnpm run verify-translation-pairing --write packages/subagent/subagent-dsh-sdk/README.md
|
||||||
README.md: e904ce3c09a1b44f8f5a0072b9ca85812898e74f
|
README.md: e904ce3c09a1b44f8f5a0072b9ca85812898e74f
|
||||||
README.zh.md: 263626a790430c0c8c24c18e8130d3932e5491e5
|
README.zh.md: a34cdb237bdd20aba9e6edd6c1f76b72acd32c5c
|
||||||
|
|||||||
@@ -57,7 +57,7 @@ Provider 不宣告任何启动期能力（`outputSchema`/`depthLimit`/`toolFilte
|
|||||||
|
|
||||||
子进程环境以 [`dsh-subprocess`](../../subprocess/README.md) seam 的 `scrubbedParentEnv()` 为基础，先移除疑似凭据和名称为 `DSH_*` 的环境变量，再合并显式 `config.env` 值。子进程由 SDK 客户端 spawn，而不是经由 `ctx.subprocess` spawn（这是 subprocess README 中记录的 SDK 托管传输例外），因此本后端会自行执行环境清理。JSON-RPC 协议格式才是真正的序列化边界。
|
子进程环境以 [`dsh-subprocess`](../../subprocess/README.md) seam 的 `scrubbedParentEnv()` 为基础，先移除疑似凭据和名称为 `DSH_*` 的环境变量，再合并显式 `config.env` 值。子进程由 SDK 客户端 spawn，而不是经由 `ctx.subprocess` spawn（这是 subprocess README 中记录的 SDK 托管传输例外），因此本后端会自行执行环境清理。JSON-RPC 协议格式才是真正的序列化边界。
|
||||||
|
|
||||||
本包（package）没有默认导出。否则 Cordis loader 解包会隐藏具名 `inject` 元数据；见[事故复盘 0001](../../../docs/postmortem/0001-acp-default-export-drops-inject.md)。
|
本包（package）没有默认导出。否则 Cordis loader 解包会隐藏具名 `inject` 元数据；见[事故复盘（postmortem）0001](../../../docs/postmortem/0001-acp-default-export-drops-inject.md)。
|
||||||
|
|
||||||
免密钥测试通过真实 stdio 驱动 SDK 客户端包的脚本化伪运行时，还包括一个 Loader 组合 e2e：子进程是真实的第二个 harness 运行时，端到端证明父会话 cwd 继承（`tests/loader-composition.e2e.ts`）。
|
免密钥测试通过真实 stdio 驱动 SDK 客户端包的脚本化伪运行时，还包括一个 Loader 组合 e2e：子进程是真实的第二个 harness 运行时，端到端证明父会话 cwd 继承（`tests/loader-composition.e2e.ts`）。
|
||||||
|
|
||||||
@@ -89,7 +89,7 @@ Provider 不宣告任何启动期能力（`outputSchema`/`depthLimit`/`toolFilte
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/subagent/subagent-fork/README.md
|
# pnpm run verify-translation-pairing --write packages/subagent/subagent-fork/README.md
|
||||||
README.md: b448dc309bff07c744443530a648c7c30e4d20d9
|
README.md: b448dc309bff07c744443530a648c7c30e4d20d9
|
||||||
README.zh.md: 503e74bf5d8feafa701a7bde3426ecd9d021fda4
|
README.zh.md: 38d96ee2027a815f3541b3cfe73d4e20f3c87620
|
||||||
|
|||||||
@@ -53,7 +53,7 @@ fork 会把保留的已完成历史复制到独立的子 agent 请求中；随
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/subagent/subagent-spawn/README.md
|
# pnpm run verify-translation-pairing --write packages/subagent/subagent-spawn/README.md
|
||||||
README.md: 868f829edbcfe2eb4d66ccd0ff9988924c70298b
|
README.md: 868f829edbcfe2eb4d66ccd0ff9988924c70298b
|
||||||
README.zh.md: a436bd98a0ffb814862322783586acdfe48c8067
|
README.zh.md: 99cfdf0e633345d1152c59cbe5ce7a029eb6ec9d
|
||||||
|
|||||||
@@ -48,7 +48,7 @@ spawn 声明 `{ outputSchema: true, depthLimit: true, toolFilter: true, persona:
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/subagent/tool-subagent/README.md
|
# pnpm run verify-translation-pairing --write packages/subagent/tool-subagent/README.md
|
||||||
README.md: 20bb6b9c59a13f23301368faefe18849ccc0b1e9
|
README.md: 20bb6b9c59a13f23301368faefe18849ccc0b1e9
|
||||||
README.zh.md: dfa989164c300d539f9b3517234fbf48945a65da
|
README.zh.md: 8da57896359f5ac47d0ec076c3395d2e7fb1e02a
|
||||||
|
|||||||
@@ -58,7 +58,7 @@
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
### 后台任务结果
|
### 后台任务结果
|
||||||
|
|
||||||
@@ -72,7 +72,7 @@
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/support/llm-replay/README.md
|
# pnpm run verify-translation-pairing --write packages/support/llm-replay/README.md
|
||||||
README.md: 6c934e01a5f13b94724d0e5435524d9d463adb2f
|
README.md: 6c934e01a5f13b94724d0e5435524d9d463adb2f
|
||||||
README.zh.md: e72d3dbbfc22cddea5e613e51cb33bd38a8a4290
|
README.zh.md: d13d84ad95a6b63177ee0e2aa83965be19fdeeb8
|
||||||
|
|||||||
@@ -8,7 +8,7 @@
|
|||||||
|
|
||||||
## fixture 的工作方式
|
## fixture 的工作方式
|
||||||
|
|
||||||
fixture 就是持久化的会话日志（`<scenario>/session.jsonl`）。其 `assistant/chunk` 事件包含每个 `StreamChunk`，因此按 `(turn, step)` 分组即可重建每次 `stream()` 调用的分片序列（每个循环步骤调用一次模型）。因此，录制就是“运行一次真实 agent 并收集 `.jsonl`”，由快照 harness 完成；该插件本身不录制。fixture 的 `request/header` 内容可能被标记化为 `{{system}}`/`{{tools}}`（harness 会在一个场景中固定该内容，并清除其余场景中的内容）；回放不受影响，因为派生过程只读取 `assistant/chunk` 事件和第 0 行的会话 header。
|
fixture 就是持久化的会话日志（`<scenario>/session.jsonl`）。其 `assistant/chunk` 事件包含每个 `StreamChunk`，因此按 `(turn, step)` 分组即可重建每次 `stream()` 调用的分片序列（每个循环步骤调用一次模型）。因此，录制就是「运行一次真实 agent 并收集 `.jsonl`」，由快照 harness 完成；该插件本身不录制。fixture 的 `request/header` 内容可能被标记化为 `{{system}}`/`{{tools}}`（harness 会在一个场景中固定该内容，并清除其余场景中的内容）；回放不受影响，因为派生过程只读取 `assistant/chunk` 事件和第 0 行的会话 header。
|
||||||
|
|
||||||
有两种失败模式无法仅根据 `assistant/chunk` 重建：在产生任何分片前直接抛出异常（例如 HTTP 401，此时日志只有 `turn/end {error}` 而没有分片），以及取消或挂起（差异在时序，而非分片内容）。需要这些行为的场景可提供伴随文件（`<scenario>/replay.override.json`）：它可以替换派生脚本（裸 `ReplayEntry[]`），也可以增补派生脚本（`{ patches: [{ at, entry }] }`：保留所有从 JSONL 派生的调用，只替换指定的从 0 开始计数的调用索引；当 `at` 等于派生长度时，则在注入瞬态异常后的重试位置追加一次调用）。补丁索引不得重复。文件加载时会校验覆写文档、每个补丁和条目，以及每个分片的判别标签。`hang` 条目可以指定 `readyFile`；当前缀分片到达循环后、开始等待取消前，回放会写入这个空标记，使外部驱动程序无需观察展示层更新即可确定性地取消。
|
有两种失败模式无法仅根据 `assistant/chunk` 重建：在产生任何分片前直接抛出异常（例如 HTTP 401，此时日志只有 `turn/end {error}` 而没有分片），以及取消或挂起（差异在时序，而非分片内容）。需要这些行为的场景可提供伴随文件（`<scenario>/replay.override.json`）：它可以替换派生脚本（裸 `ReplayEntry[]`），也可以增补派生脚本（`{ patches: [{ at, entry }] }`：保留所有从 JSONL 派生的调用，只替换指定的从 0 开始计数的调用索引；当 `at` 等于派生长度时，则在注入瞬态异常后的重试位置追加一次调用）。补丁索引不得重复。文件加载时会校验覆写文档、每个补丁和条目，以及每个分片的判别标签。`hang` 条目可以指定 `readyFile`；当前缀分片到达循环后、开始等待取消前，回放会写入这个空标记，使外部驱动程序无需观察展示层更新即可确定性地取消。
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/tasks/tool-tasks/README.md
|
# pnpm run verify-translation-pairing --write packages/tasks/tool-tasks/README.md
|
||||||
README.md: 276ca3f8284b366bee54e585297c3a033a65c8d1
|
README.md: 276ca3f8284b366bee54e585297c3a033a65c8d1
|
||||||
README.zh.md: 830c416102e69228c9fa420ebaf08e96cda86237
|
README.zh.md: 823c25c3e0c7c208ffef9c5be5b2e4ef7e96bad8
|
||||||
|
|||||||
@@ -77,7 +77,7 @@ Track every background task id you start. You are notified in-session when a tas
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/timeout/timeout-policy/README.md
|
# pnpm run verify-translation-pairing --write packages/timeout/timeout-policy/README.md
|
||||||
README.md: 3e5769e2f8b95392e9d489659c6bae634ab3ff18
|
README.md: 3e5769e2f8b95392e9d489659c6bae634ab3ff18
|
||||||
README.zh.md: 906ea9eed1fe411d3c50332a8bbc35afb3fa0271
|
README.zh.md: a00719334974abe731a233582ad76948692c7e5d
|
||||||
|
|||||||
@@ -49,7 +49,7 @@
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/todo/tool-todo/README.md
|
# pnpm run verify-translation-pairing --write packages/todo/tool-todo/README.md
|
||||||
README.md: b05ef43e7137dcf5678b1f1ad6d8c00b8a43baef
|
README.md: b05ef43e7137dcf5678b1f1ad6d8c00b8a43baef
|
||||||
README.zh.md: 15c00f1f94fb8c48dda0c406f0360d72d3b8519a
|
README.zh.md: 672af2bf60c7b34554957ffd43197389596840e8
|
||||||
|
|||||||
@@ -58,7 +58,7 @@ token 用量会随模型每次提交的完整列表增长，且这些调用参
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/ui/jsonrpc/README.md
|
# pnpm run verify-translation-pairing --write packages/ui/jsonrpc/README.md
|
||||||
README.md: b1219ba10269fc7d046da22c280ff1b91424a5ae
|
README.md: b1219ba10269fc7d046da22c280ff1b91424a5ae
|
||||||
README.zh.md: 38db63faeb064c990eedb848b9ab40d3fc1428a5
|
README.zh.md: 1c27f5edf2f1f172aa6303697b17e2e77a65842a
|
||||||
|
|||||||
@@ -38,7 +38,7 @@ Stdout 只承载 JSON-RPC 帧。部署不得组合 stdout logger；诊断应写
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/ui/tool-ask-user/README.md
|
# pnpm run verify-translation-pairing --write packages/ui/tool-ask-user/README.md
|
||||||
README.md: 8e779f4025c20cd200344efb7cb8cd6bc09ba64d
|
README.md: 8e779f4025c20cd200344efb7cb8cd6bc09ba64d
|
||||||
README.zh.md: 1bf962bfb8017d5efff8cc5d51bc60c249005523
|
README.zh.md: acaffec0764404a0e0e842ffc2b4efdee8869c4f
|
||||||
|
|||||||
@@ -49,7 +49,7 @@
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/web/tool-web/README.md
|
# pnpm run verify-translation-pairing --write packages/web/tool-web/README.md
|
||||||
README.md: 9b78920b1b6c611118294421dec1e75e381ed5d6
|
README.md: 9b78920b1b6c611118294421dec1e75e381ed5d6
|
||||||
README.zh.md: 279af68c0eae27266c09e20c4c67c45372a6693e
|
README.zh.md: d36258d3a5bd8af6716e1fd9c3384389e8395e23
|
||||||
|
|||||||
@@ -95,7 +95,7 @@ Use the web_fetch tool to retrieve the content of a specific HTTP(S) URL (for ex
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
### 抓取结果
|
### 抓取结果
|
||||||
|
|
||||||
@@ -109,7 +109,7 @@ Use the web_fetch tool to retrieve the content of a specific HTTP(S) URL (for ex
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
### 参数错误
|
### 参数错误
|
||||||
|
|
||||||
@@ -123,7 +123,7 @@ Use the web_fetch tool to retrieve the content of a specific HTTP(S) URL (for ex
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/web/web-search-deepseek/README.md
|
# pnpm run verify-translation-pairing --write packages/web/web-search-deepseek/README.md
|
||||||
README.md: 54eb7561b9d81a9e2da565e3870abe094dbe984d
|
README.md: 54eb7561b9d81a9e2da565e3870abe094dbe984d
|
||||||
README.zh.md: 34e09159c36e9df561a22205a782b7789595239e
|
README.zh.md: 8862b8a9c1ba69d247942bb6e41289214826c682
|
||||||
|
|||||||
@@ -4,7 +4,7 @@
|
|||||||
|
|
||||||
由 [DeepSeek](https://deepseek.com) 支持的 `WebSearchProvider`，用于 harness [web 能力 seam](../web/README.md)（`ctx.web`）。它调用 DeepSeek 的 **Anthropic 兼容 Messages API**（`POST {baseURL}/messages`），启用原生 `web_search_20250305` 服务器工具，并把 DeepSeek 返回的结构化 `web_search_tool_result` 块映射为 seam 规范化的 `WebSearchResult`。
|
由 [DeepSeek](https://deepseek.com) 支持的 `WebSearchProvider`，用于 harness [web 能力 seam](../web/README.md)（`ctx.web`）。它调用 DeepSeek 的 **Anthropic 兼容 Messages API**（`POST {baseURL}/messages`），启用原生 `web_search_20250305` 服务器工具，并把 DeepSeek 返回的结构化 `web_search_tool_result` 块映射为 seam 规范化的 `WebSearchResult`。
|
||||||
|
|
||||||
这是一个**实现**包（package）：它向 `ctx.web` 注册提供方，不拥有该键，也不注册面向模型的工具。与 `@deepseek-ai/dsh-llm-deepseek` 一样，它是函数／命名空间插件（`inject: ['web']`）。Anthropic 协议格式是提供方私有细节，并**不**使该提供方依赖 `ctx.llm`。
|
这是一个**实现**包（package）：它向 `ctx.web` 注册提供方，不拥有该键，也不注册面向模型的工具。与 `@deepseek-ai/dsh-llm-deepseek` 一样，它是函数／命名空间插件（`inject: ['web']`）。Anthropic 协议格式（wire format）是提供方私有细节，并**不**使该提供方依赖 `ctx.llm`。
|
||||||
|
|
||||||
## 与专用搜索端点的区别
|
## 与专用搜索端点的区别
|
||||||
|
|
||||||
@@ -69,7 +69,7 @@ DeepSeek 不返回该提供方可作为 `content` 信任的提供方生成答案
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/web/web-search-perplexity/README.md
|
# pnpm run verify-translation-pairing --write packages/web/web-search-perplexity/README.md
|
||||||
README.md: 80f6d34d63ddf0cc7d1f0d4f6744d64c91f9a269
|
README.md: 80f6d34d63ddf0cc7d1f0d4f6744d64c91f9a269
|
||||||
README.zh.md: f96ba840a758c9c694e46d14fa5c8fbac9c81225
|
README.zh.md: 521416c97e3d78598d37d41865b3465484be6839
|
||||||
|
|||||||
@@ -4,7 +4,7 @@
|
|||||||
|
|
||||||
由 [Perplexity](https://perplexity.ai) 支持的 `WebSearchProvider`，用于 harness [web 能力 seam](../web/README.md)（`ctx.web`）。它调用 Perplexity 的 OpenAI 兼容 `POST /chat/completions` 端点，把生成答案与引用映射为 seam 规范化的 `WebSearchResult`。
|
由 [Perplexity](https://perplexity.ai) 支持的 `WebSearchProvider`，用于 harness [web 能力 seam](../web/README.md)（`ctx.web`）。它调用 Perplexity 的 OpenAI 兼容 `POST /chat/completions` 端点，把生成答案与引用映射为 seam 规范化的 `WebSearchResult`。
|
||||||
|
|
||||||
这是一个**实现**包（package）：它向 `ctx.web` 注册提供方，不拥有该键，也不注册面向模型的工具。与 `@deepseek-ai/dsh-llm-deepseek` 一样，它是函数／命名空间插件（`inject: ['web']`）。OpenAI 兼容协议格式是提供方私有细节，并**不**使该提供方依赖 `ctx.llm`。
|
这是一个**实现**包（package）：它向 `ctx.web` 注册提供方，不拥有该键，也不注册面向模型的工具。与 `@deepseek-ai/dsh-llm-deepseek` 一样，它是函数／命名空间插件（`inject: ['web']`）。OpenAI 兼容协议格式（wire format）是提供方私有细节，并**不**使该提供方依赖 `ctx.llm`。
|
||||||
|
|
||||||
## 配置
|
## 配置
|
||||||
|
|
||||||
@@ -55,7 +55,7 @@
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/web/web/README.md
|
# pnpm run verify-translation-pairing --write packages/web/web/README.md
|
||||||
README.md: 73765fe060cc0a2b0fa3d69703a670f488a29ac9
|
README.md: 73765fe060cc0a2b0fa3d69703a670f488a29ac9
|
||||||
README.zh.md: 9000f79c9bdbe0c12ff126716b709c61fd0cfbba
|
README.zh.md: 49aef50bc678b523d5ee44d2bc4a015106ea7ae1
|
||||||
|
|||||||
@@ -14,7 +14,7 @@
|
|||||||
| `@deepseek-ai/dsh-web-fetch-local` | 抓取实现：匿名公共 HTTP(S) |
|
| `@deepseek-ai/dsh-web-fetch-local` | 抓取实现：匿名公共 HTTP(S) |
|
||||||
| `@deepseek-ai/dsh-tool-web` | 面向模型的 `web_search`／`web_fetch` 工具 schema，构建于 `ctx.web` 之上 |
|
| `@deepseek-ai/dsh-tool-web` | 面向模型的 `web_search`／`web_fetch` 工具 schema，构建于 `ctx.web` 之上 |
|
||||||
|
|
||||||
搜索与抓取没有共享请求 schema 或业务逻辑，但有意共用一个 seam：`ctx.web` 是单一 web 访问中间层，拥有一项提供方选择策略、一套中止／错误词汇和一个面向产品的“该 harness 如何访问 web”配置接口。代价是成对的并行 `Search`／`Fetch` 方法；这种并行是有意设计，并非遗漏了可抽取的共性。
|
搜索与抓取没有共享请求 schema 或业务逻辑，但有意共用一个 seam：`ctx.web` 是单一 web 访问中间层，拥有一项提供方选择策略、一套中止／错误词汇和一个面向产品的「该 harness 如何访问 web」配置接口。代价是成对的并行 `Search`／`Fetch` 方法；这种并行是有意设计，并非遗漏了可抽取的共性。
|
||||||
|
|
||||||
## 服务 API（`ctx.web`）
|
## 服务 API（`ctx.web`）
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/workflow/tool-workflow/README.md
|
# pnpm run verify-translation-pairing --write packages/workflow/tool-workflow/README.md
|
||||||
README.md: 5afa68764bfe339377954f8912b6f9b795435be1
|
README.md: 5afa68764bfe339377954f8912b6f9b795435be1
|
||||||
README.zh.md: 5016bd2950197b8e8497cbc7c72c26c8de753dbe
|
README.zh.md: 02a19e26f30e96d21b60e40f3fc7bb98193a3c95
|
||||||
|
|||||||
@@ -71,7 +71,7 @@ Use the <toolName> tool ONLY when the user explicitly asks for a workflow or for
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
@@ -3,4 +3,4 @@
|
|||||||
# after editing either side, bring the other along and re-record with:
|
# after editing either side, bring the other along and re-record with:
|
||||||
# pnpm run verify-translation-pairing --write packages/workflow/workflow-workerthread/README.md
|
# pnpm run verify-translation-pairing --write packages/workflow/workflow-workerthread/README.md
|
||||||
README.md: 9da420bdd67ac5b0a4bfffa312c6fe7b2dabf8f5
|
README.md: 9da420bdd67ac5b0a4bfffa312c6fe7b2dabf8f5
|
||||||
README.zh.md: 71e3b1833031458758cd067a90d28966d94b0e52
|
README.zh.md: 2fad456fb13846ceccc3b5d09ed5c6192e180686
|
||||||
|
|||||||
@@ -113,7 +113,7 @@ worker 错误、消息失败或提前退出会在清理前关闭消息接纳，
|
|||||||
|
|
||||||
#### KV Cache 影响
|
#### KV Cache 影响
|
||||||
|
|
||||||
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
|
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
|
||||||
|
|
||||||
## 已知限制与暂缓事项
|
## 已知限制与暂缓事项
|
||||||
|
|
||||||
|
|||||||
File diff suppressed because one or more lines are too long
Reference in New Issue
Block a user