koishi-plugin-message-relay

私聊转发到群插件。你和机器人私聊时：

• 发送 整活开始 [群名或群号] [模仿 <对方QQ>] → 机器人开始把你之后的私聊内容转发到指定群
• 发送 整活结束 → 停止转发

⚠️ 隐私约定：所有状态反馈（成功/失败/提示）都只私发给你，绝不会发到群里。 群里只会出现你指定要转发的内容本身；模仿模式下，机器人会临时变成目标用户的头像+昵称来发送（结束时报原样恢复）。

功能

| 你私聊发的内容 | 效果 | | --- | --- | | 整活开始 box | 开始转发，之后你的私聊会发到名字叫 box 的群 | | 整活开始 760297328 | 开始转发到群号 760297328 | | 整活开始 box 模仿 123456 | 模仿 QQ 123456（改机器人头像+群名片）转发到 box 群 | | 整活开始 模仿 123456 | 模仿 123456 转发到 defaultGroup 默认群 | | 整活开始（不带参数） | 列出可用绑定名 | | 整活结束 | 停止转发 | | （转发模式中的普通消息） | 原样转发到目标群 |

配置说明

authorizedUsers（可用用户 QQ 号）

只允许列表里的 QQ 号使用本插件。留空 = 任何人不可用，必须在配置页填入你的 QQ 号。

groupBindings（群绑定：名字 → 群号）

| 列 | 说明 | | --- | --- | | name | 绑定名，如 box | | groupId | 群号，如 760297328 |

这样你就能用 整活开始 box 代替记一串群号。也支持直接填群号。

startCommand / endCommand

自定义开始/结束指令（默认 整活开始 / 整活结束）。

defaultGroup

默认转发群（绑定名或群号）。当 整活开始 模仿 <qq> 没带群时，转发到该群。

prefix

转发时给消息加的前缀（可留空），如 [整活] → 群里看到 [整活] 大家好。

confirmForward

每条转发后是否私发一条 ✅ 确认（默认开）。关闭后转发静默，仍会私发错误提示。

mimicMethod（模仿方式）

• direct（默认）：改机器人 QQ 头像 + 群名片成目标用户，然后直发消息（不是卡片）。整活结束 时恢复原头像和名片。注意：改头像是对机器人账号的全局操作，QQ 可能有频率限制、头像刷新有延迟；且插件若在模仿期间崩溃/重启，头像不会自动恢复（需手动或重新 整活结束）。
• forward：用合并转发卡片伪装（不改头像），群里显示目标用户的转发卡片。

安装

1. 将本文件夹放入 Koishi 插件目录，或控制台「插件管理 → 添加 → 本地插件」。
2. 启用插件，在配置页填 authorizedUsers（你的 QQ）和 groupBindings（box → 群号）。
3. 私聊机器人：整活开始 box 试试。

说明

• 只在私聊里生效，群聊消息不受影响。
• 只有 authorizedUsers 里列出的 QQ 能使用指令。
• 转发按用户独立：多个授权用户可同时各自转发到不同群。
• 插件重启后转发状态会清空，需重新 整活开始。