runtime.example.toml

# LianBot 运行时配置（runtime 层）
# 复制本文件为 runtime.toml 后按需修改
# 所有段和字段均可选，缺失时使用编译期默认值
# ── 时区 ─────────────────────────────────────────────────────────────────────────
# [time]
# UTC 偏移小时数，影响日志时间戳、smy 日报、定时调度等，默认 8（中国标准时间）
# timezone = 8

# ── Bot 身份与权限 ───────────────────────────────────────────────────────────────
[bot]
# Bot 自身 QQ 号（用于检测 @Bot 等场景）
bot_id = 0
# Bot 主人 QQ 号（唯一，最高权限，不受黑名单影响）
owner = 123456789

# 权限数据库文件路径，默认 "permissions.db"
# db_path = "permissions.db"

# 初始启用的群列表（仅首次部署生效，已有 DB 记录的群不受影响）
# 群聊默认不响应，需通过此列表或 !!admin enable 命令逐个开启
initial_groups = [123456789, 987654321]

# 群聊黑名单（QQ 号列表），Bot 忽略这些用户在任何群中的消息
# group_blacklist = []

# 私聊黑名单（QQ 号列表），Bot 忽略这些用户的私聊消息
# private_blacklist = []

# ── HTTP 客户端 ───────────────────────────────────────────────────────────────
# [http]
# 请求保底超时（秒），默认 30
# 各模块可在请求时覆盖此超时（如 LLM 使用 120s，commands 使用 10s）
# timeout_secs = 30
# 连接池空闲超时（秒），默认 30
# pool_idle_timeout_secs = 30
# 每个 host 的最大空闲连接数，默认 6
# pool_max_idle_per_host = 6
# TCP keepalive 间隔（秒），默认 60
# tcp_keepalive_secs = 60

# ── NapCat / go-cqhttp HTTP API ────────────────────────────────────────────────
[napcat]
url   = "http://127.0.0.1:3000"    # NapCat 监听地址
token = ""                          # Bearer Token（NapCat 未设置时留空即可）
# 也可通过 .env 环境变量覆盖：NAPCAT_URL / NAPCAT_TOKEN
# timeout_secs         = 30    # 普通请求超时（秒）
# history_timeout_secs = 120   # 历史消息/转发展开超时（秒）

# ── 命令解析器 ─────────────────────────────────────────────────────────────────
[parser]
# 简单命令的触发前缀，默认 "!!"
# 例如设为 "!!" 时，使用 !!ping、!!help 触发命令
# 复杂命令始终使用 <命令名> 格式，不受此设置影响
# cmd_prefix = "!!"

# ── 消息池 ─────────────────────────────────────────────────────────────────────
# [pool]
# 每个群的内存缓冲最大条数，默认 3000
# 3000 条 PoolMessage 约占 150-240 KB，10 个群约 2-2.5 MB
# per_group_capacity = 3000

# 内存淘汰阈值（秒）：消息超过此时间后在下次写入时被清理，默认 25h（比 smy 24h 窗口多 1h 余量）
# evict_after_secs = 90000

# ── 日志 ──────────────────────────────────────────────────────────────────────
# [log]
# 日志文件目录（相对工作目录或绝对路径），不设置则仅输出到 stdout / journald
# log_dir  = "/opt/lianbot/logs"

# 保留天数，超出则在启动时自动清理旧文件，默认 30 天
# max_days = 30

# 日志级别（trace/debug/info/warn/error），默认 info
# level = "info"

# ── LLM / AI 模型 ─────────────────────────────────────────────────────────────
# [llm]
# OpenAI 兼容 API 地址
# api_url      = "https://api.deepseek.com/v1"
# API Key
# api_key      = "sk-xxxxxxx"
# 模型名称
# model        = "deepseek-chat"
# 请求超时（秒），默认 120
# timeout_secs = 120

# ── Gemini API（多模态支持，用于图片识别）──────────────────────────────────
# [gemini]
# Gemini API Key（获取地址：https://makersuite.google.com/app/apikey）
# api_key = "AIzaSy..."
# 模型名称，默认 gemini-2.5-flash（最新的多模态模型）
# model = "gemini-2.5-flash"
# 请求超时（秒），默认 60
# timeout_secs = 60
# 图片识别提示词（可选，默认使用内置提示词）
# vision_prompt = "请详细描述这张图片..."