config.toml.example

# zh: 机器人小号配置。
# en: Bot account settings.
[core]
# zh: 机器人QQ号。
# en: Bot QQ number.
bot_qq = 0
# zh: 超级管理员QQ号（唯一，可添加其他管理员）。
# en: Superadmin QQ number (unique).
superadmin_qq = 0
# zh: 初始管理员QQ号列表（逗号分隔，可选）。
# en: Initial admin QQ list (comma-separated, optional).
admin_qq = []
# zh: 音频转发代理QQ号（用于群聊音频转发，可选）。
# en: Audio forward proxy QQ number (for group audio forwarding, optional).
forward_proxy_qq = 0
# zh: 是否处理每条群消息。关闭后仅处理 @机器人、私聊和拍一拍（推荐默认开启）。
# en: Process every group message. If disabled, only @mentions, private chats, and pokes are handled (recommended: enabled).
process_every_message = true
# zh: 是否处理私聊消息。关闭后将只记录私聊历史，不触发 AI 回复。
# en: Process private messages. If disabled, private chat history is still recorded but AI replies are skipped.
process_private_message = true
# zh: 是否响应拍一拍。关闭后拍一拍事件将被忽略。
# en: Respond to poke events. If disabled, poke events are ignored.
process_poke_message = true
# zh: 注入给模型的最近历史消息条数（0 表示不注入；无固定上限，受 max_records 与存储约束）。
# en: Recent messages injected as model context (0 disables; no fixed cap; bounded by max_records/storage).
context_recent_messages_limit = 20
# zh: 单次 LLM 请求失败时最大静默重试次数（0=不重试，默认2）。失败的请求会回到原队列的第 2 个位置。
# en: Max silent retries for a single failed LLM request (0=no retry, default 2). Failed requests are reinserted at position 2 of their original queue lane.
ai_request_max_retries = 2
# zh: 模型返回纯文本但未调用 send_message/end 等工具时的最大纠正重试次数（0=不重试，默认3）。
# en: Max correction retries when the model returns plain text without tool calls (0=no retry, default 3).
missing_tool_call_retries = 3

# zh: 访问控制。mode 可选：off（不启用）/ blacklist（按黑名单）/ allowlist（按白名单）。
# en: Access control. mode options: off (disabled) / blacklist / allowlist.
[access]
# zh: 访问控制模式：off / blacklist / allowlist。
# en: Access control mode: off / blacklist / allowlist.
mode = "off"

# zh: 允许处理/发送的群号白名单（留空 = 不限制）。
# en: Allowed group IDs. Empty = no restriction.
allowed_group_ids = []

# zh: 禁止处理/发送的群号黑名单（优先级高于 allowed_group_ids）。
# en: Blocked group IDs. Higher priority than allowed_group_ids.
blocked_group_ids = []

# zh: 允许处理/发送的私聊 QQ 白名单（留空 = 不限制）。
# en: Allowed private-chat user IDs. Empty = no restriction.
allowed_private_ids = []

# zh: 禁止处理/发送的私聊 QQ 黑名单（blacklist 模式生效）。
# en: Blocked private-chat user IDs (effective in blacklist mode).
blocked_private_ids = []

# zh: 超级管理员是否可在私聊中绕过 "allowed_private_ids"（仅影响私聊收发；群聊仍严格按 "allowed_group_ids"）。
# en: Allow superadmin to bypass "allowed_private_ids" for private chats only.
superadmin_bypass_allowlist = true

# zh: 超级管理员是否可在私聊中绕过 "blocked_private_ids"（仅影响私聊收发）。
# en: Allow superadmin to bypass "blocked_private_ids" for private chats only.
superadmin_bypass_private_blacklist = false

# zh: OneBot WebSocket 配置。
# en: OneBot WebSocket settings.
[onebot]
# zh: NapCat WebSocket地址。
# en: NapCat WebSocket URL.
ws_url = "ws://127.0.0.1:3001"
# zh: Access Token（可选）。
# en: Access token (optional).
token = ""

# zh: 本地文件发送方式：local（共享路径，默认，兼容旧部署）/ url（Runtime 临时链接）/ stream（NapCat Stream API）。支持热更新。
# en: Local file transport: local (shared paths, default for compatibility), url (temporary Runtime links), or stream (NapCat Stream API). Hot reload supported.
file_send_mode = "local"
# zh: 仅 URL 模式使用：OneBot 可访问的 Runtime 主机地址，支持 IPv4、IPv6 或域名，不包含协议、端口或路径；端口使用 Runtime 实际监听端口。
# en: URL mode only: Runtime host reachable by OneBot, as IPv4, IPv6 or a domain without scheme, port or path. Uses the actual Runtime listening port.
file_send_host = "127.0.0.1"

[models]
# zh: 对话模型配置（主模型，处理每一条消息）。
# en: Chat model config (the main model, processing each message).
[models.chat]
# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭；模型池条目需在 entry 内单独配置。
# en: Whether this model uses proxy addresses from [proxy]. Disabled by default; pool entries configure this per entry.
use_proxy = false
# zh: Provider 基址；OpenAI 兼容接口通常为 .../v1，Anthropic 原生接口可写站点根地址或 .../v1。
# en: Provider base URL; OpenAI-compatible APIs usually use .../v1, while native Anthropic accepts the site root or .../v1.
api_url = ""
# zh: Chat 模型 API Key。
# en: Chat model API key.
api_key = ""
# zh: Chat 模型名称。
# en: Chat model name.
model_name = ""
# zh: 最大生成 tokens；OpenAI 模式下非正数会省略上限，Anthropic Messages 要求为正整数。
# en: Max generation tokens; non-positive values omit the limit in OpenAI modes, while Anthropic Messages requires a positive integer.
max_tokens = 8192

# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
context_window_tokens = 32768
# zh: 队列发车间隔（秒；<=0 事件驱动立即发车且空闲不扫描，>0 按间隔扫描）。
# en: Queue interval (seconds; <=0 dispatches on arrival without idle polling; >0 polls periodically).
queue_interval_seconds = 1.0
# zh: API 模式：openai.chat_completions、openai.responses 或 anthropic.messages；旧无前缀值仍兼容但已弃用。
# en: API mode: openai.chat_completions, openai.responses, or anthropic.messages. Legacy unprefixed values remain compatible but are deprecated.
api_mode = "openai.chat_completions"
# zh: 是否启用 reasoning.effort。
# en: Enable reasoning.effort.
reasoning_enabled = false
# zh: 自定义 reasoning effort；值为 adaptive 时原样发送 adaptive，其余值也原样透传。
# en: Custom reasoning effort; adaptive is sent as adaptive and every other value is passed through unchanged.
reasoning_effort = "medium"
# zh: 是否发送由 thinking_enabled 自动生成的顶层 thinking 参数；调用方显式 thinking 不受影响。
# en: Send the top-level thinking parameter generated by thinking_enabled; explicit caller overrides are unaffected.
thinking_param_enabled = true
# zh: 是否启用 thinking（思维链）。
# en: Enable thinking (reasoning).
thinking_enabled = false
# zh: thinking 预算 tokens。
# en: Thinking-budget tokens.
thinking_budget_tokens = 20000
# zh: 是否发送手动 thinking 预算；anthropic.messages 下关闭时使用 adaptive thinking。
# en: Send a manual thinking budget; in anthropic.messages mode, disabling this selects adaptive thinking.
thinking_include_budget = true
# zh: 思维链工具调用兼容：在本地历史保留可读 reasoning_content；是否向上游回传由 reasoning_content_replay 控制。
# en: Thinking tool-call compatibility: retain readable reasoning_content locally; reasoning_content_replay controls upstream replay.
thinking_tool_call_compat = true
# zh: 是否原样回传推理结构（Chat 兼容字段、Responses reasoning items/encrypted_content、Anthropic thinking/redacted blocks）。默认开启。
# en: Replay native reasoning structures (Chat compatibility fields, Responses reasoning items/encrypted_content, Anthropic thinking/redacted blocks). Enabled by default.
reasoning_content_replay = true
# zh: 是否将所有 system 提示词合并注入第一条 user 消息（仅 openai.chat_completions）。默认关闭。
# en: Merge all system prompts into the first user message (openai.chat_completions only). Disabled by default.
system_prompt_as_user = false
# zh: Responses API 的 tool_choice 兼容模式：仅在关闭时请求仍返回 500、怀疑上游不兼容对象型 tool_choice 时再尝试开启；开启后上报为 "required" 并只保留目标工具。当前已在 new-api v0.11.4-alpha.3 发现该问题。默认关闭。
# en: Responses API tool_choice compatibility mode: only try enabling this when requests still return 500 with the default setting and you suspect the upstream does not support object-style tool_choice; it sends "required" and keeps only the selected tool. This issue is currently observed on new-api v0.11.4-alpha.3. Disabled by default.
responses_tool_choice_compat = false
# zh: Responses API 续轮强制降级：启用后，多轮工具调用将始终跳过 previous_response_id，直接使用完整消息重放（stateless replay）。仅在上游不兼容 responses 状态续轮时使用。默认关闭。
# en: Responses API force stateless replay: when enabled, multi-turn tool follow-ups always skip previous_response_id and replay the full message history instead. Use only when the upstream does not handle stateful responses follow-ups correctly. Disabled by default.
responses_force_stateless_replay = false
# zh: OpenAI 模式下是否自动生成 prompt_cache_key；Anthropic 模式请通过 request_params.cache_control 配置缓存。
# en: Generate prompt_cache_key in OpenAI modes; use request_params.cache_control for Anthropic caching.
prompt_cache_enabled = true
# zh: 是否对上游模型 API 启用流式请求。
# en: Enable streaming requests to the upstream model API.
stream_enabled = false

# zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
# en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
[models.chat.request_params]

# zh: 模型池配置（可选，支持多模型轮询/随机/用户指定）。
# en: Model pool configuration (optional, supports round-robin/random/user-specified).
[models.chat.pool]
# zh: 是否启用模型池。
# en: Enable model pool.
enabled = false
# zh: 分配策略：default（用户指定）/ round_robin（轮询）/ random（随机）。
# en: Strategy: default (user-specified) / round_robin / random.
strategy = "default"
# zh: 模型池列表（每项需填 model_name、api_url、api_key；可选 use_proxy，默认 false；其余字段可选，缺省继承主模型）。
# en: Model pool entries (model_name, api_url, api_key required; optional use_proxy defaults to false; other fields inherit from primary).
models = []

# zh: 视觉模型配置（用于图片描述和 OCR）。
# en: Vision model config (image description and OCR).
[models.vision]
# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭。
# en: Whether this model uses proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: Provider 基址；OpenAI 兼容接口通常为 .../v1，Anthropic 原生接口可写站点根地址或 .../v1。
# en: Provider base URL; OpenAI-compatible APIs usually use .../v1, while native Anthropic accepts the site root or .../v1.
api_url = ""
# zh: Vision 模型 API Key。
# en: Vision model API key.
api_key = ""
# zh: Vision 模型名称。
# en: Vision model name.
model_name = ""
# zh: Vision 模型最大输出 tokens；OpenAI 模式下非正数会省略上限，Anthropic Messages 要求为正整数。启用 thinking 时需留足思维链和工具调用余量。
# en: Vision model max output tokens; non-positive values omit the limit in OpenAI modes, while Anthropic Messages requires a positive integer. Leave room for reasoning and tool calls when thinking is enabled.
max_tokens = 8192

# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
context_window_tokens = 32768
# zh: 队列发车间隔（秒；<=0 事件驱动立即发车且空闲不扫描，>0 按间隔扫描）。
# en: Queue interval (seconds; <=0 dispatches on arrival without idle polling; >0 polls periodically).
queue_interval_seconds = 1.0
# zh: API 模式：openai.chat_completions、openai.responses 或 anthropic.messages；旧无前缀值仍兼容但已弃用。
# en: API mode: openai.chat_completions, openai.responses, or anthropic.messages. Legacy unprefixed values remain compatible but are deprecated.
api_mode = "openai.chat_completions"
# zh: 是否启用 reasoning.effort。
# en: Enable reasoning.effort.
reasoning_enabled = false
# zh: 自定义 reasoning effort；值为 adaptive 时原样发送 adaptive，其余值也原样透传。
# en: Custom reasoning effort; adaptive is sent as adaptive and every other value is passed through unchanged.
reasoning_effort = "medium"
# zh: 是否发送由 thinking_enabled 自动生成的顶层 thinking 参数；调用方显式 thinking 不受影响。
# en: Send the top-level thinking parameter generated by thinking_enabled; explicit caller overrides are unaffected.
thinking_param_enabled = true
# zh: 是否启用 thinking（思维链）。
# en: Enable thinking (reasoning).
thinking_enabled = false
# zh: thinking 预算 tokens。
# en: Thinking-budget tokens.
thinking_budget_tokens = 20000
# zh: 是否发送手动 thinking 预算；anthropic.messages 下关闭时使用 adaptive thinking。
# en: Send a manual thinking budget; in anthropic.messages mode, disabling this selects adaptive thinking.
thinking_include_budget = true
# zh: 思维链工具调用兼容：在本地历史保留可读 reasoning_content；是否向上游回传由 reasoning_content_replay 控制。
# en: Thinking tool-call compatibility: retain readable reasoning_content locally; reasoning_content_replay controls upstream replay.
thinking_tool_call_compat = true
# zh: 是否原样回传推理结构（Chat 兼容字段、Responses reasoning items/encrypted_content、Anthropic thinking/redacted blocks）。默认开启。
# en: Replay native reasoning structures (Chat compatibility fields, Responses reasoning items/encrypted_content, Anthropic thinking/redacted blocks). Enabled by default.
reasoning_content_replay = true
# zh: 是否将所有 system 提示词合并注入第一条 user 消息（仅 openai.chat_completions）。默认关闭。
# en: Merge all system prompts into the first user message (openai.chat_completions only). Disabled by default.
system_prompt_as_user = false
# zh: Responses API 的 tool_choice 兼容模式：仅在关闭时请求仍返回 500、怀疑上游不兼容对象型 tool_choice 时再尝试开启；开启后上报为 "required" 并只保留目标工具。当前已在 new-api v0.11.4-alpha.3 发现该问题。默认关闭。
# en: Responses API tool_choice compatibility mode: only try enabling this when requests still return 500 with the default setting and you suspect the upstream does not support object-style tool_choice; it sends "required" and keeps only the selected tool. This issue is currently observed on new-api v0.11.4-alpha.3. Disabled by default.
responses_tool_choice_compat = false
# zh: Responses API 续轮强制降级：启用后，多轮工具调用将始终跳过 previous_response_id，直接使用完整消息重放（stateless replay）。仅在上游不兼容 responses 状态续轮时使用。默认关闭。
# en: Responses API force stateless replay: when enabled, multi-turn tool follow-ups always skip previous_response_id and replay the full message history instead. Use only when the upstream does not handle stateful responses follow-ups correctly. Disabled by default.
responses_force_stateless_replay = false
# zh: OpenAI 模式下是否自动生成 prompt_cache_key；Anthropic 模式请通过 request_params.cache_control 配置缓存。
# en: Generate prompt_cache_key in OpenAI modes; use request_params.cache_control for Anthropic caching.
prompt_cache_enabled = true
# zh: 是否对上游模型 API 启用流式请求。
# en: Enable streaming requests to the upstream model API.
stream_enabled = false

# zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
# en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
[models.vision.request_params]

# zh: 安全模型配置（用于防注入检测和注入后回复生成）。
# en: Security model config (injection detection and post-injection responses).
[models.security]
# zh: 是否启用安全模型检测与注入响应（推荐开启）。
# en: Enable security-model detection and injection response (recommended).
enabled = true
# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭。
# en: Whether this model uses proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: Provider 基址；OpenAI 兼容接口通常为 .../v1，Anthropic 原生接口可写站点根地址或 .../v1。
# en: Provider base URL; OpenAI-compatible APIs usually use .../v1, while native Anthropic accepts the site root or .../v1.
api_url = ""
# zh: Security 模型 API Key。
# en: Security model API key.
api_key = ""
# zh: Security 模型名称。
# en: Security model name.
model_name = ""
# zh: 可选限制：OpenAI 模式下非正数会省略上限，Anthropic Messages 要求为正整数。
# en: Optional generation limit; non-positive values omit it in OpenAI modes, while Anthropic Messages requires a positive integer.
max_tokens = 100

# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
context_window_tokens = 8192
# zh: 队列发车间隔（秒；<=0 事件驱动立即发车且空闲不扫描，>0 按间隔扫描）。
# en: Queue interval (seconds; <=0 dispatches on arrival without idle polling; >0 polls periodically).
queue_interval_seconds = 1.0
# zh: API 模式：openai.chat_completions、openai.responses 或 anthropic.messages；旧无前缀值仍兼容但已弃用。
# en: API mode: openai.chat_completions, openai.responses, or anthropic.messages. Legacy unprefixed values remain compatible but are deprecated.
api_mode = "openai.chat_completions"
# zh: 是否启用 reasoning.effort。
# en: Enable reasoning.effort.
reasoning_enabled = false
# zh: 自定义 reasoning effort；值为 adaptive 时原样发送 adaptive，其余值也原样透传。
# en: Custom reasoning effort; adaptive is sent as adaptive and every other value is passed through unchanged.
reasoning_effort = "medium"
# zh: 是否发送由 thinking_enabled 自动生成的顶层 thinking 参数；调用方显式 thinking 不受影响。
# en: Send the top-level thinking parameter generated by thinking_enabled; explicit caller overrides are unaffected.
thinking_param_enabled = true
# zh: 是否启用 thinking（思维链）。
# en: Enable thinking (reasoning).
thinking_enabled = false
# zh: thinking 预算 tokens。
# en: Thinking-budget tokens.
thinking_budget_tokens = 0
# zh: 是否发送手动 thinking 预算；anthropic.messages 下关闭时使用 adaptive thinking。
# en: Send a manual thinking budget; in anthropic.messages mode, disabling this selects adaptive thinking.
thinking_include_budget = true
# zh: 思维链工具调用兼容：在本地历史保留可读 reasoning_content；是否向上游回传由 reasoning_content_replay 控制。
# en: Thinking tool-call compatibility: retain readable reasoning_content locally; reasoning_content_replay controls upstream replay.
thinking_tool_call_compat = true
# zh: 是否原样回传推理结构（Chat 兼容字段、Responses reasoning items/encrypted_content、Anthropic thinking/redacted blocks）。默认开启。
# en: Replay native reasoning structures (Chat compatibility fields, Responses reasoning items/encrypted_content, Anthropic thinking/redacted blocks). Enabled by default.
reasoning_content_replay = true
# zh: 是否将所有 system 提示词合并注入第一条 user 消息（仅 openai.chat_completions）。默认关闭。
# en: Merge all system prompts into the first user message (openai.chat_completions only). Disabled by default.
system_prompt_as_user = false
# zh: Responses API 的 tool_choice 兼容模式：仅在关闭时请求仍返回 500、怀疑上游不兼容对象型 tool_choice 时再尝试开启；开启后上报为 "required" 并只保留目标工具。当前已在 new-api v0.11.4-alpha.3 发现该问题。默认关闭。
# en: Responses API tool_choice compatibility mode: only try enabling this when requests still return 500 with the default setting and you suspect the upstream does not support object-style tool_choice; it sends "required" and keeps only the selected tool. This issue is currently observed on new-api v0.11.4-alpha.3. Disabled by default.
responses_tool_choice_compat = false
# zh: Responses API 续轮强制降级：启用后，多轮工具调用将始终跳过 previous_response_id，直接使用完整消息重放（stateless replay）。仅在上游不兼容 responses 状态续轮时使用。默认关闭。
# en: Responses API force stateless replay: when enabled, multi-turn tool follow-ups always skip previous_response_id and replay the full message history instead. Use only when the upstream does not handle stateful responses follow-ups correctly. Disabled by default.
responses_force_stateless_replay = false
# zh: OpenAI 模式下是否自动生成 prompt_cache_key；Anthropic 模式请通过 request_params.cache_control 配置缓存。
# en: Generate prompt_cache_key in OpenAI modes; use request_params.cache_control for Anthropic caching.
prompt_cache_enabled = true
# zh: 是否对上游模型 API 启用流式请求。
# en: Enable streaming requests to the upstream model API.
stream_enabled = false

# zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
# en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
[models.security.request_params]

# zh: Naga 外发消息审核模型配置（仅用于 Naga 通过 Runtime API 发消息前的内容审核）。
# zh: 若无必要可不填写；未配置时回退到 [models.security]。
# en: Naga outbound moderation model config (used only before Naga sends messages through the Runtime API).
# en: Optional; falls back to [models.security] when omitted.
[models.naga]
# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭；即使回退 [models.security] endpoint，也使用本开关。
# en: Whether this model uses proxy addresses from [proxy]. Disabled by default; this switch is used even when falling back to [models.security].
use_proxy = false
# zh: Provider 基址；OpenAI 兼容接口通常为 .../v1，Anthropic 原生接口可写站点根地址或 .../v1。
# en: Provider base URL; OpenAI-compatible APIs usually use .../v1, while native Anthropic accepts the site root or .../v1.
api_url = ""
# zh: Naga 审核模型 API Key。
# en: Naga moderation model API key.
api_key = ""
# zh: Naga 审核模型名称。
# en: Naga moderation model name.
model_name = ""
# zh: 可选限制：OpenAI 模式下非正数会省略上限，Anthropic Messages 要求为正整数。
# en: Optional generation limit; non-positive values omit it in OpenAI modes, while Anthropic Messages requires a positive integer.
max_tokens = 160

# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
context_window_tokens = 8192
# zh: 队列发车间隔（秒；<=0 事件驱动立即发车且空闲不扫描，>0 按间隔扫描）。
# en: Queue interval (seconds; <=0 dispatches on arrival without idle polling; >0 polls periodically).
queue_interval_seconds = 1.0
# zh: API 模式：openai.chat_completions、openai.responses 或 anthropic.messages；旧无前缀值仍兼容但已弃用。
# en: API mode: openai.chat_completions, openai.responses, or anthropic.messages. Legacy unprefixed values remain compatible but are deprecated.
api_mode = "openai.chat_completions"
# zh: 是否启用 reasoning.effort。
# en: Enable reasoning.effort.
reasoning_enabled = false
# zh: 自定义 reasoning effort；值为 adaptive 时原样发送 adaptive，其余值也原样透传。
# en: Custom reasoning effort; adaptive is sent as adaptive and every other value is passed through unchanged.
reasoning_effort = "medium"
# zh: 是否发送由 thinking_enabled 自动生成的顶层 thinking 参数；调用方显式 thinking 不受影响。
# en: Send the top-level thinking parameter generated by thinking_enabled; explicit caller overrides are unaffected.
thinking_param_enabled = true
# zh: 是否启用 thinking（思维链）。
# en: Enable thinking (reasoning).
thinking_enabled = false
# zh: thinking 预算 tokens。
# en: Thinking-budget tokens.
thinking_budget_tokens = 0
# zh: 是否发送手动 thinking 预算；anthropic.messages 下关闭时使用 adaptive thinking。
# en: Send a manual thinking budget; in anthropic.messages mode, disabling this selects adaptive thinking.
thinking_include_budget = true
# zh: 思维链工具调用兼容：在本地历史保留可读 reasoning_content；是否向上游回传由 reasoning_content_replay 控制。
# en: Thinking tool-call compatibility: retain readable reasoning_content locally; reasoning_content_replay controls upstream replay.
thinking_tool_call_compat = true
# zh: 是否原样回传推理结构（Chat 兼容字段、Responses reasoning items/encrypted_content、Anthropic thinking/redacted blocks）。默认开启。
# en: Replay native reasoning structures (Chat compatibility fields, Responses reasoning items/encrypted_content, Anthropic thinking/redacted blocks). Enabled by default.
reasoning_content_replay = true
# zh: 是否将所有 system 提示词合并注入第一条 user 消息（仅 openai.chat_completions）。默认关闭。
# en: Merge all system prompts into the first user message (openai.chat_completions only). Disabled by default.
system_prompt_as_user = false
# zh: Responses API 的 tool_choice 兼容模式。
# en: Responses API tool_choice compatibility mode.
responses_tool_choice_compat = false
# zh: Responses API 续轮强制降级。
# en: Responses API force stateless replay.
responses_force_stateless_replay = false
# zh: 是否对上游模型 API 启用流式请求。
# en: Enable streaming requests to the upstream model API.
stream_enabled = false

# zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
# en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
[models.naga.request_params]

# zh: Agent 模型配置（用于执行 agents）。
# en: Agent model config (used to run agents).
[models.agent]
# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭；模型池条目需在 entry 内单独配置。
# en: Whether this model uses proxy addresses from [proxy]. Disabled by default; pool entries configure this per entry.
use_proxy = false
# zh: Provider 基址；OpenAI 兼容接口通常为 .../v1，Anthropic 原生接口可写站点根地址或 .../v1。
# en: Provider base URL; OpenAI-compatible APIs usually use .../v1, while native Anthropic accepts the site root or .../v1.
api_url = ""
# zh: Agent 模型 API Key。
# en: Agent model API key.
api_key = ""
# zh: Agent 模型名称。
# en: Agent model name.
model_name = ""
# zh: 可选限制：OpenAI 模式下非正数会省略上限，Anthropic Messages 要求为正整数。
# en: Optional generation limit; non-positive values omit it in OpenAI modes, while Anthropic Messages requires a positive integer.
max_tokens = 4096

# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
context_window_tokens = 32768
# zh: 队列发车间隔（秒；<=0 事件驱动立即发车且空闲不扫描，>0 按间隔扫描）。
# en: Queue interval (seconds; <=0 dispatches on arrival without idle polling; >0 polls periodically).
queue_interval_seconds = 1.0
# zh: API 模式：openai.chat_completions、openai.responses 或 anthropic.messages；旧无前缀值仍兼容但已弃用。
# en: API mode: openai.chat_completions, openai.responses, or anthropic.messages. Legacy unprefixed values remain compatible but are deprecated.
api_mode = "openai.chat_completions"
# zh: 是否启用 reasoning.effort。
# en: Enable reasoning.effort.
reasoning_enabled = false
# zh: 自定义 reasoning effort；值为 adaptive 时原样发送 adaptive，其余值也原样透传。
# en: Custom reasoning effort; adaptive is sent as adaptive and every other value is passed through unchanged.
reasoning_effort = "medium"
# zh: 是否发送由 thinking_enabled 自动生成的顶层 thinking 参数；调用方显式 thinking 不受影响。
# en: Send the top-level thinking parameter generated by thinking_enabled; explicit caller overrides are unaffected.
thinking_param_enabled = true
# zh: 是否启用 thinking（思维链）。
# en: Enable thinking (reasoning).
thinking_enabled = false
# zh: thinking 预算 tokens。
# en: Thinking-budget tokens.
thinking_budget_tokens = 0
# zh: 是否发送手动 thinking 预算；anthropic.messages 下关闭时使用 adaptive thinking。
# en: Send a manual thinking budget; in anthropic.messages mode, disabling this selects adaptive thinking.
thinking_include_budget = true
# zh: 思维链工具调用兼容：在本地历史保留可读 reasoning_content；是否向上游回传由 reasoning_content_replay 控制。
# en: Thinking tool-call compatibility: retain readable reasoning_content locally; reasoning_content_replay controls upstream replay.
thinking_tool_call_compat = true
# zh: 是否原样回传推理结构（Chat 兼容字段、Responses reasoning items/encrypted_content、Anthropic thinking/redacted blocks）。默认开启。
# en: Replay native reasoning structures (Chat compatibility fields, Responses reasoning items/encrypted_content, Anthropic thinking/redacted blocks). Enabled by default.
reasoning_content_replay = true
# zh: 是否将所有 system 提示词合并注入第一条 user 消息（仅 openai.chat_completions）。默认关闭。
# en: Merge all system prompts into the first user message (openai.chat_completions only). Disabled by default.
system_prompt_as_user = false
# zh: Responses API 的 tool_choice 兼容模式：仅在关闭时请求仍返回 500、怀疑上游不兼容对象型 tool_choice 时再尝试开启；开启后上报为 "required" 并只保留目标工具。当前已在 new-api v0.11.4-alpha.3 发现该问题。默认关闭。
# en: Responses API tool_choice compatibility mode: only try enabling this when requests still return 500 with the default setting and you suspect the upstream does not support object-style tool_choice; it sends "required" and keeps only the selected tool. This issue is currently observed on new-api v0.11.4-alpha.3. Disabled by default.
responses_tool_choice_compat = false
# zh: Responses API 续轮强制降级：启用后，多轮工具调用将始终跳过 previous_response_id，直接使用完整消息重放（stateless replay）。仅在上游不兼容 responses 状态续轮时使用。默认关闭。
# en: Responses API force stateless replay: when enabled, multi-turn tool follow-ups always skip previous_response_id and replay the full message history instead. Use only when the upstream does not handle stateful responses follow-ups correctly. Disabled by default.
responses_force_stateless_replay = false
# zh: OpenAI 模式下是否自动生成 prompt_cache_key；Anthropic 模式请通过 request_params.cache_control 配置缓存。
# en: Generate prompt_cache_key in OpenAI modes; use request_params.cache_control for Anthropic caching.
prompt_cache_enabled = true
# zh: 是否对上游模型 API 启用流式请求。
# en: Enable streaming requests to the upstream model API.
stream_enabled = false

# zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
# en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
[models.agent.request_params]

# zh: Agent 模型池配置（可选，支持多模型轮询/随机/用户指定）。
# en: Agent model pool configuration (optional, supports round-robin/random/user-specified).
[models.agent.pool]
# zh: 是否启用 Agent 模型池。
# en: Enable agent model pool.
enabled = false
# zh: 分配策略：default（用户指定）/ round_robin（轮询）/ random（随机）。
# en: Strategy: default (user-specified) / round_robin / random.
strategy = "default"
# zh: Agent 模型池列表（每项需填 model_name、api_url、api_key；可选 use_proxy，默认 false；其余字段可选，缺省继承主模型）。
# en: Agent model pool entries (model_name, api_url, api_key required; optional use_proxy defaults to false; other fields inherit from primary).
models = []

