title: “Blackbox — Delegate coding tasks to the Blackbox AI multi-model CLI” sidebar_label: “Blackbox” description: “Delegate coding tasks to the Blackbox AI multi-model CLI”
{/* 本页面由 website/scripts/generate-skill-docs.py 根据技能对应的 SKILL.md 文件自动生成。请直接编辑源文件 SKILL.md，而非此页面。 */}
Blackbox
将编程任务委托给 Blackbox AI 多模型 CLI 处理。
技能元数据
| 来源 | 可选 — 通过 hermes skills install official/autonomous-ai-agents/blackbox 安装 |
| 路径 | optional-skills/autonomous-ai-agents\blackbox |
| 版本 | 1.0.1 |
| 开发者 | Hermes Agent（Nous Research） |
| 许可证 | MIT |
| 支持平台 | linux、macos、windows |
| 标签 | Coding-Agent、Blackbox、Multi-Agent、Judge、Multi-Model |
| 相关技能 | claude-code、codex、hermes-agent |
参考：完整的 SKILL.md 文件
Blackbox CLI
通过 Hermes 终端将编程任务委托给 Blackbox AI 处理。Blackbox 是一款多模型编程智能体 CLI，它能够将任务分配给多种大型语言模型（Claude、Codex、Gemini、Blackbox Pro），并通过评估机制选出最优的实现方案。
该CLI工具（npm包@blackbox_ai/blackbox-cli，二进制文件blackbox）是一款基于TypeScript开发的编程智能体（由Gemini CLI分支而来），支持交互式会话、非交互式单次任务处理、检查点保存、MCP协议以及视觉模型切换功能。
前提条件
- 已安装Node.js 20及以上版本
- 已安装Blackbox CLI：
npm install -g @blackbox_ai/blackbox-cli（二进制文件名为blackbox） - 获取来自app.blackbox.ai/dashboard的API密钥
- 完成配置：运行
blackbox configure并输入您的API密钥 - 在终端调用时使用
pty=true参数——因为Blackbox CLI是一款交互式终端应用
单次任务处理
terminal(command="blackbox --prompt 'Add JWT authentication with refresh tokens to the Express API'", workdir="/path/to/project", pty=true)
用于快速临时处理任务：
terminal(command="cd $(mktemp -d) && git init && blackbox --prompt 'Build a REST API for todos with SQLite'", pty=true)
后台模式（长时间任务）
对于需要数分钟才能完成的任务，建议使用后台模式，以便随时监控任务进度：
# Start in background with PTY
terminal(command="blackbox --prompt 'Refactor the auth module to use OAuth 2.0'", workdir="~/project", background=true, pty=true)
# Returns session_id
# Monitor progress
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")
# Send input if Blackbox asks a question
process(action="submit", session_id="<id>", data="yes")
# Kill if needed
process(action="kill", session_id="<id>")
检查点与恢复
Blackbox CLI 内置了检查点功能，可用于暂停和恢复任务：
# After a task completes, Blackbox shows a checkpoint tag
# Resume with a follow-up task:
terminal(command="blackbox --resume-checkpoint 'task-abc123-2026-03-06' --prompt 'Now add rate limiting to the endpoints'", workdir="~/project", pty=true)
会话命令
在交互式会话中，可使用以下命令：
| 命令 | 功能 |
|---|---|
/compress | 缩减对话历史记录以节省令牌数 |
/clear | 清除历史记录并重新开始 |
/stats | 查看当前令牌使用情况 |
Ctrl+C | 取消当前操作 |
PR审查
请将代码克隆到临时目录中，以避免修改工作树：
terminal(command="REVIEW=$(mktemp -d) && git clone https://github.com/user/repo.git $REVIEW && cd $REVIEW && gh pr checkout 42 && blackbox --prompt 'Review this PR against main. Check for bugs, security issues, and code quality.'", pty=true)
并行处理
启动多个 Blackbox 实例以执行独立的任务：
terminal(command="blackbox --prompt 'Fix the login bug'", workdir="/tmp/issue-1", background=true, pty=true)
terminal(command="blackbox --prompt 'Add unit tests for auth'", workdir="/tmp/issue-2", background=true, pty=true)
# Monitor all
process(action="list")
多模型模式
Blackbox的独特功能在于通过多个模型执行同一任务并对比其输出结果。您可以通过blackbox configure命令来指定要使用的模型——选择多个提供方即可启用“评审员”工作流，此时CLI会评估不同模型的输出并选出最优结果。
主要参数
| 参数 | 效果 |
|---|---|
--prompt "任务内容" (-p) | 非交互式单次执行模式 |
--resume-checkpoint "标签名" | 从已保存的检查点继续执行 |
--yolo (-y) | 自动批准所有操作及模型切换 |
--vlm-switch-mode <模式> | 图像处理模式：once、session或persist |
-c, --checkpointing | 启用文件编辑内容的检查点保存功能 |
blackbox configure | 修改设置、提供方及模型配置 |
blackbox update | 将CLI升级到最新版本 |
blackbox mcp | 管理MCP服务器 |
blackbox extensions | 管理CLI插件 |
blackbox voice <操作> / blackbox shortcut | 配置语音输入功能及b快捷键 |
视觉处理支持
Blackbox能够自动识别输入内容中的图像，并切换至多模态分析模式。VLM模式包括：
"once"— 仅针对当前查询切换模型"session"— 整个会话期间持续切换模型"persist"— 保持使用当前模型，不进行切换
字符限制
您可以通过.blackboxcli/settings.json文件来控制字符使用量：
{
"sessionTokenLimit": 32000
}
规则
- 始终使用
pty=true— Blackbox CLI 是一款交互式终端应用，若没有伪终端（PTY）将会卡住。 - 使用
workdir参数 — 确保智能体始终在正确的目录中运行。 - 长时间任务请后台运行 — 使用
background=true参数，并通过process工具对任务进行监控。 - 避免干扰 — 仅通过
poll/log方式进行监控，切勿因任务执行缓慢而强制终止会话。 - 汇报结果 — 任务完成后，检查有哪些变化，并为用户总结相关情况。
- 积分需付费 — Blackbox 采用积分系统；多模型模式会更快消耗积分。
- 检查前置条件 — 在尝试委托任务之前，请确认已安装
blackboxCLI。