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 docs/user/develop/basic/index.md
index.md: e57a42b42690bd92450cc26876c13a1622bb80cc
index.zh.md: 240623341618acd6501f2897ae2844fde0a5b73b
index.zh.md: c64d3b26ba09d8d4df736bec395a4904bc6912bc

View File

@@ -2,7 +2,7 @@
[English](index.md) | 中文
本教程会创建一个最小的 Harness 插件,并将其加载到 Web UI 中。请已完成[快速开始](../../guide/quickstart.md)的仓库检出开始
本教程会创建一个最小的 Harness 插件,并将其加载到 Web UI 中。请基于一个已完成[快速开始](../../guide/quickstart.md)的仓库检出副本进行操作
## 创建本地项目
@@ -137,5 +137,5 @@ export default class MyService extends Service {
## 下一步
- [开发一个工具](./tool.md) — 详细了解工具定义 DSL
- [开发一个工具](./tool.md) — 了解工具定义 DSL
- [插件配置](./config.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 docs/user/develop/basic/publish.md
publish.md: 8437c7ea5c4cb966f9f3d68977949c78986ec9a5
publish.zh.md: 4409dbfda060a84b316029d87ec985209cfa286a
publish.zh.md: ed146dec2db2b98631ab1a006c6f82e7c4087972

View File

@@ -161,4 +161,4 @@ dsh plugin --profile demo add github:you/hello-plugin
## 下一步
- [插件与生命周期](../framework/) — 插件的完整生命周期
- [CLI 行为参考](../../../../apps/cli/reference/README.md) — 确切的层优先级、flag 与 profile 机制
- [CLI(命令行界面)行为参考](../../../../apps/cli/reference/README.md) — 确切的层优先级、flag 与 profile 机制

View File

@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write docs/user/develop/basic/tool.md
tool.md: a149f6876c573c9ece4b066ef6c211f69b0b03a8
tool.zh.md: 1f9a1172bcde33a1d7319492f15686c47de01174
tool.zh.md: bcce5001497908cefa643749caee8da0e9859cf7

View File

@@ -49,4 +49,4 @@ pnpm dsh web --patch ./scratch-plugin/cordis.yml
- [插件配置](./config.md) — 让问候语可配置。
- [工具编写参考](../../../cookbook/adding-a-tool.md) — 查阅嵌套 schema、规范值、后台工作、策略钩子、Code Mode 和 UI 卡片。
- [能力分层](../practice/) — 将可替换能力拆分为 Service Definition、Service provider 和 Consumer 包。
- [能力分层](../practice/) — 将可替换能力拆分为 Service Definition、Service provider 和 Consumer 三类包。

View File

@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write docs/user/develop/practice/index.md
index.md: 7ca9f0b1abe472dc90c6d4e56543e43b6d2ec727
index.zh.md: fee60305143fe80c66d126cbd0532237ac80ff18
index.zh.md: 6d340e0cecfcc31517464323e5d536fc62edc132

View File

@@ -6,7 +6,7 @@
## 概念参考
当一项能力足够通用,需要支持可替换的提供方时(例如 Bash 执行),Harness 会区分三种角色:**Service Definition**、**Service provider** 和 **Consumer**。角色需要独立演进或替换时,将它们放入不同包;否则一个包可以承担多个角色。完整能力构成其 seam。任何单一角色都不是 seam。
当一项能力足够通用,需要支持可替换的提供方时(例如 Bash 执行),harness 会区分三种角色:**Service Definition**、**Service provider** 和 **Consumer**。角色需要独立演进或替换时,将它们放入不同包;否则一个包可以承担多个角色。完整能力构成其 seam。任何单一角色都不是 seam。
## 以 Bash 为例

View File

@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write docs/user/guide/config.md
config.md: 1d3ad5ce36d4b360ba5156b6be28a6caae4a23d4
config.zh.md: 7f8bfaa77066f2976a5667e3ac402814a7afdf96
config.zh.md: 74a9c581cc11e3f22bddcf6c925a4a71989d8e02

View File

@@ -2,7 +2,7 @@
[English](config.md) | 中文
Harness 使用 `cordis.yml` 描述 agent智能体加载哪些插件以及每个插件的参数。配置文件负责组合能力每个包真正支持的字段和默认值由源码生成的配置目录负责记录。
harness 使用 `cordis.yml` 描述 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 docs/user/guide/providers.md
providers.md: 0e7ed11d1b09a8361d75b576a400978ac66d08a7
providers.zh.md: 3c0dbe8bafc1e7eefe00313303e0570007435916
providers.zh.md: ec68017ab40ea93117c063a819907979316b0c94

View File

@@ -2,11 +2,11 @@
[English](providers.md) | 中文
Harness 出厂自带 DeepSeek同时预装了一个通用的多提供方适配器用来接入 pi-ai 已安装目录中的 Anthropic、OpenAI 等提供方,或任何 OpenAI 兼容的网关与自建服务。你有两个入口Web 界面的**模型**页,以及 `$DSH_HOME/settings.yaml`。两者写的是同一份文档,改完下一次请求即生效,不用重启。
harness 出厂自带 DeepSeek同时预装了一个通用的多提供方适配器用来接入 pi-ai 已安装目录中的 Anthropic、OpenAI 等提供方,或任何 OpenAI 兼容的网关与自建服务。你有两个入口Web 界面的**模型**页,以及 `$DSH_HOME/settings.yaml`。两者写的是同一份文档,改完下一次请求即生效,不用重启。
## 提供方从哪里来
`cordis.yml` 决定装了哪些**适配器**settings 文档决定跑哪些**提供方**。出厂组合里有两个 LLM 适配器:
`cordis.yml` 决定装了哪些**适配器**settings 文档决定跑哪些**提供方**。出厂组合里有两个 LLM(大语言模型)适配器:
- `llm-deepseek` 提供 `deepseek-official` 路由,是默认可用的那个。
- `llm-pi-ai` 以**休眠**状态挂载:零路由,模型选择器里也不会多出条目,直到 settings 里的 `llm-pi-ai:` 段落给出提供方 profile路由才注册上来段落清空则一并撤下。
@@ -135,7 +135,7 @@ agent-default-model:
reasoningEffort: high # optional
```
会话跑过一后,其自身日志仍是模型选择的权威;默认值只适用于尚无请求记录的会话。这个段落之下的出厂兜底是 base 组合包的 `agent-default-model` 组合条目(`deepseek-official` / `deepseek-v4-flash`)。自行组装的 `cordis.yml` 会挂载并配置 `@deepseek-ai/dsh-agent-default-model`;直接入口与 Host 支撑的入口都读取同一服务。
会话跑过一个轮次后,其自身日志仍是模型选择的权威;默认值只适用于尚无请求记录的会话。这个段落之下的出厂兜底是 base 组合包的 `agent-default-model` 组合条目(`deepseek-official` / `deepseek-v4-flash`)。自行组装的 `cordis.yml` 会挂载并配置 `@deepseek-ai/dsh-agent-default-model`;直接入口与 Host 支撑的入口都读取同一服务。
如果某个已存默认值指向的提供方后来被删掉了,输入框会显示**选择模型**并拒绝输入,而不是把消息发给一个没人服务的路由。