💡 常用技巧

1. 多模型配置（省钱必备）

主力用贵模型，子代理用便宜模型：

{
  "models": {
    "providers": {
      "main-provider": {
        "baseUrl": "https://api.example.com",
        "apiKey": "sk-xxx",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-opus-4-6", "name": "Opus 4.6", "contextWindow": 200000 }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "main-provider/claude-opus-4-6" },
      "subagents": { "model": "cheap-provider/claude-sonnet-4-5" }
    }
  }
}

2. Fallback 备用链

主力挂了自动切备用：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "provider-a/claude-opus-4-6",
        "fallbacks": [
          "provider-b/claude-opus-4-5-20251101",
          "provider-c/claude-sonnet-4-5-20250929"
        ]
      }
    }
  }
}

3. 记忆系统

• MEMORY.md：长期记忆，手动维护
• memory/YYYY-MM-DD.md：每日自动日志
• 确保 memoryFlush.enabled: true，压缩前自动保存

4. Heartbeat 定期任务

{ "agents": { "defaults": { "heartbeat": { "every": "30m" } } } }

在 workspace 下创建 HEARTBEAT.md 写入需要定期检查的任务。

5. BOOT.md 首次启动

workspace 下创建 BOOT.md，Gateway 启动时自动执行一次。

6. Context 管理

• 上下文快满时用 /compact 手动压缩
• 设置 contextPruning.mode: "cache-ttl" 自动清理
• 子代理有独立 context，不会占用主会话

7. 消息队列模式

{ "messages": { "queue": { "mode": "steer" } } }

steer 模式下，新消息会引导当前对话方向，不排队等待。

8. 子代理并发

默认最多 8 个子代理同时运行：

{ "agents": { "defaults": { "subagents": { "maxConcurrent": 8 } } } }