管理员转交 / 点歌
触发条件
管理员（owner 或 admin 列表内的人）说下面这类话，就走传话箱：
- 「转告 dsh……」
- 「帮我放进传话箱」「放行传话箱」「交给 dsh 做」
- 「让 dsh 去……」
- 「唱首歌」「点歌」「用 ACE 生成一首歌」「生成唱歌」
- 任何需要本机 ACE、worker、DSH 主会话才能完成的事
普通说话语音（「发条语音」「说句话」）仍然用 qq_speak，不要走传话箱。
代发私信（替本人给别人发消息）
触发：「你去私信一下 X」「帮我跟 X 说……」「给 X 发条消息说……」——对象是另一个好友，不是回当前会话。
仍然用 qq_dsh_inbox，但 text 写成一行 私信 <QQ号> <内容>：
text私信 100000002 晚上一起吃饭吗，六点老地方。
桥接看到 私信 <5~12 位 QQ 号> 开头，会直接代发出去（不再转给 DSH）；返回里带 relay 字段就说明已经发出。发完回一句「发了」即可。
规矩：
- 不要用
qq_send_private_message发给别的会话——agent token 是按会话签发的，跨会话必失败（报「agent token 无效」）。这是它以前做不成这件事的真正原因。 - 发起人必须是管理员或
allow.private里的白名单好友；白名单好友不受"刚说过话"的窗口限制（2026-10-24 放宽，群里直接可发）。只有「管理员但不在白名单」的号才需要 15 分钟内本人发过言。被拒时桥接会返回理由，照抄理由回给对方即可。 - 目标必须是
allow.private里的好友；不在白名单就直说「他没在白名单里」。 - 内容按原话写，不要加戏；单条最多 500 字。
- 发完不复述内容、不编造对方的回复。
必须用的工具
调用当前会话的 qq_dsh_inbox：
textkey: 当前会话 key（private:100000001 或 group:100000003） token: 本轮唤醒提示里的【会话令牌】 text: 结构化任务，见下
text 建议写成：
text【管理员转交】 来源：<private:... / group:...> 管理员：<昵称/QQ> 要求：<原话，不要改写关键参数> 类型：<唱歌/点歌/改配置/其他> 发回：<同一个 private 或 group>
唱歌类要额外写清楚：
text类型：ACE 唱歌任务 要求：用 ACE 生成，成品按管理员要求裁剪，转 128kbps MP3 发回：<当前会话 key>
行为规则
- 只写传话箱，不要自己生成歌曲：不要调 ACE、不要调 GPT-SoVITS 唱歌、不要假装已经生成。
- 写完后短回一句：「已经放进传话箱了，worker 会处理。」不要复述内部实现。
- 来源即回传目标：私聊来的任务回私聊，群聊来的任务回群聊；不要把群聊任务私发，也不要把私聊任务发群。
- 非管理员说这些，统一拒绝：「这个要管理员权限哦。」
- 管理员说「转告 dsh」但没有给内容时，先问一句「要转告什么？」；有内容就直接写，不要反复确认。
- 不要把「唱歌」当普通语音；唱歌任务只走传话箱 + worker。
回执纪律（2026-10-25 加严）
管理员提过「转给 DSH 的回执时有时无」，所以：
- 必须真的调用
qq_dsh_inbox，不能只嘴上说「已转达」。 - 返回
ok: true才能说转成了；回执里的receipt带id=inbox-…，把这个 id 报给管理员（他据此核对送达）。 - 返回
ok: false或工具报错 → 直说「没转成 + 原因」，不要含糊带过，也不要编成功。 - 转达成功后回一句短的即可，例如：「转到了，回执 id
inbox-179…」。不用复述内容。 - 管理员问「到底转了没有」时，如果当时没留 id，就说「我不确定，重发一次」并重新调用工具——宁重重一次，别猜。
示例
管理员私聊：「转告 dsh，把 GPT 语音语速调到 0.85」
→ qq_dsh_inbox({ key: "private:100000001", token, text: "【管理员转交】\n来源：private:100000001\n管理员：年银滔\n要求：把 GPT 语音语速调到 0.85\n类型：改配置\n发回：private:100000001" })
管理员群里：「大肥鱼唱首摇篮曲」
→ qq_dsh_inbox({ key: "group:100000003", token, text: "【管理员转交】\n来源：group:100000003\n管理员：<昵称>\n要求：唱一首摇篮曲，20 秒，ACE 直出，128kbps MP3\n类型：ACE 唱歌任务\n发回：group:100000003" })
出处与署名
这份文档由 NOYOT 整理编写，不是它描述的工具的作者。
它讲的工具来自：Derpyu520/qq-bridge 的传话箱与代发私信通道。
请去原作者仓库下载、按原作者文档操作；觉得好用就给原作者点个星。 如果本文件里有说错的地方，是整理者的问题，不是原作者的问题。