# zh: 史官模型配置（认知记忆后台改写用，未配置时回退到 agent 模型）。
# en: Historian model config (for cognitive memory rewriting, falls back to agent model if unset).
[models.historian]
# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭；即使回退 [models.agent] endpoint，也使用本开关。
# en: Whether this model uses proxy addresses from [proxy]. Disabled by default; this switch is used even when falling back to [models.agent].
use_proxy = false
# zh: Provider 基址；OpenAI 兼容接口通常为 .../v1，Anthropic 原生接口可写站点根地址或 .../v1。
# en: Provider base URL; OpenAI-compatible APIs usually use .../v1, while native Anthropic accepts the site root or .../v1.
api_url = ""
# zh: 史官模型 API Key。
# en: Historian model API key.
api_key = ""
# zh: 史官模型名称。
# en: Historian model name.
model_name = ""
# zh: 可选限制：OpenAI 模式下非正数会省略上限，Anthropic Messages 要求为正整数。
# en: Optional generation limit; non-positive values omit it in OpenAI modes, while Anthropic Messages requires a positive integer.
max_tokens = 4096

# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
context_window_tokens = 32768
# zh: 队列发车间隔（秒；<=0 事件驱动立即发车且空闲不扫描，>0 按间隔扫描）。
# en: Queue interval (seconds; <=0 dispatches on arrival without idle polling; >0 polls periodically).
queue_interval_seconds = 1.0
# zh: API 模式：openai.chat_completions、openai.responses 或 anthropic.messages；旧无前缀值仍兼容但已弃用。
# en: API mode: openai.chat_completions, openai.responses, or anthropic.messages. Legacy unprefixed values remain compatible but are deprecated.
api_mode = "openai.chat_completions"
# zh: 是否启用 reasoning.effort。
# en: Enable reasoning.effort.
reasoning_enabled = false
# zh: 自定义 reasoning effort；值为 adaptive 时原样发送 adaptive，其余值也原样透传。
# en: Custom reasoning effort; adaptive is sent as adaptive and every other value is passed through unchanged.
reasoning_effort = "medium"
# zh: 是否发送由 thinking_enabled 自动生成的顶层 thinking 参数；调用方显式 thinking 不受影响。
# en: Send the top-level thinking parameter generated by thinking_enabled; explicit caller overrides are unaffected.
thinking_param_enabled = true
# zh: 是否启用 thinking（思维链）。
# en: Enable thinking (reasoning).
thinking_enabled = false
# zh: thinking 预算 tokens。
# en: Thinking-budget tokens.
thinking_budget_tokens = 0
# zh: 是否发送手动 thinking 预算；anthropic.messages 下关闭时使用 adaptive thinking。
# en: Send a manual thinking budget; in anthropic.messages mode, disabling this selects adaptive thinking.
thinking_include_budget = true
# zh: 思维链工具调用兼容：在本地历史保留可读 reasoning_content；是否向上游回传由 reasoning_content_replay 控制。
# en: Thinking tool-call compatibility: retain readable reasoning_content locally; reasoning_content_replay controls upstream replay.
thinking_tool_call_compat = true
# zh: 是否原样回传推理结构（Chat 兼容字段、Responses reasoning items/encrypted_content、Anthropic thinking/redacted blocks）。默认开启。
# en: Replay native reasoning structures (Chat compatibility fields, Responses reasoning items/encrypted_content, Anthropic thinking/redacted blocks). Enabled by default.
reasoning_content_replay = true
# zh: 是否将所有 system 提示词合并注入第一条 user 消息（仅 openai.chat_completions）。默认关闭。
# en: Merge all system prompts into the first user message (openai.chat_completions only). Disabled by default.
system_prompt_as_user = false
# zh: Responses API 的 tool_choice 兼容模式：仅在关闭时请求仍返回 500、怀疑上游不兼容对象型 tool_choice 时再尝试开启；开启后上报为 "required" 并只保留目标工具。当前已在 new-api v0.11.4-alpha.3 发现该问题。默认关闭。
# en: Responses API tool_choice compatibility mode: only try enabling this when requests still return 500 with the default setting and you suspect the upstream does not support object-style tool_choice; it sends "required" and keeps only the selected tool. This issue is currently observed on new-api v0.11.4-alpha.3. Disabled by default.
responses_tool_choice_compat = false
# zh: Responses API 续轮强制降级：启用后，多轮工具调用将始终跳过 previous_response_id，直接使用完整消息重放（stateless replay）。仅在上游不兼容 responses 状态续轮时使用。默认关闭。
# en: Responses API force stateless replay: when enabled, multi-turn tool follow-ups always skip previous_response_id and replay the full message history instead. Use only when the upstream does not handle stateful responses follow-ups correctly. Disabled by default.
responses_force_stateless_replay = false
# zh: OpenAI 模式下是否自动生成 prompt_cache_key；Anthropic 模式请通过 request_params.cache_control 配置缓存。
# en: Generate prompt_cache_key in OpenAI modes; use request_params.cache_control for Anthropic caching.
prompt_cache_enabled = true
# zh: 是否对上游模型 API 启用流式请求。
# en: Enable streaming requests to the upstream model API.
stream_enabled = false

# zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
# en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
[models.historian.request_params]

# zh: 消息总结模型配置（/summary /sum 与 SummaryService 专用；未配置时回退到 agent 模型；主 AI 调用 summary_agent 不使用此段配置）。
# en: Message-summary model config (used by /summary, /sum, and SummaryService; falls back to the agent model when unset; summary_agent invoked by the main AI does not use this section).
[models.summary]
# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭；即使回退 [models.agent] endpoint，也使用本开关。
# en: Whether this model uses proxy addresses from [proxy]. Disabled by default; this switch is used even when falling back to [models.agent].
use_proxy = false
# zh: Provider 基址；OpenAI 兼容接口通常为 .../v1，Anthropic 原生接口可写站点根地址或 .../v1。
# en: Provider base URL; OpenAI-compatible APIs usually use .../v1, while native Anthropic accepts the site root or .../v1.
api_url = ""
# zh: 消息总结模型 API Key。
# en: Message-summary model API key.
api_key = ""
# zh: 消息总结模型名称。
# en: Message-summary model name.
model_name = ""
# zh: 可选限制：OpenAI 模式下非正数会省略上限，Anthropic Messages 要求为正整数。
# en: Optional generation limit; non-positive values omit it in OpenAI modes, while Anthropic Messages requires a positive integer.
max_tokens = 4096

# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
context_window_tokens = 32768
# zh: 队列发车间隔（秒；<=0 事件驱动立即发车且空闲不扫描，>0 按间隔扫描）。
# en: Queue interval (seconds; <=0 dispatches on arrival without idle polling; >0 polls periodically).
queue_interval_seconds = 1.0
# zh: API 模式：openai.chat_completions、openai.responses 或 anthropic.messages；旧无前缀值仍兼容但已弃用。
# en: API mode: openai.chat_completions, openai.responses, or anthropic.messages. Legacy unprefixed values remain compatible but are deprecated.
api_mode = "openai.chat_completions"
# zh: 是否启用 reasoning.effort。
# en: Enable reasoning.effort.
reasoning_enabled = false
# zh: 自定义 reasoning effort；值为 adaptive 时原样发送 adaptive，其余值也原样透传。
# en: Custom reasoning effort; adaptive is sent as adaptive and every other value is passed through unchanged.
reasoning_effort = "medium"
# zh: 是否发送由 thinking_enabled 自动生成的顶层 thinking 参数；调用方显式 thinking 不受影响。
# en: Send the top-level thinking parameter generated by thinking_enabled; explicit caller overrides are unaffected.
thinking_param_enabled = true
# zh: 是否启用 thinking（思维链）。
# en: Enable thinking (reasoning).
thinking_enabled = false
# zh: thinking 预算 tokens。
# en: Thinking-budget tokens.
thinking_budget_tokens = 0
# zh: 是否发送手动 thinking 预算；anthropic.messages 下关闭时使用 adaptive thinking。
# en: Send a manual thinking budget; in anthropic.messages mode, disabling this selects adaptive thinking.
thinking_include_budget = true
# zh: 思维链工具调用兼容：在本地历史保留可读 reasoning_content；是否向上游回传由 reasoning_content_replay 控制。
# en: Thinking tool-call compatibility: retain readable reasoning_content locally; reasoning_content_replay controls upstream replay.
thinking_tool_call_compat = true
# zh: 是否原样回传推理结构（Chat 兼容字段、Responses reasoning items/encrypted_content、Anthropic thinking/redacted blocks）。默认开启。
# en: Replay native reasoning structures (Chat compatibility fields, Responses reasoning items/encrypted_content, Anthropic thinking/redacted blocks). Enabled by default.
reasoning_content_replay = true
# zh: 是否将所有 system 提示词合并注入第一条 user 消息（仅 openai.chat_completions）。默认关闭。
# en: Merge all system prompts into the first user message (openai.chat_completions only). Disabled by default.
system_prompt_as_user = false
# zh: Responses API 的 tool_choice 兼容模式：仅在关闭时请求仍返回 500、怀疑上游不兼容对象型 tool_choice 时再尝试开启；开启后上报为 "required" 并只保留目标工具。默认关闭。
# en: Responses API tool_choice compatibility mode: only try enabling this when requests still return 500 with the default setting and you suspect the upstream does not support object-style tool_choice; it sends "required" and keeps only the selected tool. Disabled by default.
responses_tool_choice_compat = false
# zh: Responses API 续轮强制降级：启用后，多轮工具调用将始终跳过 previous_response_id，直接使用完整消息重放（stateless replay）。仅在上游不兼容 responses 状态续轮时使用。默认关闭。
# en: Responses API force stateless replay: when enabled, multi-turn tool follow-ups always skip previous_response_id and replay the full message history instead. Use only when the upstream does not handle stateful responses follow-ups correctly. Disabled by default.
responses_force_stateless_replay = false
# zh: OpenAI 模式下是否自动生成 prompt_cache_key；Anthropic 模式请通过 request_params.cache_control 配置缓存。
# en: Generate prompt_cache_key in OpenAI modes; use request_params.cache_control for Anthropic caching.
prompt_cache_enabled = true
# zh: 是否对上游模型 API 启用流式请求。
# en: Enable streaming requests to the upstream model API.
stream_enabled = false

# zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
# en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
[models.summary.request_params]

# zh: Grok 搜索模型配置（仅供 web_agent 内的 grok_search 使用，支持与其他生成模型相同的 API/推理配置）。
# en: Grok search model config (used only by grok_search inside web_agent, with the same API/reasoning controls as other generation models).
[models.grok]
# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭。
# en: Whether this model uses proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: Provider 基址；格式由 api_mode 决定。
# en: Provider base URL; its shape is determined by api_mode.
api_url = ""
# zh: Grok 搜索模型 API Key。
# en: Grok search model API key.
api_key = ""
# zh: Grok 搜索模型名称。
# en: Grok search model name.
model_name = ""
# zh: 可选限制：OpenAI 模式下非正数会省略上限，Anthropic Messages 要求为正整数。
# en: Optional generation limit; non-positive values omit it in OpenAI modes, while Anthropic Messages requires a positive integer.
max_tokens = 8192

# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
context_window_tokens = 32768
# zh: 队列发车间隔（秒；<=0 事件驱动立即发车且空闲不扫描，>0 按间隔扫描）。
# en: Queue interval (seconds; <=0 dispatches on arrival without idle polling; >0 polls periodically).
queue_interval_seconds = 1.0
# zh: API 模式：openai.chat_completions、openai.responses 或 anthropic.messages；旧无前缀值仍兼容但已弃用。
# en: API mode: openai.chat_completions, openai.responses, or anthropic.messages. Legacy unprefixed values remain compatible but are deprecated.
api_mode = "openai.chat_completions"
# zh: 是否启用 reasoning.effort。
# en: Enable reasoning.effort.
reasoning_enabled = false
# zh: 自定义 reasoning effort；值为 adaptive 时原样发送 adaptive，其余值也原样透传。
# en: Custom reasoning effort; adaptive is sent as adaptive and every other value is passed through unchanged.
reasoning_effort = "medium"
# zh: 是否发送由 thinking_enabled 自动生成的顶层 thinking 参数；调用方显式 thinking 不受影响。
# en: Send the top-level thinking parameter generated by thinking_enabled; explicit caller overrides are unaffected.
thinking_param_enabled = true
# zh: 是否启用 thinking（思维链）。
# en: Enable thinking (reasoning).
thinking_enabled = false
# zh: thinking 预算 tokens。
# en: Thinking-budget tokens.
thinking_budget_tokens = 20000
# zh: 是否发送手动 thinking 预算；anthropic.messages 下关闭时使用 adaptive thinking。
# en: Send a manual thinking budget; in anthropic.messages mode, disabling this selects adaptive thinking.
thinking_include_budget = true
# zh: 思维链工具调用兼容：在本地历史保留可读 reasoning_content；是否向上游回传由 reasoning_content_replay 控制。
# en: Thinking tool-call compatibility: retain readable reasoning_content locally; reasoning_content_replay controls upstream replay.
thinking_tool_call_compat = true
# zh: 是否原样回传推理结构（Chat 兼容字段、Responses reasoning items/encrypted_content、Anthropic thinking/redacted blocks）。默认开启。
# en: Replay native reasoning structures (Chat compatibility fields, Responses reasoning items/encrypted_content, Anthropic thinking/redacted blocks). Enabled by default.
reasoning_content_replay = true
# zh: 是否将所有 system 提示词合并注入第一条 user 消息（仅 openai.chat_completions）。默认关闭。
# en: Merge all system prompts into the first user message (openai.chat_completions only). Disabled by default.
system_prompt_as_user = false
# zh: Responses API 对象型 tool_choice 的兼容开关。默认关闭。
# en: Compatibility switch for object-style Responses API tool_choice. Disabled by default.
responses_tool_choice_compat = false
# zh: Responses API 是否强制使用完整历史 stateless replay。默认关闭。
# en: Force full-history stateless replay for the Responses API. Disabled by default.
responses_force_stateless_replay = false
# zh: OpenAI 模式下是否自动生成 prompt_cache_key；Anthropic 模式请通过 request_params.cache_control 配置缓存。
# en: Generate prompt_cache_key in OpenAI modes; use request_params.cache_control for Anthropic caching.
prompt_cache_enabled = true
# zh: 是否对上游模型 API 启用流式请求。
# en: Enable streaming requests to the upstream model API.
stream_enabled = false

# zh: 额外请求体参数（可选），可用于 temperature 或供应商私有参数。
# en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
[models.grok.request_params]

# zh: 嵌入模型默认配置（知识库 / 认知记忆 / 梗库默认共用；各功能可在下方 features 中单独覆写）。
# en: Default embedding model config (shared by knowledge, cognitive memory and memes by default; override per feature below).
[models.embedding]
# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭。
# en: Whether this model uses proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1。
# en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1.
api_url = ""
# zh: Embedding 模型 API Key。
# en: Embedding model API key.
api_key = ""
# zh: Embedding 模型名称。
# en: Embedding model name.
model_name = ""

