管理员私聊代发

管理员私聊代发功能（/cosinside）让管理员通过 Bot 私聊向预先配置的 Telegram 群发送一段文字。它只接受配置的别名，不接受命令正文中的原始 chat ID，减少误发到任意群的可能。

配置目标

在 Bot 编辑页的“私聊代发目标”中添加目标。每个目标包含：

• 一个 1–32 位的别名，只能使用字母、数字、连字符和下划线；
• 一个 Telegram 群 ID，必须是负整数；
• Bot 已加入该群，并拥有发言权限。

面板会优先展示 Bot 已经识别到的群，也允许管理员手动填写群 ID。手动填写时，请从 Telegram 或实例日志中核对 ID，保存后先发送一条无敏感内容的测试消息。最多可以配置 20 个目标，别名不区分大小写且不能重复。

没有目标时，/cosinside 会提示尚未配置；清空目标并保存会停用这个入口。保存目标后，正在运行的 Bot 可能会自动重启以应用配置。

命令格式

/cosinside <别名> <正文>
/cosinside <别名> reply:<消息ID> <正文>

例如：

/cosinside ops 明早九点发布维护通知
/cosinside ops reply:1234 请在这条消息下补充结果

如果只配置了一个目标，可以省略别名：

/cosinside 单一目标的通知正文

reply:<消息ID> 会把代发消息作为目标群中指定消息的回复。这个消息 ID 必须属于目标群，Telegram 无法接受时会按发送失败处理。代发目前只支持纯文本命令，不支持把命令写在图片或文件 caption 中。

权限和限制

命令只应在管理员私聊中使用；服务端和 Bot 运行时都会检查管理员身份。单条正文最多 4,000 个字符；每个管理员每 60 秒最多尝试 5 条。超长、未知别名、没有目标或频率超限时，不会向目标群发送消息。

审计记录只保存目标、别名、发起人、正文长度、是否有回复目标和成功/失败结果，不保存正文。分享诊断日志时仍应检查其他上下文，避免把私聊原文贴到公开场所。

发送和历史是两个结果

发送成功后，如果目标群启用了对话历史，服务会将这条消息写入上下文，并保存发起人的 Telegram ID 和显示名。AI 在后续上下文中会看到它是“管理员代发的人类消息”，不会把它误记成 Bot 自己的上一轮回答。

面板或配置关闭目标群的对话历史时，消息仍会发送，但不会进入 AI 上下文。若 Telegram 发送已经成功、历史写入随后失败，Bot 会提示“已代发但历史保存失败”，不会为了补写历史而再次发送同一条消息。若 Telegram 发送本身失败，则返回截断后的失败原因，不应把同一请求盲目重试多次。

上线前检查

1. 只添加确实需要的目标群，并为每个目标使用清晰别名。
2. 用无敏感内容测试普通发送和 reply: 发送。
3. 在目标群确认 Bot 能发言、回复落在正确消息下。
4. 若需要让 AI 看到代发内容，确认该群的对话历史已启用。
5. 查看审计结果时只核对目标、长度和状态，不要求日志包含正文。