# PicoBot 配置说明

配置文件加载顺序：`~/.picobot/config.json` → 当前目录 `./config.json`。
占位符 `<VAR_NAME>` 从环境变量替换，环境变量从 `.env` 文件或系统环境读取。

## config.json 结构

```jsonc
{
  "providers": {},    // LLM 提供商配置
  "models": {},       // 模型配置
  "agents": {},       // agent 配置
  "gateway": {},      // 网关配置
  "client": {},       // 客户端配置
  "channels": {},     // 渠道配置
  "memory": {},       // 记忆系统配置
  "workspace_dir":    // 工作目录，默认 ~/.picobot/workspace
  "mcp": {}           // MCP 服务器配置
}
```

完整示例见 `assets/config.example.json`。

## providers 字段

| 字段 | 说明 |
|------|------|
| `type` | 提供商类型: `openai`（兼容 OpenAI API）、`anthropic` |
| `base_url` | API 端点地址 |
| `api_key` | API 密钥，支持 `<ENV_VAR>` 占位符 |
| `extra_headers` | 额外 HTTP 头 |

## models 字段

| 字段 | 说明 |
|------|------|
| `model_id` | 模型标识名称 |
| `temperature` | 采样温度，可选 |
| `max_tokens` | 最大输出 token 数，可选 |
| `input_type` | 模型支持的输入类型，如 `["text"]` 或 `["text", "image"]`，默认 `["text"]`. 纯内部使用，不会传递给 LLM API |

## agents 字段

| 字段 | 类型 | 默认 | 说明 |
|------|------|------|------|
| `provider` | string | - | 提供商名称（对应 providers key） |
| `model` | string | - | 模型名称（对应 models key） |
| `max_tool_iterations` | int | 99 | 最大工具调用轮数 |
| `token_limit` | int | 128000 | 上下文 token 限制 |

## gateway 字段

| 字段 | 类型 | 默认 | 说明 |
|------|------|------|------|
| `host` | string | 127.0.0.1 | 监听地址 |
| `port` | int | 19876 | 监听端口 |
| `session_ttl_hours` | int | - | 会话过期小时数 |
| `session_db_path` | string | - | SQLite 数据库路径，默认在 workspace 下 |
| `cleanup_interval_minutes` | int | - | 清理间隔 |
| `scheduler` | object | - | 调度器配置 |

## memory 字段

| 字段 | 类型 | 默认 | 说明 |
|------|------|------|------|
| `consolidation_provider` | string | - | 记忆归并 LLM 提供商 |
| `consolidation_model` | string | - | 记忆归并 LLM 模型 |
| `recall_limit` | int | 5 | 每轮注入的知识记忆条数 |
| `idle_consolidation_minutes` | int | 10 | 空闲后触发归并的分钟数 |
| `timeline_retention_days` | int | 90 | 时间线记忆保留天数 |
| `max_failures_before_degrade` | int | 3 | 归并失败次数阈值 |

## channels.feishu 字段

| 字段 | 类型 | 默认 | 说明 |
|------|------|------|------|
| `enabled` | bool | false | 是否启用 |
| `app_id` | string | - | 飞书应用 ID |
| `app_secret` | string | - | 飞书应用密钥 |
| `allow_from` | []string | ["*"] | 允许交互的用户列表 |
| `agent` | string | - | 使用的 agent 名称 |
| `media_dir` | string | ~/.picobot/media/feishu | 媒体存储目录 |
| `reaction_emoji` | string | "Typing" | 回复意向表达的表情 |

## mcp 字段

| 字段 | 类型 | 默认 | 说明 |
|------|------|------|------|
| `servers` | array | [] | MCP 服务器列表 |
| `tool_timeout_secs` | int | 180 | 工具调用超时秒数 |

MCP 服务器单条配置:

| 字段 | 说明 |
|------|------|
| `name` | 服务器名称 |
| `transport` | 传输方式: `Stdio`、`Sse`、`streamable-http` |
| `command` | 启动命令（Stdio 模式） |
| `args` | 命令参数 |
| `url` | URL（Sse / streamable-http 模式） |
| `tool_timeout_secs` | 单独的超时设置 |