e9a31337bf
变更项：\n1. 新增 MaiBotAdapter.log_level 配置项，支持 INFO/DEBUG，默认非法值自动回落 INFO。\n2. 在插件内新增 _log_runtime 方法，根据 log_level 动态输出运行日志级别，便于在不改全局日志配置的情况下单独拉高该插件观测粒度。\n3. 将适配器关键运行日志（初始化、连接、收发包、ACK、路由判定、入队、回复决策）统一接入 _log_runtime。\n4. 在插件配置中增加详细中文注释，并按你的要求将 log_level 设为 DEBUG。
111 lines
4.8 KiB
TOML
111 lines
4.8 KiB
TOML
[MaiBotAdapter]
|
||
enable = true
|
||
|
||
# 插件日志级别：
|
||
# 1. INFO：输出关键生命周期与异常信息，日志量更小；
|
||
# 2. DEBUG：输出完整运行细节（入队、路由判定、收发包、ACK 等）；
|
||
# 3. 你当前要求查看更细日志，默认改为 DEBUG。
|
||
log_level = "DEBUG"
|
||
|
||
# 是否默认采集群消息到 MaiBot：
|
||
# 1. 这是“把消息送给 MaiBot 做上下文与记忆”的总开关；
|
||
# 2. 关闭后，群消息不会再进入 MaiBot；
|
||
# 3. 这个开关只影响采集，不影响 MaiBot 已经生成中的历史任务。
|
||
collect_group_messages = true
|
||
|
||
# 是否默认采集私聊消息到 MaiBot：
|
||
# 1. 打开后，私聊也会进入 MaiBot 的上下文链路；
|
||
# 2. 如果你暂时只想把 MaiBot 当群聊人格，就可以先关掉；
|
||
# 3. 当前按你的要求默认开启“全量采集”能力。
|
||
collect_private_messages = true
|
||
|
||
# 是否允许把 MaiBot 的回复真正发回微信：
|
||
# 1. true 表示 MaiBot 不仅接收消息，也可以实际参与说话；
|
||
# 2. false 表示只做上下文采集与记忆沉淀，不做回声输出；
|
||
# 3. 这是你要求的“采集默认开启，回复单独用开关控制”的核心开关。
|
||
enable_reply_output = true
|
||
|
||
# 是否允许 MaiBot 往群里回复：
|
||
# 1. 只影响群输出，不影响群消息采集；
|
||
# 2. 如果你希望先观察 MaiBot 记忆效果、不让它插话，可以改成 false；
|
||
# 3. 与 enable_reply_output 共同生效。
|
||
reply_group_messages = true
|
||
|
||
# 是否允许 MaiBot 往私聊里回复：
|
||
# 1. 只影响私聊输出，不影响私聊消息采集；
|
||
# 2. 如果你担心它先在私聊里误触发，可以单独关闭；
|
||
# 3. 与 enable_reply_output 共同生效。
|
||
reply_private_messages = true
|
||
|
||
# 群功能开关是否参与“能不能往群里说话”的判断：
|
||
# 1. true：继续复用 abot 现有的群功能权限体系；
|
||
# 2. false：只要 enable_reply_output/reply_group_messages 打开，就允许 MaiBot 在群里说话；
|
||
# 3. 无论 true 还是 false，消息都会照常采集并发送给 MaiBot。
|
||
respect_group_feature_switch = true
|
||
|
||
# 群回复时是否自动 @ 触发者：
|
||
# 1. false：直接发普通文本，更像群里自然插话；
|
||
# 2. true：会尝试 @ 原发言人，更适合点对点回应；
|
||
# 3. 当前默认 false，更贴近“参与聊天”的体验。
|
||
mention_user_on_group_reply = false
|
||
|
||
# MaiBot 官方 API Server 的 WebSocket 地址：
|
||
# 1. 这里必须填官方 API Server 暴露出来的 /ws；
|
||
# 2. 当前远端部署已经映射为 18009 -> 8090；
|
||
# 3. 不再使用 WebUI 的 /api/webui/ws-token 和 /api/webui/ws。
|
||
api_server_ws_url = "ws://192.168.2.240:18009/ws"
|
||
|
||
# MaiBot API Server 的 api_key：
|
||
# 1. 这个值会进入握手头 x-apikey 和消息维度 message_dim.api_key；
|
||
# 2. MaiBot 服务端会基于它做用户路由与会话归属；
|
||
# 3. 当前远端为了联调方便允许空列表校验，但客户端这里依旧建议明确填入一个稳定值。
|
||
api_key = "abot-maibot"
|
||
|
||
# 平台名：
|
||
# 1. 会进入握手头 x-platform；
|
||
# 2. 也会进入 message_info.platform 与 message_dim.platform；
|
||
# 3. 建议保持稳定，后续日志、路由和排障都会更清晰。
|
||
platform_name = "abot-maibot"
|
||
|
||
# 是否校验 SSL 证书：
|
||
# 1. 当前局域网 http/ws 直连场景保持 true 也不会有问题；
|
||
# 2. 如果以后切成 wss 且用自签名证书，可临时改成 false；
|
||
# 3. 生产上仍建议优先使用有效证书。
|
||
verify_ssl = true
|
||
|
||
# 建连超时（秒）：
|
||
# 1. 控制首次连接和重连时的握手超时；
|
||
# 2. 局域网场景通常 10~15 秒足够；
|
||
# 3. 太短容易误判网络抖动，太长则故障恢复慢。
|
||
connect_timeout = 15
|
||
|
||
# 接收超时（秒）：
|
||
# 1. 长连接空闲时不代表异常，因此这里要比 connect_timeout 大很多；
|
||
# 2. aiohttp 会结合 heartbeat 做活性检测；
|
||
# 3. 当前默认 120 秒，适合持续在线聊天场景。
|
||
receive_timeout = 120
|
||
|
||
# 心跳间隔（秒）：
|
||
# 1. 用于保持官方 API Server 长连接活性；
|
||
# 2. 太短会增加无意义流量，太长会让断线发现变慢；
|
||
# 3. 当前默认 20 秒，与 maim_message 默认配置接近。
|
||
heartbeat_interval = 20
|
||
|
||
# 重连间隔（秒）：
|
||
# 1. 长连接断开后，这里控制多久再尝试重连；
|
||
# 2. 当前默认 5 秒，适合局域网服务；
|
||
# 3. 如果后面网络更不稳定，可以适当调大。
|
||
reconnect_delay = 5
|
||
|
||
# 本地待发送消息队列长度：
|
||
# 1. 这是 abot -> MaiBot 的缓冲区；
|
||
# 2. 队列满了以后，新消息会直接丢弃并打印详细日志；
|
||
# 3. 默认 500，足够覆盖绝大多数群聊高峰。
|
||
queue_maxsize = 500
|
||
|
||
# 单条消息发送到 MaiBot 的最大重试次数：
|
||
# 1. 只处理瞬时断线这类临时故障；
|
||
# 2. 超过次数后会落日志并丢弃，避免消息永久堆积；
|
||
# 3. 当前默认 3 次，兼顾稳定性与可控性。
|
||
max_send_retries = 3
|