docs(i18n): include complete proofreading corpus

This commit is contained in:
xjt
2026-08-12 12:30:19 +08:00
parent 7b450d121e
commit 4806d94715
884 changed files with 2546 additions and 2547 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/examples/README.md
README.md: 0048d14ec49776f036d841bbc0579a6867e513bb
README.zh.md: 6236b0f534bb6c5f6b1d630b6ef25324ab17e1c7
README.zh.md: 471548fd7c1814dae48c64175a1d585d1621329a

View File

@@ -2,7 +2,7 @@
[English](README.md) | 中文
预先组合的插件 bundle组合包,供轻量叶节点 `cordis.yml` 加载,无需手工组装主干和运行入口。这些是 **演示/参考**npm 名称的 `-demo` 后缀每个包标为非产品表层,直接查看包名即可辨认。仓库根目录 [`examples/`](../../examples/AGENTS.md) 下的可运行叶节点与 [Python SDK runtime](../../python/sdk-runtime/README.md) 是消费方;每个消费方都只包含可替换后端和一个组合包入口。
预先组合的插件组合包,供轻量叶节点 `cordis.yml` 加载,无需手工组装主干和运行入口。这些是 **演示/参考**npm 名称的 `-demo` 后缀表明每个包都不属于产品对外接口,直接查看包名即可辨认。仓库根目录 [`examples/`](../../examples/AGENTS.md) 下的可运行叶节点与 [Python SDK 运行时](../../python/sdk-runtime/README.md) 是消费方;每个消费方都只包含可替换后端和一个组合包入口。
| 包 | npm 名称 | 角色 |
|---|---|---|

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/acp-demo/README.md
README.md: edc45c9857a631cef72eb41b1a98c390f112291e
README.zh.md: c2946aa3d1feaed558408cf0921e2480c031187d
README.zh.md: 3798f4bf1e349c27b3fb3a32434e4f25905eddf5

View File

@@ -2,7 +2,7 @@
[English](README.md) | 中文
ACPAgent Client Protocol自动化服务器应用默认 agent智能体主干、客户端通过 [`@deepseek-ai/dsh-acp`](../../acp/acp/README.md) 创建的 agent、JSONL 持久化,以及一个 JSON-RPC stdio bin 提供的语义检查点。程序化客户端创建新会话;此包不挂载人工交互 UI。
ACPAgent Client Protocol自动化服务器应用默认 agent智能体主干、客户端通过 [`@deepseek-ai/dsh-acp`](../../acp/acp/README.md) 创建的 agent、JSONL 持久化,以及语义检查点机制,并通过一个 JSON-RPC stdio bin 对外提供服务。程序化客户端创建新会话;此包不挂载人工交互 UI。
## 组合
@@ -22,7 +22,7 @@ ACPAgent Client Protocol自动化服务器应用默认 agent智能
|---|---|---|
| `provider` | 必填 | 每个由 ACP 创建的 agent 所用的提供方路由。 |
| `model` | 必填 | 每个由 ACP 创建的 agent 所用的模型。 |
| `maxParallelToolCalls` | agent loop 默认值 | 正整数工具调用并发上限;`1` 表示串行。 |
| `maxParallelToolCalls` | agent loop(智能体循环)默认值 | 正整数工具调用并发上限;`1` 表示串行。 |
| `persona` | 无 | 供 `dsh-system-prompt` 使用的部署 persona 模板。 |
| `toolOrder` | 字典序 | 供 `dsh-system-prompt` 使用的显式面向模型工具顺序。 |
| `tools` | `{ mode: 'native' }` | Native、Code Mode 或组合式模型工具传输。 |
@@ -41,11 +41,11 @@ ACPAgent Client Protocol自动化服务器应用默认 agent智能
## Bin
`dsh-acp-demo [--config path-to-cordis.yml]`(短形式 `-c`;默认为 `./cordis.yml`)会加载 gitignore 排除的 `.env`,回放模式除外;`DSH_SNAPSHOT=replay` 选择同级 `cordis.snapshot.yml`stdin EOF 会在退出前释放上下文并刷新会话。loader 已安装的可选对等依赖peer dependency`node-addon-require-builtin` 使纯 Node 下构建后的 bin 可以解析裸插件说明符。诊断使用 stderr因为 stdout 是 ACP wire。
`dsh-acp-demo [--config path-to-cordis.yml]`(短形式 `-c`;默认为 `./cordis.yml`)会加载 gitignore 排除的 `.env`,回放模式除外;`DSH_SNAPSHOT=replay` 选择同级 `cordis.snapshot.yml`stdin EOF 会在退出前 dispose资源释放上下文并刷新会话。Loader 已安装的可选对等依赖peer dependency`node-addon-require-builtin` 使纯 Node 下构建后的 bin 可以解析裸插件说明符。诊断使用 stderr因为 stdout 是 ACP wire。
## 模型体验
模型通过 `dsh-agent-spine-demo` 和叶节点的面向模型插件间接获得体验。ACP 提示词文本会成为普通的已记录用户消息;协议元数据与权限选择不会进入模型请求。
模型体验由 `dsh-agent-spine-demo` 和叶节点的面向模型插件间接提供。ACP 提示词文本会成为普通的已记录用户消息;协议元数据与权限选择不会进入模型请求。
#### KV Cache 影响
@@ -54,5 +54,5 @@ ACPAgent Client Protocol自动化服务器应用默认 agent智能
## 已知限制与暂缓事项
- **JSONL 持久化固定不变**:使用其他后端需要另一种组合。
- **同级插件可能破坏 stdout**:应用无法阻止另一个条目写入非协议字节。
- **同级插件可能破坏 stdout**:应用无法阻止另一个 Cordis 配置项写入非协议字节。
- **只支持新建自动化会话**:恢复和人工交互属于其他运行入口。

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/agent-spine-demo/README.md
README.md: 5957d9a8e9218e18d5d7d0f620b6be811f2c230f
README.zh.md: 78372240764ff3c779ea0805aedd26a00baf1768
README.zh.md: a47727561808e02f663155bddf1d8cb206bad948

View File

@@ -2,7 +2,7 @@
[English](README.md) | 中文
**默认的不含执行器、不含 UI 的 agent智能体主干** 作为一个 Cordis 组合包插件。它加载每个 harness agent 所需的固定服务集合,包括本地 skill技能提供方并将循环的 `agents` 列表作为自身配置转发。因此,应用包package只需添加入口和可替换后端,就能组合出可工作的 agent。
将**默认的不含执行器、不含 UI 的 agent智能体主干**作为一个 Cordis 组合包插件。它加载每个 harness agent 所需的固定服务集合,包括本地 skill技能提供方并将循环的 `agents` 列表作为自身配置转发。因此,应用包只需添加入口和可替换后端,就能组合出可工作的 agent。
阅读此包可了解完整插件树及其组合顺序。