# zh: 模型上下文窗口上限（token，可选）；嵌入/重排场景通常保持默认即可。
# en: Model context window cap (tokens, optional); embedding/rerank can usually keep the default.
context_window_tokens = 8192
# zh: 队列发车间隔（秒；<=0 请求到达立即发车，>0 控制发车间隔）。
# en: Queue interval (seconds; <=0 dispatches on arrival; >0 spaces dispatches).
queue_interval_seconds = 0.0
# zh: 向量维度（可选）。0 或留空表示使用模型默认维度。
# en: Embedding dimensions (optional). Use 0/empty to use model defaults.
dimensions = 0
# zh: 查询端指令前缀（可选，Qwen3/BGE 等模型常用）。指令与文本直接拼接，
#     首尾空白与换行原样保留；留空表示不使用指令。
# en: Query instruction prefix (optional, common for Qwen3/BGE-style models).
#     The instruction is concatenated directly with the text, whitespace and
#     newlines preserved; leave empty to disable.
query_instruction = ""
# zh: 文档端指令前缀（可选，E5 等模型常用，例如 "passage: "）。
# en: Document instruction prefix (optional, common for E5-style models, e.g. "passage: ").
document_instruction = ""

# zh: 额外请求体参数（可选），用于 embedding 供应商的扩展字段。
# en: Extra request-body params (optional) for embedding-provider-specific fields.
[models.embedding.request_params]

# zh: 按功能覆写的 embedding 配置。每个功能可完全继承 [models.embedding] 默认配置，
#     也可单独设置并按字段覆写；生效配置完全相同的功能共用一个发车队列。
#     通用哨兵规则：所有字符串字段（api_url / api_key / model_name / 指令前缀）
#     空字符串均表示继承默认配置、无法表达显式清空；数值与 use_proxy 的哨兵见各字段注释。
# en: Per-feature embedding overrides. Each feature either inherits the
#     [models.embedding] defaults or overrides individual fields; features with
#     the same effective config share one dispatch queue.
#     Sentinel rule: empty strings in api_url / api_key / model_name / instruction
#     prefixes all mean "inherit the default" and cannot express an explicit clear;
#     numeric and use_proxy sentinels are documented on each field.

# zh: 按功能覆写示例：知识库（knowledge）。仅 use_default = false 时下方字段生效，取哨兵值仍表示继承默认配置。
# en: Per-feature override example: knowledge base (knowledge). Fields below apply only when use_default = false; sentinel values inherit the defaults.
[models.embedding.features.knowledge]
# zh: 是否完全使用 [models.embedding] 默认配置；true 时本表其余字段全部忽略。
# en: Whether to fully inherit the [models.embedding] defaults; when true, all other fields here are ignored.
use_default = true
# zh: 覆写 API 地址；空字符串表示继承默认配置。
# en: Override API URL; an empty string inherits the default.
api_url = ""
# zh: 覆写 API Key；空字符串表示继承默认配置。
# en: Override API key; an empty string inherits the default.
api_key = ""
# zh: 覆写模型名称；空字符串表示继承默认配置。
# en: Override model name; an empty string inherits the default.
model_name = ""
# zh: 覆写代理开关；"inherit"（或 "default"）表示继承默认配置，也可写 true / false。
# en: Override the proxy switch; "inherit" (or "default") inherits the default, true / false override it.
use_proxy = "inherit"
# zh: 覆写上下文窗口上限（token）；<=0 表示继承默认配置。
# en: Override the context window cap (tokens); <=0 inherits the default.
context_window_tokens = 0
# zh: 覆写队列发车间隔（秒）；<0 表示继承默认配置，0 表示请求到达立即发车。
# en: Override the queue interval (seconds); <0 inherits the default, 0 dispatches on arrival.
queue_interval_seconds = -1.0
# zh: 覆写向量维度；<0 表示继承默认配置，0 表示使用模型默认维度。
# en: Override embedding dimensions; <0 inherits the default, 0 uses the model default.
dimensions = -1
# zh: 覆写查询端指令前缀；空字符串或纯空白都表示继承默认配置。覆写表无法表达
#     「显式清空」——若默认表带前缀而本功能不需要，请把默认前缀留空、只在需要
#     的功能上单独设置。
# en: Override the query instruction prefix; an empty or whitespace-only string
#     inherits the default. Overrides cannot express "explicitly empty" — if the
#     default table has a prefix this feature does not need, keep the default
#     empty and set the prefix only on the features that need it.
query_instruction = ""
# zh: 覆写文档端指令前缀；语义同 query_instruction（空/纯空白 = 继承）。
# en: Override the document instruction prefix; same semantics as query_instruction (empty/whitespace = inherit).
document_instruction = ""

# zh: 覆写额外请求体参数，按 key 合并到默认 request_params 之上（同名以本表为准）。
# en: Override extra request-body params, merged over the default request_params (this table wins).
[models.embedding.features.knowledge.request_params]
# zh: 按功能覆写示例：认知记忆（cognitive）。仅 use_default = false 时下方字段生效，取哨兵值仍表示继承默认配置。
# en: Per-feature override example: cognitive memory (cognitive). Fields below apply only when use_default = false; sentinel values inherit the defaults.
[models.embedding.features.cognitive]
# zh: 是否完全使用 [models.embedding] 默认配置；true 时本表其余字段全部忽略。
# en: Whether to fully inherit the [models.embedding] defaults; when true, all other fields here are ignored.
use_default = true
# zh: 覆写 API 地址；空字符串表示继承默认配置。
# en: Override API URL; an empty string inherits the default.
api_url = ""
# zh: 覆写 API Key；空字符串表示继承默认配置。
# en: Override API key; an empty string inherits the default.
api_key = ""
# zh: 覆写模型名称；空字符串表示继承默认配置。
# en: Override model name; an empty string inherits the default.
model_name = ""
# zh: 覆写代理开关；"inherit"（或 "default"）表示继承默认配置，也可写 true / false。
# en: Override the proxy switch; "inherit" (or "default") inherits the default, true / false override it.
use_proxy = "inherit"
# zh: 覆写上下文窗口上限（token）；<=0 表示继承默认配置。
# en: Override the context window cap (tokens); <=0 inherits the default.
context_window_tokens = 0
# zh: 覆写队列发车间隔（秒）；<0 表示继承默认配置，0 表示请求到达立即发车。
# en: Override the queue interval (seconds); <0 inherits the default, 0 dispatches on arrival.
queue_interval_seconds = -1.0
# zh: 覆写向量维度；<0 表示继承默认配置，0 表示使用模型默认维度。
# en: Override embedding dimensions; <0 inherits the default, 0 uses the model default.
dimensions = -1
# zh: 覆写查询端指令前缀；空字符串或纯空白都表示继承默认配置。覆写表无法表达
#     「显式清空」——若默认表带前缀而本功能不需要，请把默认前缀留空、只在需要
#     的功能上单独设置。
# en: Override the query instruction prefix; an empty or whitespace-only string
#     inherits the default. Overrides cannot express "explicitly empty" — if the
#     default table has a prefix this feature does not need, keep the default
#     empty and set the prefix only on the features that need it.
query_instruction = ""
# zh: 覆写文档端指令前缀；语义同 query_instruction（空/纯空白 = 继承）。
# en: Override the document instruction prefix; same semantics as query_instruction (empty/whitespace = inherit).
document_instruction = ""

# zh: 覆写额外请求体参数，按 key 合并到默认 request_params 之上（同名以本表为准）。
# en: Override extra request-body params, merged over the default request_params (this table wins).
[models.embedding.features.cognitive.request_params]
# zh: 按功能覆写示例：梗库（memes）。仅 use_default = false 时下方字段生效，取哨兵值仍表示继承默认配置。
# en: Per-feature override example: meme library (memes). Fields below apply only when use_default = false; sentinel values inherit the defaults.
[models.embedding.features.memes]
# zh: 是否完全使用 [models.embedding] 默认配置；true 时本表其余字段全部忽略。
# en: Whether to fully inherit the [models.embedding] defaults; when true, all other fields here are ignored.
use_default = true
# zh: 覆写 API 地址；空字符串表示继承默认配置。
# en: Override API URL; an empty string inherits the default.
api_url = ""
# zh: 覆写 API Key；空字符串表示继承默认配置。
# en: Override API key; an empty string inherits the default.
api_key = ""
# zh: 覆写模型名称；空字符串表示继承默认配置。
# en: Override model name; an empty string inherits the default.
model_name = ""
# zh: 覆写代理开关；"inherit"（或 "default"）表示继承默认配置，也可写 true / false。
# en: Override the proxy switch; "inherit" (or "default") inherits the default, true / false override it.
use_proxy = "inherit"
# zh: 覆写上下文窗口上限（token）；<=0 表示继承默认配置。
# en: Override the context window cap (tokens); <=0 inherits the default.
context_window_tokens = 0
# zh: 覆写队列发车间隔（秒）；<0 表示继承默认配置，0 表示请求到达立即发车。
# en: Override the queue interval (seconds); <0 inherits the default, 0 dispatches on arrival.
queue_interval_seconds = -1.0
# zh: 覆写向量维度；<0 表示继承默认配置，0 表示使用模型默认维度。
# en: Override embedding dimensions; <0 inherits the default, 0 uses the model default.
dimensions = -1
# zh: 覆写查询端指令前缀；空字符串或纯空白都表示继承默认配置。覆写表无法表达
#     「显式清空」——若默认表带前缀而本功能不需要，请把默认前缀留空、只在需要
#     的功能上单独设置。
# en: Override the query instruction prefix; an empty or whitespace-only string
#     inherits the default. Overrides cannot express "explicitly empty" — if the
#     default table has a prefix this feature does not need, keep the default
#     empty and set the prefix only on the features that need it.
query_instruction = ""
# zh: 覆写文档端指令前缀；语义同 query_instruction（空/纯空白 = 继承）。
# en: Override the document instruction prefix; same semantics as query_instruction (empty/whitespace = inherit).
document_instruction = ""

# zh: 覆写额外请求体参数，按 key 合并到默认 request_params 之上（同名以本表为准）。
# en: Override extra request-body params, merged over the default request_params (this table wins).
[models.embedding.features.memes.request_params]

# zh: 重排模型配置（知识库二阶段检索使用）。
# en: Rerank model config (used in second-stage knowledge retrieval).
[models.rerank]
# zh: 是否让该模型请求使用 [proxy] 代理地址。默认关闭。
# en: Whether this model uses proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1。
# en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1.
api_url = ""
# zh: Rerank 模型 API Key。
# en: Rerank model API key.
api_key = ""
# zh: Rerank 模型名称。
# en: Rerank model name.
model_name = ""

# zh: 模型上下文窗口上限（token，可选）；嵌入/重排场景通常保持默认即可。
# en: Model context window cap (tokens, optional); embedding/rerank can usually keep the default.
context_window_tokens = 8192
# zh: 队列发车间隔（秒；<=0 请求到达立即发车，>0 控制发车间隔）。
# en: Queue interval (seconds; <=0 dispatches on arrival; >0 spaces dispatches).
queue_interval_seconds = 0.0
# zh: 查询端指令前缀（可选，部分 rerank 模型需要，如 "Instruct: ...\\nQuery: "）。
# en: Query instruction prefix (optional, required by some rerank models, e.g. "Instruct: ...\\nQuery: ").
query_instruction = ""

# zh: 额外请求体参数（可选），用于 rerank 供应商的扩展字段。
# en: Extra request-body params (optional) for rerank-provider-specific fields.
[models.rerank.request_params]

# zh: 生图模型配置（用于 image_gen.provider="models" 时调用 OpenAI 兼容的图片生成接口）。
# en: Image generation model config (used when image_gen.provider="models" to call OpenAI-compatible image generation API).
[models.image_gen]
# zh: 是否让该图片生成模型请求使用 [proxy] 代理地址。默认关闭。
# en: Whether this image-generation model uses proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1（最终请求路径为 /v1/images/generations）。
# en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1 (final request path is /v1/images/generations).
api_url = ""
# zh: API Key。
# en: API key.
api_key = ""
# zh: 模型名称（如 dall-e-3、minimax-image-01 等），空则使用上游默认。
# en: Model name (e.g. dall-e-3, minimax-image-01, etc.), empty uses provider default.
model_name = ""

# zh: 额外请求体参数（可选）。
# en: Extra request-body params (optional).
[models.image_gen.request_params]

# zh: 参考图生图模型配置（用于 ai_draw_one 传入 reference_image_uids 时调用 OpenAI 兼容的图片编辑接口）。
# en: Reference-image generation model config (used when ai_draw_one receives reference_image_uids and calls the OpenAI-compatible image editing API).
[models.image_edit]
# zh: 是否让该图片编辑模型请求使用 [proxy] 代理地址。默认关闭。
# en: Whether this image-edit model uses proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1（最终请求路径为 /v1/images/edits）。
# en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1 (final request path is /v1/images/edits).
api_url = ""
# zh: API Key。
# en: API key.
api_key = ""
# zh: 模型名称，空则回退到 [models.image_gen] 的 model_name。
# en: Model name, empty falls back to [models.image_gen].model_name.
model_name = ""

# zh: 额外请求体参数（可选）。
# en: Extra request-body params (optional).
[models.image_edit.request_params]

# zh: 本地知识库配置。
# en: Local knowledge base settings.
[knowledge]
# zh: 是否启用本地知识库。
# en: Enable local knowledge base.
enabled = false
# zh: 知识库根目录。
# en: Knowledge base root directory.
base_dir = "knowledge"
# zh: 是否定期扫描文本变更。
# en: Periodically scan text changes.
auto_scan = false
# zh: 是否自动执行嵌入。
# en: Automatically run embedding.
auto_embed = false
# zh: 扫描间隔（秒）。
# en: Scan interval (seconds).
scan_interval = 60.0
# zh: 每批嵌入块数。
# en: Embedding batch size.
embed_batch_size = 64
# zh: 每个向量块包含的行数（滑动窗口大小）。
# en: Number of lines per chunk (sliding window size).
chunk_size = 10
# zh: 相邻块重叠的行数。
# en: Overlap lines between adjacent chunks.
chunk_overlap = 2
# zh: 语义搜索默认召回数。
# en: Default semantic retrieval top-k.
default_top_k = 5
# zh: 是否启用语义检索后的重排。
# en: Enable reranking after semantic retrieval.
enable_rerank = false
# zh: 重排后返回条数（必须小于 default_top_k）。
# en: Number of results returned after rerank (must be less than default_top_k).
rerank_top_k = 3

