前言¶
DeepSeek Harness(DSH)通过插件机制扩展能力。开发者常需要调用本地工具执行复杂任务。直接集成本地 CLI 需要处理认证和权限管理。dsh-subagent-grok 解决了这个问题,它使用本地认证的 Grok CLI 作为默认的一站式 DSH 子代理提供者。
核心功能¶
- 使用本地认证的 Grok CLI 作为默认的一站式 DSH 子代理提供者。
- 在父会话的工作目录中运行 grok 进程。
- 默认启用沙箱以限制写入权限。
- 不记录登录或接受/写入 API 密钥。
安装与启用¶
安装前需确认环境已就绪。该插件依赖 Node.js 20 或更新版本,以及已认证的 Grok CLI。
export DSH_HOME=/tmp/dsh-subagent-grok-home
dsh plugin --profile headless add dsh-subagent-grok
需满足的版本要求:
- @deepseek-ai/dsh 0.1.1-rc.2 或更高版本
- Grok CLI 1.0.13 或更新版本
典型用法¶
在配置文件中指定插件 ID 和参数。以下配置使用了严格的沙箱模式:
- id: subagent-grok
name: dsh-subagent-grok
config:
providerName: grok
sandbox: strict
适用场景与注意¶
- 插件在当前 DSH 进程权限下运行,安装前应检查源码与许可证。
- 如果缺失 CLI、认证失败、JSON 无效、输入非文本或提示为空,代理会明确失败。
- 默认禁用沙箱,需要显式启用
allowUnconfined: true才能绕过限制。
结语¶
该插件简化了通过 DSH 调用本地 Grok CLI 的流程。更多细节见插件目录与 GitHub 仓库。