渠道访问、配对与操作员

分开控制私聊、群准入、群成员和共享会话管理权限。

This page has not been translated into English yet. The original Chinese version is shown below.

渠道访问分四层：私聊政策、群准入、群成员、共享会话操作员。私聊白名单与 user pairing 不自动授权或限制群成员，进入群也不会自动成为 operator。

私聊政策

privatePolicy 可为 disabled、allowlist、pairing、open。disabled 不创建配对请求；allowlist 仅顶层 allowedUsers；pairing 允许该名单中的人直接访问，其他人需本地批准；open 允许任何能发送私聊的人。

新建受管理渠道默认 pairing，但具体适配器可有例外。旧配置显式 privatePolicy 优先，否则 dmPolicy:disabled 禁用私聊，再由 senderPolicy 提供政策，默认 allowlist。旧键仅为私聊兼容，不影响群成员。

未知私聊发送者获得八字符大写码，不含易混淆的 0/O/1/I，一小时过期。每渠道最多三个待批准请求，每发送者最多一个；私聊与群请求共用这个队列。

qwen channel pairing list team-bot
qwen channel pairing approve team-bot CODE

在渠道工作区运行，或提供 --cwd。批准存于 ~/.qwen/channels//-allowlist.json，同名渠道在不同工作区不共享配对。

群 pairing 要主动 @ 或回复才创建请求，未提及消息即使 requireMention:false 也不会申请。顶层 allowedUsers 中的人免用户配对，但所在未知群仍需群配对。

已准入群的 senders 默认 open，任何成员都能发起任务。限制成员应设 groups 中 senders:allowlist 与该组 allowedUsers。senders 不接受 pairing，避免把群内成员审批误变成私聊授权。

每个组按字段继承具体组、*、适用渠道默认及内置默认；数组整体替换，allowedUsers:[] 不与上层合并。requireMention 默认 true，某些平台只推送提及消息，关闭设置也无法得到平台没发送的消息。

chat_thread、single，以及旧 thread 的群会话共享上下文。/approve、/deny、/cancel、/clear、/who、/status、/loop、/btw 和忙时 steering 等影响所有参与者的操作需要 operators。

operators 省略或空数组不授权任何共享操作员。Operator 仍需通过正常准入；其他成员的消息排队而不 steering。非共享会话归属本发送者，发送者可管理自己的会话。

single 会让渠道内私聊和群共用历史，开放群也可能使群成员看到此前私聊上下文。群配对不应被理解为每个成员已独立审查。

groupHistoryLimit 省略或 0 关闭，正数缓存未触发任务的群消息供下次真实提及使用。只保存已准入群中符合成员政策的消息，群级值可覆盖渠道值。

历史以 JSONL 保存在 QWEN_HOME 的 channels 下，注入为不可信上下文，不作为独立会话轮次。senders:open 同时扩大被记录的成员范围。GitHub/GitLab 配对按仓库/项目路径，重命名、迁移或删除后需撤销旧批准，避免同名路径的新实体继承。