# zh: 日志配置。
# en: Logging settings.
[logging]
# zh: 日志级别（DEBUG/INFO/WARNING/ERROR）。
# en: Log level (DEBUG/INFO/WARNING/ERROR).
level = "INFO"
# zh: 日志文件路径。
# en: Log file path.
# zh: 在 Windows 上建议使用正斜杠，如 D:/logs/bot.log，或使用单引号 'D:\logs\bot.log'，或在双引号中写双反斜杠 "D:\\logs\\bot.log"。
# en: On Windows, prefer "D:/logs/bot.log", or "'D:\logs\bot.log'", or "D:\\logs\\bot.log".
file_path = "logs/bot.log"
# zh: 单个日志文件最大大小（MB）。
# en: Max log file size (MB).
max_size_mb = 10
# zh: 保留日志文件数量。
# en: Log backup count.
backup_count = 5
# zh: 是否输出到终端 TTY（默认关闭，避免后台运行时终端阻塞）。
# en: Enable logging to terminal TTY (default: off, prevents blocking in background runs).
tty_enabled = false
# zh: 是否在日志中输出思维链（默认开启）。
# en: Log thinking output (default: on).
log_thinking = true

# zh: Tools 兼容性（可选）。
# en: Tools compatibility (optional).
# zh: 部分 OpenAI-compatible 网关会对 tools schema 做更严格的校验（尤其是 tools[].function.name / description），可能触发 400。
# en: Some OpenAI-compatible gateways strictly validate tools schema (especially tools[].function.name/description) and may return 400.
[tools]
# zh: 工具名分隔符：当工具原始名称包含 '.'（例如 automation.create / mcp.server.tool）时，发送给模型前会把 '.' 映射为该分隔符。
# en: Tool-name delimiter: map '.' to this delimiter before sending tools to the model.
dot_delimiter = "-_-"
# zh: 是否启用 tools.description 截断。关闭时不会按长度截断，仅做清理/规范化。
# en: Enable truncation for tools.description. If disabled, no length-based truncation is applied.
description_truncate_enabled = false
# zh: description 最大长度（仅在开启 description_truncate_enabled 时生效）。
# en: Description max length (used only when description_truncate_enabled is enabled).
description_max_len = 1024
# zh: 是否输出逐条清洗详情日志（INFO）。
# en: Log per-item sanitization details (INFO).
sanitize_verbose = false
# zh: 日志中 description 预览长度。
# en: Description preview length in logs.
description_preview_len = 160

# zh: 功能开关。
# en: Feature flags.
[features]
# zh: 是否启用 NagaAgent 模式：
# zh: - true: 使用 `res/prompts/undefined_nagaagent.xml`，并向模型暴露/允许调用相关 Agent
# zh: - false: 使用 `res/prompts/undefined.xml`，并隐藏/禁用相关 Agent（避免无关提及）
# en: Enable NagaAgent mode:
# en: - true: use `res/prompts/undefined_nagaagent.xml` and expose related agents
# en: - false: use `res/prompts/undefined.xml` and hide/disable related agents
nagaagent_mode_enabled = false
# zh: 多模型池全局开关（关闭后所有多模型功能禁用，行为与原版一致）。无特殊需求不建议启用。
# en: Global model pool switch. When disabled, all multi-model features are disabled. Not recommended unless you have specific needs.
pool_enabled = false

# zh: 彩蛋功能（可选）。
# en: Easter egg features (optional)
[easter_egg]
# zh: 彩蛋提示发送模式。模式："none"（关闭）/"agent"（主 AI 调用 Agent 时发送）/"tools"（主 AI 或 Agent 调用 Tool 时发送，含虚拟 tool_search）/"clean"（过滤自动预取、send_message、end 等噪声，但提示正常 tool_search）/"all"（包括 Agent 内部调用其子工具即 "agent_tool" 的场景也发送）。默认："none"。
# en: Easter-egg announcement mode. Modes: "none" (off) / "agent" (send when the main AI calls an Agent) / "tools" (send when the main AI or an Agent calls a Tool, including virtual tool_search) / "clean" (filter automatic prefetch, send_message, and end noise while still announcing normal tool_search calls) / "all" (also send when an Agent internally calls its sub-tools, i.e. "agent_tool"). Default: "none".
agent_call_message_enabled = "none"
# zh: 是否启用群聊关键词（"心理委员"）自动回复。
# en: Enable keyword auto-replies("心理委员") in group chats.
keyword_reply_enabled = false
# zh: 是否启用群聊复读功能（连续 N 条相同消息时复读，N 由 repeat_threshold 控制；若期间有 bot 自身发言则重置链）。
# en: Enable repeat feature in group chats (repeat when N consecutive identical messages arrive, N set by repeat_threshold; resets if bot itself sent the same text in between).
repeat_enabled = false
# zh: 复读触发所需的连续相同消息条数（来自不同发送者），范围 2–20，默认 3。
# en: Number of consecutive identical messages (from different senders) required to trigger repeat, range 2–20, default 3.
repeat_threshold = 3
# zh: 复读冷却时间（分钟）。同一内容被复读后，在冷却时间内不再重复复读。0 = 无冷却。问号类消息（?/？）视为等价。
# en: Repeat cooldown (minutes). After repeating the same content, won't repeat it again within this cooldown. 0 = no cooldown. Question marks (?/？) are treated as equivalent.
repeat_cooldown_minutes = 60
# zh: 是否启用倒问号（复读触发时，若消息为问号则发送倒问号 ¿）。
# en: Enable inverted question mark (when repeat triggers on "?" messages, send "¿" instead).
inverted_question_enabled = false

# zh: 同 sender 短时多消息合并器。把同一用户在短时间内连续发送的多条消息合并到同一轮 AI 触发，避免重复回复 / 行为打架。
# en: Same-sender short-window message batcher. Merges several messages a single user sends in quick succession into one AI turn to avoid duplicate replies / conflicting actions.
[message_batcher]
# zh: 是否启用合并器（关闭后所有消息按现行流程逐条触发 AI）。
# en: Enable the batcher (when disabled all messages trigger the AI individually as before).
enabled = true
# zh: 等待窗口（秒）。期间同一用户发的新消息合并到同一批；<= 0 等同于关闭。
# en: Wait window in seconds. New messages from the same sender within this window are merged; <= 0 disables the feature.
window_seconds = 5.0
# zh: 等待策略：extend（每来一条新消息重置 timer，"打字就继续等"）/ fixed（首条到达起定时，期间到达的消息只合并不重置）。
# en: Wait strategy: extend (reset timer on each new message; keeps waiting while the user types) / fixed (timer fixed at the first message; new arrivals only merge but do not reset).
strategy = "extend"
# zh: extend 模式下的硬顶（秒），防止用户一直打字导致永远不发车；0 = 不限制（仅靠 window_seconds + max_messages_per_batch 触发发车）。
# en: Hard cap in seconds for extend mode, prevents the timer from being reset forever; 0 = no limit (rely on window_seconds + max_messages_per_batch).
max_window_seconds = 30.0
# zh: 单批最多消息条数，超出立即发车；0 = 不限制。
# en: Max messages per batch; exceeding triggers immediate dispatch. 0 = no limit.
max_messages_per_batch = 0
# zh: 是否在群聊启用合并。
# en: Enable batching in group chats.
group_enabled = true
# zh: 是否在私聊启用合并。
# en: Enable batching in private chats.
private_enabled = true
# zh: 收到斜杠命令时是否顺便把当前 buffer 一起发出（默认 false：命令独立执行，buffer 继续等到时间到再发）。
# en: When a slash command arrives, also flush the current buffer to the AI (default false: commands are executed independently and the buffer keeps waiting).
flush_on_command = false
# zh: 投机预发送阈值（秒）。0 < pre_send_seconds < window_seconds 时启用：静默到该阈值就提前把当前 batch 发给 LLM 抢时间，但 batch 不结束；T1（window_seconds）才正式结束。0 或 >= window_seconds 视为关闭。
# en: Speculative pre-fire threshold in seconds. Enabled when 0 < pre_send_seconds < window_seconds: once the user has been silent that long, the current batch is dispatched to the LLM early to save latency, while the batch itself only ends at window_seconds. 0 or >= window_seconds disables speculation.
pre_send_seconds = 0.0
# zh: 投机调用已经向用户发出过任何消息后，新消息到达是否仍然取消该 inflight 调用。默认 false（安全：不取消，新消息开新 batch），开启后可能造成重复发送。
# en: Whether to cancel an in-flight speculative LLM call even when it has already sent at least one message to the user. Default false (safe: do not cancel; the new message starts a new batch). Enabling this may cause duplicate replies.
allow_cancel_after_send = false

# zh: 条件驱动自动化（青春版工作流）。消息命中后可接管本轮 AI；时间类仍走 APScheduler。
# en: Condition-driven automations (lightweight workflows). A matching inbound event can consume the AI loop; time triggers still use APScheduler.
[automations]
# zh: 总开关。关闭后不匹配事件、时间任务进入后也会直接跳过。
# en: Master switch. When false, events are not matched and time jobs return immediately.
enabled = true
# zh: 单张图最多节点数（含 start / 分支 / 循环体），建议 30。
# en: Max nodes per graph including start, branches and loop bodies. Suggested 30.
max_nodes = 30
# zh: 同时运行的自动化上限。支持热更新；调小不会取消正在运行的工作流，而是等待并发自然收敛。
# en: Max concurrent automation runs. Hot-reloadable; lowering it lets active runs drain without cancellation.
max_concurrent = 16
# zh: 单个节点超时（秒）。
# en: Per-node timeout in seconds.
node_timeout_seconds = 600.0
# zh: 整张图超时（秒）。
# en: Whole-graph timeout in seconds.
workflow_timeout_seconds = 1200.0
# zh: llm.blank 工具迭代上限。
# en: Max tool-calling iterations for llm.blank nodes.
blank_llm_max_iterations = 100
# zh: 循环迭代上限，默认 25；仅保留下限 1，可按需调大。节点可用 max_iterations 收窄。
# en: Loop iteration cap. Defaults to 25 with a floor of 1 and no built-in maximum. Nodes can lower it via max_iterations.
loop_max_iterations = 25
# zh: 事件类自动化默认冷却（秒）。0 表示不冷却。时间类默认不冷却。
# en: Default cooldown in seconds for event automations. 0 disables cooldown. Time triggers default to no cooldown.
default_cooldown_seconds = 0

# zh: 历史记录配置。
# en: History settings.
[history]
# zh: 每个会话最多保留的消息条数（0 = 无限制，注意内存占用）。
# en: Max messages to keep per conversation (0 = unlimited, mind memory usage).
max_records = 10000
# zh: 工具过滤查询返回的最大消息条数。
# en: Max messages returned by tool filtered queries.
filtered_result_limit = 200
# zh: 工具过滤搜索时扫描的最大消息条数。
# en: Max messages to scan when tools perform filtered searches.
search_scan_limit = 10000
# zh: /summary 按条数拉取时的最大消息条数（可配置，无固定 500 上限；受 max_records 约束）。
# en: Max messages fetched per /summary count request (configurable; no fixed 500 cap; bounded by max_records).
summary_fetch_limit = 1000
# zh: /summary 按时间范围查询时的最大扫描条数（可配置）。
# en: Max messages scanned for /summary time-range queries (configurable).
summary_time_fetch_limit = 5000
# zh: OneBot API 回退获取的最大消息条数。
# en: Max messages to fetch via OneBot API fallback.
onebot_fetch_limit = 10000
# zh: 群分析工具的消息/成员返回上限。
# en: Max messages/members returned by group analysis tools.
group_analysis_limit = 500

# zh: 附件缓存配置。
# en: Attachment cache settings.
[attachments]
# zh: 是否让远程附件下载/回源使用 [proxy] 代理地址。默认关闭。
# en: Whether remote attachment downloads/backfills use proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: 远程附件自动下载并缓存的最大大小（MB）。超过上限或设为 0 时只保留 URL 引用，不下载文件内容。
# en: Max remote attachment size (MB) to download into cache. Above the limit, or 0, keeps only a URL reference.
remote_download_max_size_mb = 25
# zh: 默认拒绝远程附件访问非公网地址。仅为信任的内网媒体服务添加精确 origin（协议、主机、端口），例如 ["http://media.internal:8080"]；不支持路径、凭据或通配符。支持热重载。
# en: Remote attachments reject non-public destinations by default. Allow only trusted private media origins (scheme, host, port), e.g. ["http://media.internal:8080"]. Paths, credentials and wildcards are not supported. Hot-reloadable.
remote_download_allow_private_origins = []
# zh: 附件缓存文件总大小上限（MB）。0 表示不按总容量清理；达到上限时优先删除最旧的本地缓存副本，若记录有 URL 则保留 UID 与 URL 以便后续回源。
# en: Total attachment cache file size limit (MB). 0 disables total-size pruning; when exceeded, oldest local cache copies are removed while URL-backed UIDs keep their URL for later re-download.
cache_max_total_size_mb = 0
# zh: 附件登记记录最大数量。0 表示不限制数量。
# en: Max attachment registry records. 0 disables record-count pruning.
cache_max_records = 2000
# zh: 附件本地缓存最长保留天数。0 表示不按时间清理；有 URL 的记录只删除本地副本并保留 UID/URL，无 URL 的老记录会被删除。
# en: Max local attachment cache age in days. 0 disables age-based pruning; URL-backed records keep UID/URL while their local copy is removed, records without URL are deleted.
cache_max_age_days = 7
# zh: 仅 URL 引用的附件记录最大数量。0 表示不限制。
# en: Max URL-only attachment reference records. 0 disables URL-reference-count pruning.
url_reference_max_records = 2000
# zh: 允许登记的远程附件 URL 最大长度。0 表示不限制长度。
# en: Max remote attachment URL length. 0 disables URL length checks.
url_max_length = 8192

# zh: Skills 热重载配置（可选）。
# en: Skills hot reload settings (optional).
[skills]
# zh: 是否开启 skills 热重载。
# en: Enable skills hot reload.
hot_reload = true
# zh: 扫描间隔（秒）。
# en: Scan interval (seconds).
hot_reload_interval = 2.0
# zh: 去抖时间（秒）。
# en: Debounce time (seconds).
hot_reload_debounce = 0.5
# zh: Agent intro 自动生成（推荐开启）。
# en: Agent intro auto-generation (recommended).
intro_autogen_enabled = true
# zh: 队列发车间隔（秒；<=0 请求到达立即发车）。
# en: Queue interval (seconds; <=0 dispatches on arrival).
intro_autogen_queue_interval = 1.0
# zh: 单次生成最大 token；OpenAI 模式下非正数会省略上限，Anthropic Messages 要求为正整数。
# en: Max tokens per generation; non-positive values omit the limit in OpenAI modes, while Anthropic Messages requires a positive integer.
intro_autogen_max_tokens = 8192
# zh: Hash 缓存路径。
# en: Hash cache path.
intro_hash_path = ".cache/agent_intro_hashes.json"
# zh: 预先执行的工具列表（结果注入 system 消息）。
# en: Prefetch tool list (results injected into system messages).
prefetch_tools = ["get_current_time"]
# zh: 隐藏已预取的工具声明。
# en: Hide prefetched tools from the model's tool list.
prefetch_tools_hide = true
# zh: 是否为主 AI 启用按需工具搜索。关闭时仍向模型暴露完整工具列表。
# en: Enable on-demand tool search for the main AI. When disabled, the full tool list remains exposed.
tool_search_enabled = false
# zh: Tool Search 启用后始终向主 AI 暴露的工具名称。
# en: Tool names always exposed to the main AI when Tool Search is enabled.
tool_search_always_loaded = ["send_message", "end"]
# zh: 单次工具搜索最多加载的匹配数量（最小为 1）。
# en: Maximum matches loaded by one tool search (minimum 1).
tool_search_max_results = 5

