config.example.yaml

# ===============================================================
# CodeBuddy2API 配置文件模板
#
# 使用方法:
#   首次启动时,程序会自动将本文件拷贝为 config/config.yaml。
#   也可手动拷贝: cp config.example.yaml config/config.yaml
#   然后编辑 config/config.yaml 填入真实值。
#
# 管理后台(Settings 页)修改配置后,会全量写回 config/config.yaml
# (会覆盖手动编辑的注释),如需保留注释请编辑本模板后重新拷贝。
# ===============================================================

# -----------------
# 服务端配置
# -----------------
server:
  # 服务监听地址。本地开发用 127.0.0.1;容器内用 0.0.0.0
  host: 127.0.0.1
  # 服务监听端口
  port: 8111
  # API 访问密码,客户端需在 Authorization 头中作为 Bearer Token 提供。
  # 首次启动时,程序会自动生成一个随机密码并写入 config/config.yaml
  # (同时在启动日志中打印),如需自定义请启动后修改 config/config.yaml。
  password: null

# -----------------
# CodeBuddy 官方 API 配置
# -----------------
codebuddy:
  # CodeBuddy 官方端点,一般无需修改
  api_endpoint: https://www.codebuddy.cn
  # 存放 CodeBuddy 认证凭证 (JSON) 的目录。
  # 本地开发用 .codebuddy_creds;容器部署需改为 /app/data/creds(持久化卷内)
  creds_dir: .codebuddy_creds
  # CLI 版本号 (User-Agent 等请求头使用)
  cli_version: "1.0.8"
  # 默认 X-User-Id (请求头中使用)
  default_user_id: b5be3a67-237e-4ee6-9b9a-0b9ecd7b454b
  # 向客户端报告的可用模型列表
  models:
    - custom:cd-sonnet-4.6
    - custom:cd-opus-4.7
    - glm-5.2
    - glm-5.1
    - minimax-m3-pay
    - kimi-k2.6
    - hy3-preview
    - deepseek-v4-pro
    - deepseek-v4-flash
  # 凭证轮换频率:每 N 次请求切换一次凭证,设为 0 关闭轮换。
  # 注意:这是"凭证"轮换,与日志 rotation 无关。
  credential_rotation_count: 1

# -----------------
# HTTP 客户端配置
# -----------------
http:
  # 是否启用 SSL 证书验证 (true/false),默认关闭
  ssl_verify: false
  # 请求总超时 (秒)
  request_timeout: 300
  # 连接超时 (秒)
  connect_timeout: 30

# -----------------
# 日志配置
# -----------------
logging:
  # 日志级别: DEBUG / INFO / WARNING / ERROR / CRITICAL
  level: INFO
  # 单文件大小上限,达到后触发轮转 (loguru 语法,如 "10 MB"、"50 MB")
  rotation: "10 MB"
  # 日志保留时长,超期自动删除 (含已压缩的 .gz 文件)
  # loguru 语法,如 "3 days"、"1 week"、"10"(保留最近 10 个文件)
  retention: "3 days"
  # 轮转后压缩格式: gz / zip / bz2 / xz / null(不压缩)
  compression: gz