51 lines
2.0 KiB
Markdown
51 lines
2.0 KiB
Markdown
# @deepseek-ai/dsh-tool-bash-persistent
|
|
|
|
[English](README.md) | 中文
|
|
|
|
模型可见的 `bash(command)`，底层复用一个按所有者隔离的 `ctx.pty` shell。该包拥有工具契约和 shell 复用；PTY 后端与沙箱策略由部署选择。
|
|
|
|
## 配置
|
|
|
|
| 键 | 默认值 | 含义 |
|
|
|---|---:|---|
|
|
| `backendType` | `shell` | 每个 Agent shell 使用的已注册 PTY 后端。 |
|
|
| `timeoutMs` | `300000` | 单条命令的墙钟时间上限；超时会关闭 shell。 |
|
|
| `maxOutputChars` | `16000` | 截断提示前保留的前缀字符数。 |
|
|
| `description` | 持久 shell 描述 | 面向模型的环境契约。 |
|
|
|
|
## 模型体验
|
|
|
|
### 工具 schema
|
|
|
|
#### 模型所见
|
|
|
|
生成的 [`bash` schema](../../../docs/tool-catalog.md#deepseek-aidsh-tool-bash-persistent)，其中包含配置的 `description`。本插件不贡献独立系统提示词段；persona 与环境指导由部署负责。
|
|
|
|
#### Token 影响
|
|
|
|
`bash` 可见时产生固定的 schema 成本。
|
|
|
|
#### KV Cache 影响
|
|
|
|
配置的描述与 schema 不变时前缀稳定。
|
|
|
|
### 工具结果
|
|
|
|
#### 模型所见
|
|
|
|
每个 Agent 的命令共享一个 shell，因此 cwd、导出的环境变量、已激活环境、函数和后台任务会跨调用保留。结果不包含私有完成标记和 shell 提示符。长输出保留仍可读取的最早前缀并追加截断提示；若 PTY 已丢弃真正的开头，结果会明确说明，而不是把尾部伪装成完整输出。超时返回有界的部分输出、关闭状态不确定的 shell，并告知模型下次调用从新 shell 开始。
|
|
|
|
#### Token 影响
|
|
|
|
随数据变化，并受 `maxOutputChars` 与固定截断提示约束。
|
|
|
|
#### KV Cache 影响
|
|
|
|
工具结果以追加方式位于可复用请求前缀之后。
|
|
|
|
## 已知限制与延后工作
|
|
|
|
- 工具需要拥有它的 Agent 和真实 PTY 后端。
|
|
- 显式 `exit`、超时或取消会丢弃 shell 状态；下次调用创建新 shell。
|
|
- 网络访问、软件包镜像等环境事实应写入配置的 `description`，而非包默认描述。
|