# zh: 主 Prompt 固定插槽对应的本地 UTF-8 文件。路径为空时不注入。
# en: Local UTF-8 files mapped to stable main-Prompt slots. Empty paths disable injection.
[prompt.file_includes]
# zh: 插入 <absolute_priority level="P0"> 开头（绝对优先级区块）。
# en: Inserted at the start of the <absolute_priority level="P0"> block.
p0 = ""
# zh: 插入 <core_rules level="P1"> 开头（核心规则区块）。
# en: Inserted at the start of the <core_rules level="P1"> block.
p1 = ""
# zh: 插入 <important_rules level="P2"> 开头（重要规则区块）。
# en: Inserted at the start of the <important_rules level="P2"> block.
p2 = ""
# zh: 插入 <optimization_rules level="P3"> 开头（优化规则区块）。
# en: Inserted at the start of the <optimization_rules level="P3"> block.
p3 = ""
# zh: 插入 <summary> 开头（总结区块）。
# en: Inserted at the start of the <summary> block.
summary = ""

# zh: Prompt 系统信息注入。总开关默认关闭；开启后各子项默认展示，可逐项关闭。
# en: Prompt system information injection. The master switch is disabled by default; enabled sub-items are shown by default and can be disabled individually.
[prompt.system_info]
# zh: 是否把当前运行主机的系统信息注入提示词。默认关闭，避免升级后自动暴露本机信息给模型。
# en: Inject current host system information into prompts. Disabled by default to avoid exposing host data automatically after upgrades.
enabled = false
# zh: 展示操作系统、版本、release 和架构。
# en: Show operating system, version, release, and architecture.
show_os = true
# zh: 展示 Python 与 Undefined 版本。
# en: Show Python and Undefined versions.
show_runtime = true
# zh: 展示主机名。
# en: Show hostname.
show_host = true
# zh: 展示 CPU 型号与物理/逻辑核心数。
# en: Show CPU model and physical/logical core counts.
show_cpu = true
# zh: 展示当前 CPU 总使用率。
# en: Show current total CPU usage.
show_cpu_usage = true
# zh: 展示内存总量、已用量与占用率。
# en: Show memory total, used amount, and usage percentage.
show_memory = true
# zh: 展示 Swap 总量、已用量与占用率。
# en: Show swap total, used amount, and usage percentage.
show_swap = true
# zh: 展示可见磁盘分区、文件系统、容量与占用率。
# en: Show visible disk partitions, filesystem, capacity, and usage percentage.
show_disks = true
# zh: 展示非回环网卡地址与网络收发累计。涉及 IP 信息，公网或共享部署可关闭。
# en: Show non-loopback network addresses and cumulative network I/O. Disable this on public or shared deployments if IP exposure is undesirable.
show_network = true
# zh: 展示 Bot 进程 PID、启动时间、运行时长、RSS 与进程 CPU 占用。
# en: Show bot process PID, start time, uptime, RSS, and process CPU usage.
show_process = true
# zh: 展示系统启动时间与系统运行时长。
# en: Show system boot time and uptime.
show_uptime = true
# zh: 搜索服务配置。
# en: Search service config.
[search]
# zh: 是否让联网搜索和通用信息类 HTTP 工具使用 [proxy] 代理地址。默认关闭。
# en: Whether search and generic information HTTP tools use proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: web_agent 搜索工具优先级。关闭的工具会从可用工具中隐藏；开启后模型按该顺序优先考虑，但不会被代码硬性路由。
# en: Search tool priority for web_agent. Disabled tools are hidden; enabled tools are preferred in this order by prompt guidance, not hard routing.
priority = ["grok_search", "firecrawl_search", "web_search"]
# zh: SearxNG 搜索服务地址，例如 http://127.0.0.1:8849。
# zh: 可用 uv run deploy up --with searxng 一键部署，或连接已有实例（官方说明：https://docs.searxng.org/）；留空时内置 web_search 工具不可用，grok_search / firecrawl_search / crawl_webpage 不受影响。
# en: SearxNG service URL, e.g. http://127.0.0.1:8849.
# en: Deploy with uv run deploy up --with searxng or connect to an existing instance (official guide: https://docs.searxng.org/); when empty the built-in web_search tool is unavailable while grok_search / firecrawl_search / crawl_webpage keep working.
searxng_url = ""
# zh: 是否在 web_agent 中启用 grok_search。关闭时该工具会从 web_agent 工具列表中隐藏。
# en: Enable grok_search in web_agent. When disabled, this tool is hidden from the web_agent tool list.
grok_search_enabled = false
# zh: 是否在 web_agent 中启用 firecrawl_search。默认关闭；关闭时该工具会隐藏。无需自部署 Firecrawl，启用后可使用官方 keyless。
# en: Enable firecrawl_search in web_agent. Disabled by default; when disabled, this tool is hidden. Self-hosting is optional; enable this to use official keyless search.
firecrawl_search_enabled = false

# zh: Firecrawl 搜索服务配置。
# en: Firecrawl search service config.
[search.firecrawl]
# zh: Firecrawl API Key。为空时使用 Firecrawl keyless 搜索；填写后会发送 Authorization: Bearer；自部署实例通常也可留空。
# en: Firecrawl API key. Leave empty for Firecrawl keyless search; when set, Authorization: Bearer is sent; self-hosted instances can usually leave it empty too.
api_key = ""
# zh: Firecrawl API 基础地址。官方地址支持 keyless（API Key 留空，受官方配额与限流限制）或自己的 Key，也可改为自部署实例地址（自托管说明：https://docs.firecrawl.dev/contributing/self-host）。
# en: Firecrawl API base URL. Use the official endpoint with keyless access (empty API key, subject to official quotas and rate limits) or your own key, or point it at a self-hosted instance (self-host guide: https://docs.firecrawl.dev/contributing/self-host).
base_url = "https://api.firecrawl.dev"

# zh: 代理设置（可选）。
# en: Proxy settings (optional).
[proxy]
# zh: 这里只配置代理地址；是否使用代理由各功能段的 use_proxy 单独控制，默认均关闭。
# en: This section only defines proxy addresses; each feature's use_proxy controls usage independently, disabled by default.
# zh: 例如 http://127.0.0.1:7890（也可使用环境变量 "HTTP_PROXY"）。
# en: e.g. http://127.0.0.1:7890 (or use the "HTTP_PROXY" environment variable).
http_proxy = ""
# zh: 例如 http://127.0.0.1:7890（也可使用环境变量 "HTTPS_PROXY"）。
# en: e.g. http://127.0.0.1:7890 (or use the "HTTPS_PROXY" environment variable).
https_proxy = ""

# zh: 网络请求配置（全局默认）。
# en: Network request settings (global defaults).
[network]
# zh: 默认请求超时（秒），用于多数工具的 HTTP 请求。
# en: Default request timeout in seconds for most HTTP tool calls.
request_timeout_seconds = 30.0
# zh: 默认重试次数（0-5）。
# en: Default retry count (0-5).
request_retries = 0

# zh: HTML/Markdown 图片渲染配置。
# en: HTML/Markdown image rendering settings.
[render]
# zh: 是否让 crawl4ai 等网页抓取链路使用 [proxy] 代理地址。HTML/Markdown 浏览器渲染始终离线。默认关闭。
# en: Whether crawl4ai and other web crawling paths use proxy addresses from [proxy]. HTML/Markdown browser rendering is always offline. Disabled by default.
use_proxy = false
# zh: 渲染浏览器最大同时开启数量。0 表示自动：Linux 默认 1，其它平台默认 2。
# en: Max concurrent render browser pages. 0 = auto: Linux defaults to 1, other platforms default to 2.
browser_max_concurrency = 0
# zh: 可选的 Chrome/Chromium 可执行文件路径。留空时优先使用 Playwright 自带浏览器，缺失时再自动查找系统浏览器。
# en: Optional Chrome/Chromium executable path. Empty prefers Playwright's bundled browser, then discovers an installed system browser if missing.
browser_executable_path = ""
# zh: render_html/render_markdown 的 long 布局未显式传 width 时使用的图片宽度上限（像素，320-2048）。页面自身布局更窄时按「内容宽度 + 2×padding」收敛，两侧不留空白。
# en: Upper bound of the long-layout image width when width is omitted (pixels, 320-2048). When the page lays out narrower, the image shrinks to content width + 2×padding so no side whitespace is left.
long_image_default_width = 900
# zh: long 布局未显式传 padding 时使用的内边距（像素，0-160）。
# en: Content padding used by the long layout when padding is omitted (pixels, 0-160).
long_image_default_padding = 28

# zh: HTML 渲染结果缓存：基于 HTML 内容 hash 复用同一张图片，避免重复渲染。
# en: HTML render result cache: reuse rendered images by content hash to skip re-rendering.
[render.cache]
# zh: 是否启用渲染缓存。设为 false 时所有渲染请求都会走 playwright 重新截图。
# en: Whether to enable the render cache. When false, every request re-renders via playwright.
enabled = true
# zh: LRU 条目数上限（>=1）。超过时按 last_accessed_at 淘汰最久未用的条目。
# en: Maximum LRU entries (>=1). Beyond this, the least-recently-used items are evicted.
max_entries = 50
# zh: 缓存总占用上限（MB，>=1）。超过时按 LRU 顺序持续淘汰，直到回到上限以内。
# en: Maximum total cache size (MB, >=1). Evicts in LRU order until within budget.
max_size_mb = 50
# zh: 元数据落盘最小间隔（秒，>=0）。频繁访问期间合并写盘，避免热点 IO。
# en: Minimum interval between metadata flushes (seconds, >=0). Coalesces hot-path writes.
flush_interval_seconds = 2.0

# zh: 第三方 API 基础地址（便于自定义镜像或私有网关）。
# en: Third-party API base URLs (for mirrors or private gateways).
[api_endpoints]
# zh: XXAPI 基础地址。
# en: XXAPI base URL.
xxapi_base_url = "https://v2.xxapi.cn"
# zh: 星之阁 API 基础地址。
# en: Xingzhige API base URL.
xingzhige_base_url = "https://api.xingzhige.com"

# zh: 生图工具配置。
# en: Image generation tool config.
[image_gen]
# zh: 是否让生图工具自身的第三方 HTTP 请求和图片下载使用 [proxy] 代理地址。默认关闭；模型接口另看 [models.image_gen]/[models.image_edit]。
# en: Whether the image tool's third-party HTTP calls and image downloads use proxy addresses from [proxy]. Disabled by default; model APIs use [models.image_gen]/[models.image_edit].
use_proxy = false
# zh: 生图 provider："xingzhige"（免费星之阁 API）或 "models"（使用 [models.image_gen] 配置的 OpenAI 兼容接口）。
# en: Image generation provider: "xingzhige" (free Xingzhige API) or "models" (OpenAI-compatible via [models.image_gen]).
provider = "xingzhige"
# zh: 星之阁模式默认图片比例（仅 provider="xingzhige" 生效）。
# en: Default image size for Xingzhige mode (only effective when provider="xingzhige").
xingzhige_size = "1:1"
# zh: OpenAI 模式图片尺寸（仅 provider="models" 生效；空表示不传，使用上游默认，如 dall-e-3 默认 1024x1024）。
# en: Image size for OpenAI mode (only effective when provider="models"; empty means not sent, using provider default, e.g. dall-e-3 default 1024x1024).
openai_size = ""
# zh: OpenAI 模式图片质量（仅 provider="models" 生效；空表示不传；dall-e-3 支持 standard/hd）。
# en: Image quality for OpenAI mode (only effective when provider="models"; empty means not sent; dall-e-3 supports standard/hd).
openai_quality = ""
# zh: OpenAI 模式图片风格（仅 provider="models" 生效；空表示不传；dall-e-3 支持 vivid/natural）。
# en: Image style for OpenAI mode (only effective when provider="models"; empty means not sent; dall-e-3 supports vivid/natural).
openai_style = ""
# zh: OpenAI 模式请求超时（秒）。
# en: Request timeout for OpenAI mode (seconds).
openai_timeout = 120.0

# zh: XXAPI API 配置。
# en: XXAPI config.
[xxapi]
# zh: XXAPI Token，前往 https://xxapi.cn/ 获取。
# en: XXAPI token; obtain from https://xxapi.cn/.
api_token = ""

# zh: Token 统计归档配置。
# en: Token usage archive settings.
[token_usage]
# zh: 超过该大小压缩归档（MB），<= 0 禁用。
# en: Archive when size exceeds (MB); <= 0 disables.
max_size_mb = 5
# zh: 最多保留归档数量，<= 0 不限制。
# en: Max archive count; <= 0 means unlimited.
max_archives = 30
# zh: 归档总大小上限（MB），<= 0 禁用。
# en: Max total archive size (MB); <= 0 disables.
max_total_mb = 0
# zh: 归档清理模式："delete"（删除最旧，默认）/"merge"（合并最旧，尽量无损）/"none"（不清理，可能无限增长）。
# en: Prune mode: "delete" (default) / "merge" (attempt lossless merge) / "none" (no cleanup).
archive_prune_mode = "delete"

# zh: MCP（Model Context Protocol）配置。
# en: MCP (Model Context Protocol) settings.
[mcp]
# zh: MCP 配置文件路径（相对于工作目录）。
# en: MCP config file path (relative to the working directory).
config_path = "config/mcp.json"

# zh: 消息工具配置。
# en: Message tool settings.
[messages]
# zh: 是否让消息工具的 URL 文件下载使用 [proxy] 代理地址。默认关闭。
# en: Whether message-tool URL file downloads use proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: messages.send_text_file 单文件文本发送大小上限（KB）。默认 512KB（0.5MB）。
# en: Size limit for messages.send_text_file single-text-file uploads (KB). Default 512KB (0.5MB).
send_text_file_max_size_kb = 512
# zh: messages.send_url_file URL 文件发送大小上限（MB）。默认 100MB。
# en: Size limit for messages.send_url_file URL-file uploads (MB). Default 100MB.
send_url_file_max_size_mb = 100

# zh: lxmusic2api 音乐工具集配置。部署及单个/目录多自定义音源说明见 https://github.com/69gg/lxmusic2api
# en: lxmusic2api music toolset. Deployment and single/directory custom-source guide: https://github.com/69gg/lxmusic2api
[lxmusic2api]
# zh: lxmusic2api 服务根地址，不要包含 /v1；末尾斜杠会自动移除。
# en: lxmusic2api service root URL without /v1; a trailing slash is removed automatically.
base_url = "http://127.0.0.1:3000"
# zh: 对应 lxmusic2api [auth].api_key；留空会禁用并隐藏全部 music.* 工具。
# en: Must match lxmusic2api [auth].api_key; blank disables and hides all music.* tools.
api_key = ""

