docs: make technical prose concrete
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
@@ -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 可以调整能力向模型呈现的方式。
|
||||
|
||||
### 依赖解耦
|
||||
|
||||
Reference in New Issue
Block a user