82 lines
1.6 KiB
Markdown
82 lines
1.6 KiB
Markdown
# Bash (dsh-bash)
|
||
|
||
Bash 命令执行接口。
|
||
|
||
**接口包:** `@deepseek-ai/dsh-bash`
|
||
**实现:** `@deepseek-ai/dsh-bash-local`
|
||
**消费者:** `@deepseek-ai/dsh-tool-bash`（内置于 agent-core）
|
||
|
||
## Bash Service
|
||
|
||
### ctx.bash.execute(request)
|
||
|
||
- **request:** `BashRequest`
|
||
- **返回值:** `Promise<BashResult>`
|
||
|
||
执行一个 bash 命令。
|
||
|
||
## BashRequest
|
||
|
||
```typescript
|
||
interface BashRequest {
|
||
/** 要执行的命令 */
|
||
command: string
|
||
/** 工作目录 */
|
||
workdir?: string
|
||
/** 超时时间 (ms) */
|
||
timeoutMs?: number
|
||
}
|
||
```
|
||
|
||
## BashResult
|
||
|
||
```typescript
|
||
interface BashResult {
|
||
/** 退出码 */
|
||
exitCode: number
|
||
/** stdout 输出 */
|
||
stdout: string
|
||
/** stderr 输出 */
|
||
stderr: string
|
||
/** 是否超时 */
|
||
timedOut: boolean
|
||
}
|
||
```
|
||
|
||
## 配置 (dsh-bash-local)
|
||
|
||
```typescript
|
||
interface Config {
|
||
/** 命令超时时间，默认 120000 (2 分钟) */
|
||
timeoutMs: number
|
||
}
|
||
```
|
||
|
||
在 `cordis.yml` 中：
|
||
|
||
```yaml
|
||
- name: '@deepseek-ai/dsh-bash-local'
|
||
config:
|
||
timeoutMs: 60000
|
||
```
|
||
|
||
## 模型可用的 Tools
|
||
|
||
`dsh-tool-bash` 向模型暴露以下 tools（由 `agent-core` 捆绑）：
|
||
|
||
| Tool | 说明 |
|
||
|------|------|
|
||
| `bash` | 执行命令（同步，等待完成） |
|
||
| `bash_output` | 获取后台命令的输出 |
|
||
| `bash_kill` | 终止后台命令 |
|
||
|
||
## 设计模式
|
||
|
||
Bash 是 Harness 的"能力三件套"典型案例：
|
||
|
||
- `dsh-bash`（接口）：定义 `ctx.bash` 和 `BashRequest`/`BashResult` 类型
|
||
- `dsh-bash-local`（实现）：通过 `child_process.spawn` 在本地执行
|
||
- `dsh-tool-bash`（消费者）：将能力包装为模型可调用的 tool
|
||
|
||
换一个沙箱执行器只需替换 `dsh-bash-local`，接口和 tool 不变。
|