# zh: Bilibili 视频自动提取配置。
# en: Bilibili video auto-extraction settings.
[bilibili]
# zh: 是否让 Bilibili API、短链解析、弹幕和视频流请求使用 [proxy] 代理地址。默认关闭。
# en: Whether Bilibili API, short-link, danmaku, and video stream requests use proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: 是否启用自动提取（检测到B站视频链接/BV号时自动下载并发送）。
# en: Enable auto-extraction (auto-download and send when Bilibili video links/BV IDs are detected).
auto_extract_enabled = false
# zh: B站账号完整 Cookie 字符串（必须粘贴浏览器中的完整内容，不要只填 SESSDATA；建议至少包含 SESSDATA + buvid3 + buvid4，用于通过风控与 WBI 搜索）。
# en: Full Bilibili Cookie string (paste the complete browser cookie; do not provide SESSDATA only. Recommended to include at least SESSDATA + buvid3 + buvid4 for anti-bot checks and WBI search).
cookie = ""
# zh: 首选清晰度: 80=1080P, 64=720P, 32=480P。
# en: Preferred quality: 80=1080P, 64=720P, 32=480P.
prefer_quality = 80
# zh: 最大视频时长（秒），超过则不下载，仅发送信息卡片。0=不限。
# en: Max video duration (seconds); exceeding this sends info card only. 0=unlimited.
max_duration = 600
# zh: 最大文件大小（MB），超过则触发 oversize_strategy。0=不限。
# en: Max file size (MB); triggers oversize_strategy if exceeded. 0=unlimited.
max_file_size = 100
# zh: 超限策略: "downgrade"=降低清晰度重试, "info"=发送封面+标题+简介。
# en: Oversize strategy: "downgrade"=retry at lower quality, "info"=send cover+title+description.
oversize_strategy = "downgrade"
# zh: 是否在自动提取合并转发中附带弹幕。
# en: Include danmaku in the auto-extraction merged-forward message.
danmaku_enabled = true
# zh: 每个内层弹幕合并转发包含的弹幕条数。
# en: Number of danmaku messages per nested forward group.
danmaku_batch_size = 100
# zh: 最多提取多少条弹幕，0=不限。
# en: Max danmaku count to extract. 0=unlimited.
danmaku_max_count = 0
# zh: 自动提取功能的群聊白名单（空=跟随全局 access.allowed_group_ids）。
# en: Group allowlist for auto-extraction (empty = follow global access.allowed_group_ids).
auto_extract_group_ids = []
# zh: 自动提取功能的私聊白名单（空=跟随全局 access.allowed_private_ids）。
# en: Private chat allowlist for auto-extraction (empty = follow global access.allowed_private_ids).
auto_extract_private_ids = []
# zh: 是否在自动提取中处理 B 站图文（opus / 动态）链接。仍需 auto_extract_enabled 打开。
# en: Whether Bilibili opus/dynamic links are handled during auto-extraction. auto_extract_enabled must also be on.
opus_enabled = true
# zh: 单条消息最多自动处理几篇图文。<=0 回退 3，>10 截断到 10。
# en: Max number of opus posts to auto-process from one message. <=0 falls back to 3, >10 is capped to 10.
opus_max_items = 3
# zh: 图文正文里的图文/视频卡片最多再展开几层（每层都是嵌套合并转发）。0=不展开，只给链接；上限 5。
# en: Max nesting depth for opus/video cards inside a post body (each level is a nested forward). 0=link only; capped at 5.
opus_nested_depth = 5
# zh: 单篇图文最多展开多少张嵌套卡片，超出部分降级为一行文本+链接。上限 20。
# en: Max nested cards expanded per post; extras degrade to a single text line with the link. Capped at 20.
opus_nested_max_cards = 8

# zh: 抖音视频自动提取配置。
# en: Douyin video auto-extraction settings.
[douyin]
# zh: 是否让抖音短链解析、share 页、ttid 注册和视频流请求使用 [proxy] 代理地址。默认关闭。
# en: Whether Douyin short-link, share page, ttid registration, and video stream requests use proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: 是否启用自动提取（检测到抖音短链、长链或 aweme_id 时自动下载并发送）。
# en: Enable auto-extraction (auto-download and send when Douyin short links, long links, or aweme IDs are detected).
auto_extract_enabled = false
# zh: 最大视频时长（秒），超过则不下载，仅发送信息卡片。0=不限。
# en: Max video duration (seconds); exceeding this sends info card only. 0=unlimited.
max_duration = 600
# zh: 最大文件大小（MB），超过则仅发送信息卡片。0=不限。
# en: Max file size (MB); exceeding this sends info card only. 0=unlimited.
max_file_size = 100
# zh: 清晰度探测顺序。游客 share 页无 bit_rate 时会按该列表探测 play 端点，并按文件大小去重。
# en: Quality probing order. Visitor share pages lack bit_rate, so play endpoints are probed in this order and deduplicated by file size.
prefer_ratios = ["1080p", "720p", "540p", "360p"]
# zh: 自动提取功能的群聊白名单（空=跟随全局 access.allowed_group_ids）。
# en: Group allowlist for auto-extraction (empty = follow global access.allowed_group_ids).
auto_extract_group_ids = []
# zh: 自动提取功能的私聊白名单（空=跟随全局 access.allowed_private_ids）。
# en: Private chat allowlist for auto-extraction (empty = follow global access.allowed_private_ids).
auto_extract_private_ids = []
# zh: 单条消息最多自动处理几个抖音视频。<=0 回退 3，>10 截断到 10。
# en: Max number of Douyin videos to auto-process from one message. <=0 falls back to 3, >10 is capped to 10.
auto_extract_max_items = 3

# zh: arXiv 论文自动提取配置。
# en: arXiv paper auto-extraction settings.
[arxiv]
# zh: 是否让 arXiv API 和 PDF 下载使用 [proxy] 代理地址。默认关闭。
# en: Whether arXiv API and PDF downloads use proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: 是否启用自动提取（检测到 arXiv 链接 / arXiv:ID / 带 arxiv 关键词的新式编号时自动发送论文信息并尽力附带 PDF）。
# en: Enable auto-extraction (auto-send paper info and best-effort PDF when arXiv links / arXiv:ID / keyword-scoped new-style IDs are detected).
auto_extract_enabled = false
# zh: 最大 PDF 文件大小（MB），超过则不上传 PDF，仅发送论文信息。0=不限。
# en: Max PDF file size (MB); exceeding this skips PDF upload and sends paper info only. 0=unlimited.
max_file_size = 100
# zh: 自动提取功能的群聊白名单（空=跟随全局 access.allowed_group_ids）。
# en: Group allowlist for auto-extraction (empty = follow global access.allowed_group_ids).
auto_extract_group_ids = []
# zh: 自动提取功能的私聊白名单（空=跟随全局 access.allowed_private_ids）。
# en: Private chat allowlist for auto-extraction (empty = follow global access.allowed_private_ids).
auto_extract_private_ids = []
# zh: 单条消息最多自动处理几篇 arXiv 论文。<=0 回退 5。
# en: Max number of arXiv papers to auto-process from one message. <=0 falls back to 5.
auto_extract_max_items = 5
# zh: 论文信息里最多展示多少位作者。<=0 回退 20。
# en: Max number of authors shown in paper info. <=0 falls back to 20.
author_preview_limit = 20
# zh: 论文信息里摘要预览的最大字符数。<=0 回退 1000。
# en: Max summary preview characters in paper info. <=0 falls back to 1000.
summary_preview_chars = 1000

# zh: GitHub 仓库自动提取配置（仅获取 public 仓库信息）。
# en: GitHub repository auto-extraction settings (public repositories only).
[github]
# zh: 是否让 GitHub API 和仓库所有者头像下载使用 [proxy] 代理地址。默认关闭；卡片浏览器保持离线。
# en: Whether GitHub API and repository-owner avatar downloads use proxy addresses from [proxy]. Disabled by default; card rendering stays offline.
use_proxy = false
# zh: 是否启用自动提取（检测到 GitHub 仓库链接或 owner/repo 仓库 ID 时自动发送图片卡片）。
# en: Enable auto-extraction (auto-send an image card when GitHub repository links or owner/repo IDs are detected).
auto_extract_enabled = false
# zh: GitHub API 请求超时（秒）。<=0 回退 10，>60 截断到 60。
# en: GitHub API request timeout (seconds). <=0 falls back to 10, >60 is clamped to 60.
request_timeout_seconds = 10.0
# zh: GitHub API 请求重试次数。仅重试网络/超时异常和 429/5xx 状态码；<0 回退 0，>5 截断到 5。
# en: GitHub API retry count. Retries only network/timeout errors and 429/5xx statuses; <0 falls back to 0, >5 is clamped to 5.
request_retries = 2
# zh: 自动提取功能的群聊白名单（空=跟随全局 access.allowed_group_ids）。
# en: Group allowlist for auto-extraction (empty = follow global access.allowed_group_ids).
auto_extract_group_ids = []
# zh: 自动提取功能的私聊白名单（空=跟随全局 access.allowed_private_ids）。
# en: Private chat allowlist for auto-extraction (empty = follow global access.allowed_private_ids).
auto_extract_private_ids = []
# zh: 单条消息最多自动处理几个 GitHub 仓库。<=0 回退 3，>10 截断到 10。
# en: Max number of GitHub repositories to auto-process from one message. <=0 falls back to 3, >10 is clamped to 10.
auto_extract_max_items = 3

# zh: Code Delivery Agent 配置（代码交付 Agent，在 Docker 容器中编写代码并打包上传）。
# en: Code Delivery Agent settings (writes code in Docker containers and delivers packaged results).
[code_delivery]
# zh: 是否启用 Code Delivery Agent。
# en: Enable Code Delivery Agent.
enabled = true
# zh: 任务根目录（相对于工作目录）。
# en: Task root directory (relative to working directory).
task_root = "data/code_delivery"
# zh: Docker 镜像名称。
# en: Docker image name.
docker_image = "ubuntu:24.04"
# zh: 容器名前缀。
# en: Container name prefix.
container_name_prefix = "code_delivery_"
# zh: 容器名后缀。
# en: Container name suffix.
container_name_suffix = "_runner"
# zh: 命令默认超时时间（秒），0 表示不限时。
# en: Default command timeout (seconds), 0 means no limit.
default_command_timeout_seconds = 0
# zh: 命令输出最大字符数。
# en: Max command output characters.
max_command_output_chars = 20000
# zh: 默认归档格式（zip 或 tar.gz）。
# en: Default archive format (zip or tar.gz).
default_archive_format = "zip"
# zh: 归档文件最大大小（MB）。
# en: Max archive file size (MB).
max_archive_size_mb = 200
# zh: 任务完成后是否清理工作区和容器。
# en: Clean up workspace and container after task completion.
cleanup_on_finish = true
# zh: 启动前是否清理残留工作区和容器。
# en: Clean up leftover workspaces and containers on startup.
cleanup_on_start = true
# zh: 单次 LLM 请求最大连续失败次数（达到后发送失败通知并终止任务）。
# en: Max consecutive LLM failures per request (sends failure notification and terminates task when reached).
llm_max_retries_per_request = 5
# zh: LLM 连续失败时是否向目标发送通知。
# en: Send notification to target on consecutive LLM failures.
notify_on_llm_failure = true
# zh: 容器内存限制（如 "2g", "512m"），留空表示不限制。
# en: Container memory limit (e.g., "2g", "512m"), empty means no limit.
container_memory_limit = ""
# zh: 容器 CPU 限制（如 "2.0", "0.5"），留空表示不限制。
# en: Container CPU limit (e.g., "2.0", "0.5"), empty means no limit.
container_cpu_limit = ""
# zh: 命令黑名单（禁止执行的命令模式列表，支持通配符）。
# en: Command blacklist (list of forbidden command patterns, supports wildcards).
command_blacklist = ["rm -rf /", ":(){ :|:& };:", "mkfs.*", "dd if=/dev/zero"]

# zh: WebUI 设置。仅在使用 `Undefined-webui` 启动 WebUI 时生效；直接运行 `Undefined` 可忽略本段。
# en: WebUI settings. Only used when starting WebUI via `Undefined-webui`; ignore this section if you run `Undefined` directly.
[webui]
# zh: WebUI 监听地址。
# en: WebUI bind host.
url = "127.0.0.1"
# zh: WebUI 端口。
# en: WebUI port.
port = 8787
# zh: WebUI 密码（首次启动必须修改默认值；默认密码无法登录）。
# en: WebUI password (must be changed on first run; default password cannot be used to log in).
password = "changeme"
# zh: WebUI 启动时是否自动启动机器人进程。
# en: Auto-start bot when WebUI starts.
autostart_bot = false
# zh: 每次打开 WebUI 时是否在后台检查 GitHub Release 更新。
# en: Check GitHub Releases for updates in the background whenever WebUI is opened.
check_updates = true

# zh: 微信 ClawBot/iLink 私聊接入。凭据与游标仅写入 state_dir，不写入本配置。
# zh: 关闭时不会创建网络连接；二维码登录只能从管理界面显式发起。
# en: WeChat ClawBot/iLink private-chat integration. Credentials and cursors are
# en: stored under state_dir and never in this configuration file.
# en: No network connection is created when disabled; QR-code login can only be
# en: started explicitly from the management interface.
[weixin]
# zh: 是否启用微信 iLink 接入。关闭时不建立网络连接。
# en: Enable the WeChat iLink integration. No network connection is made when disabled.
enabled = false
# zh: 敏感凭据、游标、绑定、隔离记录和审计记录的存储目录。
# en: Directory for sensitive credentials, cursors, bindings, quarantined peers, and audit records.
state_dir = "data/weixin"
# zh: 单次消息长轮询的超时时间（秒）。
# en: Timeout for each message long-poll request, in seconds.
long_poll_timeout_seconds = 35.0
# zh: 上游提示 token 失效后暂停重试的时间（秒）。
# en: Pause before retrying after the upstream reports a stale token, in seconds.
stale_token_pause_seconds = 3600.0
# zh: 普通请求失败后的重试间隔（秒）。
# en: Retry delay after an ordinary request failure, in seconds.
retry_delay_seconds = 2.0
# zh: 连续失败达到阈值后的退避时间（秒）。
# en: Backoff duration after consecutive failures reach the threshold, in seconds.
failure_backoff_seconds = 30.0
# zh: 进入长退避的连续失败次数阈值。
# en: Consecutive failure threshold for entering the longer backoff.
failures_before_backoff = 3
# zh: 单个入站或出站媒体文件的大小上限（MB）。
# en: Maximum size of one inbound or outbound media file, in MB.
media_max_size_mb = 100
# zh: 单个媒体上传请求遇到临时网络或服务端错误时的最大尝试次数（1-10）。
# en: Maximum attempts for one media upload after transient network or server failures (1-10).
media_upload_attempts = 3
# zh: 单条多项目消息并发上传媒体的上限（1-8）。
# en: Maximum concurrent media uploads for one multi-item message (1-8).
media_upload_concurrency = 3
# zh: 是否优先用 iLink 多项目消息模拟微信合并转发；上游明确拒绝时自动回退为逐段发送。
# en: Prefer iLink multi-item messages for WeChat forward emulation; fall back to sequential sends on explicit rejection.
multi_item_messages_enabled = true
# zh: 单次 iLink 多项目消息最多包含的项目数（1-20）；超出时保持顺序分批。
# en: Maximum items in one iLink multi-item message (1-20); larger forwards are split in order.
multi_item_max_items = 10
# zh: 二维码登录会话的有效期（秒）。
# en: Lifetime of a QR-code login session, in seconds.
login_session_ttl_seconds = 300.0
# zh: 绑定管理员或超级管理员身份时，二次确认 token 的有效期（秒）。
# en: Lifetime of a confirmation token when binding an admin or superadmin identity, in seconds.
privileged_confirmation_ttl_seconds = 300.0
# zh: 最多保留的未知来源隔离记录数。
# en: Maximum number of quarantined unknown-peer records to retain.
pending_max_records = 100
# zh: 最多保留的帐号管理审计记录数。
# en: Maximum number of account-management audit records to retain.
audit_max_records = 1000

