channels.toml 参考
~/.yachiyo/channels.toml 装着频道凭据和调参，与 config.toml 分开存放，机器人 token 永远不会和其他设置混在一起。
这里的键是 snake_case，和 config.toml 不同。
[telegram]
Section titled “[telegram]”| 键 | 类型 | 说明 |
|---|---|---|
enabled | boolean | Telegram 机器人是否运行 |
bot_token | string | @BotFather 给的 token |
model_provider、model_name | string | Telegram 线程的可选模型覆盖 |
[telegram.group] | table | 群讨论设置 —— 见下 |
NapCatQQ over OneBot v11。
| 键 | 类型 | 说明 |
|---|---|---|
enabled | boolean | QQ 机器人是否运行 |
ws_url | string | NapCatQQ 正向 WebSocket，如 ws://localhost:3001 |
token | string | WS 连接的可选鉴权 token |
model_provider、model_name | string | 可选模型覆盖 |
[qq.group] | table | 群讨论设置 |
[discord]
Section titled “[discord]”| 键 | 类型 | 说明 |
|---|---|---|
enabled | boolean | Discord 机器人是否运行 |
bot_token | string | Discord 开发者门户给的 token |
model_provider、model_name | string | 可选模型覆盖 |
[discord.group] | table | 服务器文字频道的群讨论设置 |
[qqbot]
Section titled “[qqbot]”QQ 官方 Bot API。仅私聊 —— 没有群支持。
| 键 | 类型 | 说明 |
|---|---|---|
enabled | boolean | QQ 官方机器人是否运行 |
app_id | string | QQ 开放平台的 App ID |
client_secret | string | 客户端密钥 |
model_provider、model_name | string | 可选模型覆盖 |
私聊思考档位
Section titled “私聊思考档位”[telegram]、[qq]、[discord] 和 [qqbot] 可设置可选的 reasoning_effort，
对应 DM model 旁的 Effort。它对 owner 和 guest 私聊生效，与群聊档位独立。
修改后下一次请求使用新档位，不重启服务、不清空历史。
Default 表示不覆盖，沿用会话原有的思考设置。平台档位不会改写会话保存的偏好。 Owner 私聊仍保留自己的会话模型；如果该模型不支持所选档位，则忽略这项覆盖， 不会为了套用档位而更换模型。
[<platform>.group]
Section titled “[<platform>.group]”按平台的群讨论设置。telegram、qq 和 discord 都有。
| 键 | 类型 | 默认 | 说明 |
|---|---|---|---|
enabled | boolean | —— | 该平台上是否运行群讨论 |
mode | string | probe | probe 自动跟随群聊；mention 仅在直接 @ 当前机器人账号时触发 |
model_provider、model_name | string | 工具模型 | 群探针使用的模型 |
vision | boolean | false | 把群里的图片传给探针模型 |
active_check_interval_ms | number | 60000 | 活跃阶段的探针间隔 |
engaged_check_interval_ms | number | 30000 | 参与阶段的探针间隔 |
wake_buffer_ms | number | 60000 | 有新活动时唤醒前的延迟 |
dormancy_miss_count | number | 3 | 掉回休眠前的静默检查次数 |
disengage_miss_count | number | 3 | 离开参与状态前的静默检查次数 |
probe_adapter、probe_adapter_provider、probe_adapter_model | string | —— | 无头探针适配器覆盖 |
两种模式共用会话历史和压缩摘要。在设置中保存 Probe/Mention 或 Effort 切换时， 不会重启频道服务或打断当前回复；其他配置变化仍可能触发服务重启。
平台的 group 配置段可设置 reasoning_effort，只覆盖群聊回复的思考档位。
Group model 旁的 Effort 显示该模型已启用的选项，Default 表示不设置覆盖。
DeepSeek V4 支持 Off、Low、High 和 Max；Off 会显式关闭服务端思考。
更换群聊模型时会清除档位覆盖。无头 Claude Code 适配器不显示此选择器。
群聊缓冲最多保留最近 100 条记录，不设短时间截断。每轮仅追加尚未看过的消息， 新会话则从已有缓冲窗口开始。Mention 模式下，普通消息只进入本地缓冲， 不调用回复模型；图片被选入某轮上下文时才进行描述，仍受图片转文字设置控制。 这是本地缓冲，不会补拉服务离线期间的群消息。
[privacy]
Section titled “[privacy]”| 键 | 类型 | 说明 |
|---|---|---|
guest_instruction | string | 注入到访客对话系统提示词里的自定义上下文 |
memory_filter_keywords | string[] | 含这些关键词的记忆结果对访客隐藏 |
[image_to_text]
Section titled “[image_to_text]”| 键 | 类型 | 默认 | 说明 |
|---|---|---|---|
enabled | boolean | false | 预先把群消息里的图片描述成替代文本 |
跨平台生效的顶层键；两边都设了的时候，按平台的值胜出。
| 键 | 类型 | 默认 | 说明 |
|---|---|---|---|
check_interval_ms | number | —— | 活跃阶段探针间隔的全局覆盖 |
dm_compact_token_threshold_k | number | 64 | 私聊上下文预算，单位千 token |
group_context_window_k | number | 64 | 群探针滑动窗口，单位千 token |
group_handoff_threshold_k | number | 2 × group_context_window_k | 探针线程超过这个大小后，较早的记录会被总结成滚动交接 |
rewrite_model_provider、rewrite_model_name | string | —— | 把发出的群回复改写成人格语气的模型。不设则按生成的原样发出。 |
交接阈值的下限是上下文窗口的两倍 —— 那段空隙就是迟滞，好让一个长期运行的群不会每一轮都重新总结。
- 频道 —— 配置与访客模型
yachiyo channel—— 查看用户和群组