qqqa

qqqa 是一个极简、安全、跨平台（macOS / Linux / Windows）的命令行工具，将 LLM 能力无缝融入终端工作流。它由两个独立二进制组成：

• qq（quick question）：快速提问，只读、无副作用
• qa（quick agent）：单步智能体，可读写文件、执行命令（需确认）

其核心理念是 “无状态 + Unix 哲学”：每次调用独立、可管道、可脚本化，不依赖会话记忆，确保安全与可重现。

为什么 qqqa 值得一试？

1. 极简交互，键入即用

• qq 和 qa 均为 2 字母命令，QWERTY 键盘上输入最快
• 支持无引号提问：qq convert mp4 to mp3
• 管道友好：git status | qq "下一步该做什么？"

2. 开箱即用的多模型支持

默认配置支持 7 种后端，通过 qq --init 交互式设置：

Codex / Claude CLI 模式无需 API 密钥，直接调用本地二进制（codex / claude），边际成本为零。

3. 安全优先的智能体设计

qa 的工具调用严格受限：

• 文件操作：仅限家目录/当前目录，1MB 读取上限，防路径遍历
• 命令执行：
  • 默认允许列表（ls、grep、find、rg 等）
  • 高危命令（rm -rf、sudo）永久禁用
  • 首次使用新命令需手动加入 ~/.qq/config.json 的 command_allowlist
• 确认机制：执行前显示命令，-y 可自动批准（适合脚本）

4. 开发者友好特性

• 流式输出：qq 默认实时流式响应（可 --no-stream 禁用）
• 自动复制：--copy-command 自动将首个 <cmd> 块复制到剪贴板
• 历史上下文：--history 可选带上最近 10 条 qq/qa 命令
• 自定义 TLS：支持自签名证书（如 LiteLLM 代理）
• 无表情符号模式：--no-fun 关闭 ANSI 彩色与 emoji

快速开始

安装

# macOS/Linux (Homebrew)
brew install qqqa

# Windows/Linux: 从 GitHub Releases 下载二进制，加入 PATH

初始化

qq --init  # 交互式选择模型提供商，设置密钥

基础用法

# 提问（流式输出）
qq "如何递归列出所有文件？"

# 带管道上下文
git diff | qq "总结本次变更"

# 智能体执行（需确认）
qa "列出 src/ 下最大的 5 个 Rust 文件"

# 自动批准（脚本友好）
qa -y "统计项目代码行数"

# 复用 Claude 订阅
qq --profile claude_cli "解释这段代码"

高级配置

自定义模型

// ~/.qq/config.json
{
  "default_profile": "claude_cli",
  "profiles": {
    "my_groq": {
      "model_provider": "groq",
      "model": "openai/gpt-oss-20b"
    }
  },
  "model_providers": {
    "claude_cli": {
      "cli": {
        "model_override": "claude-haiku-4-5"  // 固定 CLI 模型
      }
    }
  }
}

本地模型 + 自定义端口

# 指向自定义 Ollama 服务
qq --profile ollama --api-base http://192.168.1.50:9000/v1 "总结日志"

安全增强

• 禁用自动复制：qq --disable-auto-copy
• 强制非流式：qq --no-stream "生成脚本"
• 临时提温：qq --temperature 0.4 "创意 commit 信息"（非 GPT-5 模型）

安全模型

• 无状态：无会话记忆，每次调用独立
• 最小权限：qq 完全只读；qa 工具调用需显式确认
• 沙箱执行：命令运行于 120 秒超时沙箱，最多执行 1 步（无循环）
• 密钥管理：优先从环境变量读取（如 OPENROUTER_API_KEY），避免配置文件明文

适用场景

• 开发者：快速查命令、解释错误、生成代码片段
• 运维：安全执行诊断命令（qa -y "检查磁盘使用"）
• 数据科学家：管道化 LLM 分析（cat data.csv | qq "描述分布"）
• 脚本增强：在 shell 脚本中嵌入 LLM 逻辑（配合 -y）