# zh: 主进程 Runtime API（供 WebUI/外部系统读取探针、记忆检索、AI Chat 使用）。
# en: Runtime API in the main process (for WebUI/external integrations: probes, memory queries, AI chat).
[api]
# zh: 是否启用 Runtime API。
# en: Enable Runtime API.
enabled = true
# zh: Runtime API 监听地址。
# en: Runtime API bind host.
host = "127.0.0.1"
# zh: Runtime API 端口。
# en: Runtime API port.
port = 8788
# zh: Runtime API 鉴权密钥（通过请求头 X-Undefined-API-Key 传递）。
# en: Runtime API auth key (send via X-Undefined-API-Key header).
auth_key = "changeme"
# zh: 是否暴露 OpenAPI 文档（/openapi.json）。
# en: Expose OpenAPI document (/openapi.json).
openapi_enabled = true
# zh: 是否启用工具调用 API（POST /api/v1/tools/invoke）。
# en: Enable tool invocation API (POST /api/v1/tools/invoke).
tool_invoke_enabled = false
# zh: 暴露的工具范围。可选 "tools"、"toolsets"、"tools+toolsets"、"agents"、"all"。
# en: Tool exposure scope. Options: "tools", "toolsets", "tools+toolsets", "agents", "all".
tool_invoke_expose = "tools+toolsets"
# zh: 工具白名单（非空时覆盖 expose 规则）。
# en: Tool allowlist (overrides expose when non-empty).
tool_invoke_allowlist = []
# zh: 工具黑名单（始终优先于白名单和 expose）。
# en: Tool denylist (always takes priority).
tool_invoke_denylist = []
# zh: 单次工具调用超时（秒）。
# en: Per-invocation timeout in seconds.
tool_invoke_timeout = 120
# zh: 回调请求超时（秒）。
# en: Callback request timeout in seconds.
tool_invoke_callback_timeout = 10
# zh: 是否让工具调用 API 的外部 callback URL 使用 [proxy] 代理地址。默认关闭；不影响 WebUI/Runtime 本机桥接。
# en: Whether external callback URLs for the tool invoke API use proxy addresses from [proxy]. Disabled by default; does not affect WebUI/Runtime loopback calls.
tool_invoke_callback_use_proxy = false

# zh: 认知记忆系统配置。启用后需配置 [models.embedding]，其余参数均有合理默认值。
# en: Cognitive memory system. Requires [models.embedding] when enabled. All other params have sensible defaults.
[cognitive]
# zh: 是否启用认知记忆系统。
# en: Enable cognitive memory system.
enabled = true
# zh: 史官改写时 bot 自身的称呼（仅影响认知记忆中的事件文本，不影响主提示词）。
# en: Bot's display name used by the historian when rewriting events (does not affect the main prompt).
bot_name = "Undefined"

[cognitive.vector_store]
# zh: ChromaDB 向量数据库存储路径。
# en: ChromaDB vector store path.
path = "data/cognitive/chromadb"
# zh: ChromaDB 前台连续处理上限；达到后若有后台/维护任务，会让出一次执行机会。
# en: Max consecutive foreground Chroma operations before one maintenance/background slot is allowed.
scheduler_foreground_burst = 8

[cognitive.query]
# zh: 自动注入上下文时的召回条数。
# en: Number of results to inject automatically.
auto_top_k = 3
# zh: 自动注入检索时每个作用域（scope）的候选扩展倍数（候选数约等于 auto_top_k * 该值）。
# en: Candidate expansion multiplier per retrieval scope in auto injection (candidates ~= auto_top_k * this value).
auto_scope_candidate_multiplier = 2
# zh: 群聊自动检索时，属于当前群的命中额外加权系数（>1 更偏向当前群）。
# en: Extra score multiplier for hits from the current group in group auto retrieval (>1 favors current group).
auto_current_group_boost = 1.15
# zh: 私聊自动检索时，属于当前私聊用户的命中额外加权系数（>1 更偏向当前私聊）。
# en: Extra score multiplier for hits from the current private chat in private auto retrieval (>1 favors current private chat).
auto_current_private_boost = 1.25
# zh: 是否启用认知记忆检索重排（独立于 knowledge.enable_rerank）。
# en: Enable reranking for cognitive memory retrieval (independent of knowledge.enable_rerank).
enable_rerank = true
# zh: 开启认知记忆后，额外注入最近 N 条 end 行动摘要作为短期工作记忆（带时间）；0=禁用。
# en: When cognitive is enabled, also inject last N end action summaries as short-term working memory (with timestamps); 0 disables.
recent_end_summaries_inject_k = 30
# zh: 是否启用事件检索的时间衰减加权（语义相似度基础上对近期记忆轻微加权）。
# en: Enable recency decay weighting for event retrieval (slight boost for recent memories on top of semantic relevance).
time_decay_enabled = true
# zh: 自动注入场景的时间半衰期（天）。值越小，近期权重衰减越快。
# en: Time decay half-life in days for automatic injection. Smaller values decay recency weight faster.
time_decay_half_life_days_auto = 14.0
# zh: 工具检索场景的时间半衰期（天）。通常设置更大以保留长期可回忆性。
# en: Time decay half-life in days for tool search. Usually larger to preserve long-term recall.
time_decay_half_life_days_tool = 60.0
# zh: 时间加权强度（最终得分 = sim × (1 + boost × decay)）。
# en: Recency boost strength (final score = sim × (1 + boost × decay)).
time_decay_boost = 0.2
# zh: 仅当语义相似度不低于该阈值时才施加时间加权，避免“新但不相关”上浮。
# en: Apply recency boost only when semantic similarity is above this threshold, to avoid promoting recent but irrelevant hits.
time_decay_min_similarity = 0.35
# zh: 工具调用时的默认召回条数。
# en: Default top-k for tool calls.
tool_default_top_k = 12
# zh: 用户画像召回条数。
# en: Top-k for profile retrieval.
profile_top_k = 8
# zh: rerank 候选倍数（候选数 = top_k * multiplier，必须 >= 2，否则跳过重排）。
# en: Rerank candidate multiplier (must be >= 2, otherwise reranking is skipped).
rerank_candidate_multiplier = 3

[cognitive.historian]
# zh: 提供给史官的最近消息参考条数（用于实体消歧）；0=禁用。
# en: Number of recent message references for historian disambiguation; 0 disables.
recent_messages_inject_k = 12
# zh: 最近消息参考中每条消息的最大字符数（超出会截断）。
# en: Max characters per recent message reference line (truncated when exceeded).
recent_message_line_max_len = 240
# zh: 触发本轮的“当前消息原文”最大字符数（超出会截断）。
# en: Max characters of the current source message attached to historian jobs.
source_message_max_len = 800
# zh: 队列轮询间隔（秒）。
# en: Queue poll interval (seconds).
poll_interval_seconds = 1.0
# zh: 任务超时时间（秒），超时后重新入队。
# en: Stale job timeout (seconds), re-queued after timeout.
stale_job_timeout_seconds = 300.0
# zh: 史官同时在途处理的任务上限（>=1）；超出后暂停取新任务，避免并发无上限。
# en: Max in-flight historian jobs (>=1); new jobs wait until in-flight drops below it.
max_concurrency = 4

[cognitive.profile]
# zh: 用户画像存储路径。
# en: Profile storage path.
path = "data/cognitive/profiles"
# zh: 保留的历史版本数量。
# en: Number of profile revisions to keep.
revision_keep = 5

[cognitive.queue]
# zh: 队列文件存储路径。
# en: Queue file storage path.
path = "data/cognitive/queues"
# zh: 失败任务最大保留天数。
# en: Max age (days) for failed jobs.
failed_max_age_days = 30
# zh: 失败任务最大文件数。
# en: Max number of failed job files.
failed_max_files = 500
# zh: 每处理多少条任务触发一次失败队列清理。
# en: Failed queue cleanup interval (number of jobs processed).
failed_cleanup_interval = 100
# zh: 单个任务最大自动重试次数（超过后移入 failed，0=不重试）。
# en: Max auto-retries per job before moving to failed (0=no retry).
job_max_retries = 3

[memes]
# zh: 是否启用全局表情包库。
# en: Enable the global meme library.
enabled = true
# zh: 默认查询模式：keyword / semantic / hybrid。
# en: Default query mode: keyword / semantic / hybrid.
query_default_mode = "hybrid"
# zh: 入库前允许处理的原始图片大小上限（字节）。
# en: Max source image size in bytes before ingestion.
max_source_image_bytes = 512000
# zh: 原图持久化目录。
# en: Directory for persisted meme blobs.
blob_dir = "data/memes/blobs"
# zh: 预览图目录（动图会抽首帧预览）。
# en: Directory for preview images (animated images use the first frame).
preview_dir = "data/memes/previews"
# zh: SQLite 元数据文件路径。
# en: SQLite metadata database path.
db_path = "data/memes/memes.sqlite3"
# zh: 向量索引目录。
# en: Vector index directory.
vector_store_path = "data/memes/chromadb"
# zh: 后台任务队列目录。
# en: Background queue directory.
queue_path = "data/memes/queues"
# zh: 表情包条目上限。
# en: Max number of meme items.
max_items = 10000
# zh: 表情包总磁盘占用上限（字节）。
# en: Max total on-disk bytes for meme blobs.
max_total_bytes = 5368709120
# zh: 是否允许 GIF 入库。
# en: Whether GIF files are allowed.
allow_gif = true
# zh: GIF 分析模式：grid（多帧拼接为网格图）或 multi（多帧分开发送给模型）。
# en: GIF analysis mode: grid (composite frames into grid) or multi (send frames separately).
gif_analysis_mode = "grid"
# zh: GIF 分析帧数（包括首末帧，均匀采样）。
# en: Number of frames to extract for GIF analysis (including first/last, evenly sampled).
gif_analysis_frames = 6
# zh: 是否自动处理群聊图片。
# en: Auto-ingest group chat images.
auto_ingest_group = true
# zh: 是否自动处理私聊图片。
# en: Auto-ingest private chat images.
auto_ingest_private = true
# zh: 关键词召回候选数。
# en: Keyword recall candidate count.
keyword_top_k = 30
# zh: 语义召回候选数。
# en: Semantic recall candidate count.
semantic_top_k = 30
# zh: 重排候选数。
# en: Rerank candidate count.
rerank_top_k = 20

# zh: Naga 外部网关集成配置。
# zh: 开关分层：
# zh:   - [features].nagaagent_mode_enabled — 进程总闸：是否具备 NagaAgent AI 能力（提示词/工具）
# zh:   - [naga].enabled — 进程总闸：外部网关集成（回调 API、/naga 命令、绑定管理）
# zh:   - [naga].mode + 群/私聊名单 — 会话级策略（对齐 [access]）
# zh: 仅当 AI/网关总闸打开后，才按 mode 名单决定具体群/私聊是否启用。
# zh: 若只需 NagaAgent 解答能力而不需要外部回调联动，可只开启 nagaagent_mode_enabled。
# zh: ⚠️ 此功能面向与 NagaAgent 对接的高级场景，普通用户不建议开启。
# en: Naga external gateway integration settings.
# en: Switch hierarchy:
# en:   - [features].nagaagent_mode_enabled — process master: NagaAgent AI capability (prompt/tools)
# en:   - [naga].enabled — process master: external gateway (callback API, /naga, bindings)
# en:   - [naga].mode + group/private lists — per-session policy (aligned with [access])
# en: After masters are on, mode lists decide which group/private sessions are active.
# en: To get NagaAgent answering without external callbacks, only enable nagaagent_mode_enabled.
# en: ⚠️ Advanced feature for NagaAgent integration. Not recommended for regular users.
[naga]
# zh: 是否让 Naga 外部网关 HTTP 请求使用 [proxy] 代理地址。默认关闭。
# en: Whether Naga external-gateway HTTP requests use proxy addresses from [proxy]. Disabled by default.
use_proxy = false
# zh: 是否启用外部网关集成（/naga bind/unbind、远端绑定回调、消息发送、解绑 API）。
# zh: 需同时开启 [features].nagaagent_mode_enabled 才生效。
# en: Enable external gateway integration (/naga bind/unbind, bind callback, message send, unbind API).
# en: Requires [features].nagaagent_mode_enabled = true to take effect.
enabled = false
# zh: Naga 服务器 API 地址。
# en: Naga server API URL.
api_url = ""
# zh: 双方共享密钥（Undefined ↔ Naga 身份验证）。
# en: Shared secret key for authentication between Undefined and Naga.
api_key = ""
# zh: 是否启用 Naga 外发消息审核。
# zh: 关闭后 /api/v1/naga/messages/send 会直接跳过本地审核，返回 moderation.status=skipped_disabled。
# en: Whether to enable Naga outbound message moderation.
# en: When disabled, /api/v1/naga/messages/send skips local moderation and returns moderation.status=skipped_disabled.
moderation_enabled = true
# zh: Naga 会话级访问控制模式：off / blacklist / allowlist（语义对齐 [access]）。
# zh: - off: 不按名单过滤；总闸打开后所有群/私聊会话可用
# zh: - blacklist: 仅拦截 blocked_* 名单
# zh: - allowlist: 仅放行 allowed_*；某维度列表为空表示该维度全部拒绝（fail closed）
# en: Naga per-session access mode: off / blacklist / allowlist.
# en: - off: no list filtering; all sessions allowed when masters are on
# en: - blacklist: block blocked_* only
# en: - allowlist: allow allowed_* only; empty list for a dimension denies all (fail closed)
mode = "off"
# zh: 群号白名单（allowlist 模式生效；留空 = 拒绝全部群）。
# en: Allowed group IDs (allowlist mode; empty = deny all groups).
allowed_group_ids = []
# zh: 群号黑名单（blacklist 模式生效）。
# en: Blocked group IDs (blacklist mode).
blocked_group_ids = []
# zh: 私聊 QQ 白名单（allowlist 模式生效；留空 = 拒绝全部私聊）。
# en: Allowed private-chat user IDs (allowlist mode; empty = deny all private chats).
allowed_private_ids = []
# zh: 私聊 QQ 黑名单（blacklist 模式生效）。
# en: Blocked private-chat user IDs (blacklist mode).
blocked_private_ids = []