像猪猪侠一样，看似憨厚，实则全能。

GG-Bond 是一个极简的 AI Agent CLI 工具，具备完整的 ReAct 推理循环和多工具调用能力。支持交互式对话和子命令模式，可被外部程序 spawn 调用。

• ReAct 推理循环：LLM 自主决策调用工具，多步推理完成复杂任务
• 4 个内置工具：list_dir（列目录）、read_file（读文件）、write_file（写文件）、exec_command（执行命令）
• 会话持久化：JSONL 存储对话历史，重启不丢失上下文
• 上下文压缩：长对话自动摘要压缩，控制 Token 消耗
• CLI 子命令模式：支持 gg-bond agent --message "xxx" 单次调用，兼容 OpenClaw spawn 协议

# 交互模式（默认）
gg-bond

# 单次调用
gg-bond agent --message "帮我查看 package.json"

# JSON 格式输出（方便程序化调用）
gg-bond agent --json --message "列出当前目录的文件"

# 指定会话 ID（支持多轮对话复用）
gg-bond agent --message "继续上次的任务" --session-id "my_session"

# 测试模式
gg-bond --test

参数	缩写	说明
agent	-	子命令，进入单次调用模式
--message	-m	发送的消息内容
--session-id	-s	会话 ID（默认 cli:local）
--json	-	JSON 格式输出
--test	-	测试模式，发送测试消息后退出

# 构建镜像
docker build -t gg-bond .

# 交互模式
docker run -it gg-bond

# 单次调用
docker run gg-bond agent --message "列出文件"

GG-Bond 支持多来源配置，按以下优先级合并（高优先级覆盖低优先级）：

环境变量 (.env) > 配置文件 (gg-bond.json) > 默认值

程序启动时会按顺序查找以下位置，使用第一个找到的文件：

优先级	路径	说明
1	$GG_BOND_CONFIG_PATH	环境变量指定的自定义路径
2	./gg-bond.json	项目根目录（适合项目级配置）
3	~/.gg-bond/gg-bond.json	全局目录（适合个人默认配置）

配置文件采用 JSON 格式，支持部分配置——只需写你想覆盖的字段，其余使用默认值。

{
  "agent": {
    "defaultModel": "gpt-4o",
    "maxSteps": 20,
    "temperature": 0.3,
    "providers": {
      "openai": {
        "apiKey": "sk-xxx",
        "baseUrl": "https://api.openai.com/v1"
      }
    }
  },
  "sessions": {
    "dir": "~/.gg-bond/sessions",
    "compaction": {
      "enabled": true,
      "contextWindow": 128000,
      "threshold": 0.75,
      "keepRecent": 10
    }
  },
  "tools": {
    "profile": "coding"
  }
}

{
  "agent": {
    "defaultModel": "deepseek-chat",
    "providers": {
      "openai": {
        "apiKey": "sk-xxx",
        "baseUrl": "https://api.deepseek.com/v1"
      }
    }
  }
}

也可以通过 .env 文件或环境变量配置（优先级高于配置文件）：

OPENAI_API_KEY=sk-xxx
LLM_BASE_URL=https://api.openai.com/v1
LLM_MODEL=gpt-4o