feat: add docs website

website/zh-CN/api/harness/bash.md

@@ -0,0 +1,81 @@
+# 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 不变。