docs: make technical prose concrete

This commit is contained in:
Turtle
2026-08-09 15:27:21 +08:00
parent 673e7cddc5
commit a27efdef36
459 changed files with 1342 additions and 1329 deletions

View File

@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# 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: 6ae9fd152ca2e3b82bdb1ea9b3aa3d348ebfce66
index.zh.md: 0056a81402761310fe5f0463b83762d98ed9745f
index.md: 1eb33e17ab6c5d0a2b37ff97d5948dfbcba497ca
index.zh.md: 31afa80407f81f571615b5ed68a9370775f5188f

View File

@@ -12,8 +12,8 @@ When a capability is general enough to need replaceable providers, such as Bash
The Bash execution capability consists of:
- **Service Definition** (`dsh-bash`) — defines the Cordis service and Bash request/result vocabulary
- **Service provider** (`dsh-bash-local`) — supplies local command execution
- **Service Definition** (`dsh-bash`) — defines the Cordis service and Bash request and result types
- **Service provider** (`dsh-bash-local`) — executes commands on the local machine
- **Consumer** (`dsh-tool-bash`) — exposes the capability as a model-callable tool
```
@@ -43,7 +43,7 @@ The Service Definition and tool remain unchanged while the provider changes.
### Evolve independently
- The Service Definition changes rarely after its contract stabilizes.
- The Service Definition changes rarely after callers depend on its contract.
- Service providers can improve performance and security independently.
- Consumers can change how they present the capability to the model.

View File

@@ -12,8 +12,8 @@
以 Bash 执行能力为例:
- **Service Definition** (`dsh-bash`):定义 Cordis 服务以及 Bash 请求结果词汇
- **Service provider** (`dsh-bash-local`)提供本地命令执行
- **Service Definition** (`dsh-bash`):定义 Cordis 服务以及 Bash 请求结果类型
- **Service provider** (`dsh-bash-local`)在本地计算机上执行命令
- **Consumer** (`dsh-tool-bash`):将该能力公开为模型可调用的工具
```
@@ -43,8 +43,8 @@
### 独立演进
- Service Definition 的约定稳定后很少改动
- Service provider 可以独立优化性能和安全性
- 调用方开始依赖 Service Definition 的约定后Service Definition 很少改动
- Service provider 可以独立优化性能和安全性
- Consumer 可以调整能力向模型呈现的方式。
### 依赖解耦