# ================================
# 用户消息转发机器人配置样例
# User Forward Bot Configuration
# ================================

# ------------------
# 必填配置项
# ------------------

# Telegram Bot Token (必填)
# 从 @BotFather 获取
FORWARD_BOT_TOKEN=your_bot_token_here

# 目标群组ID列表 (必填)
# 支持多个群组，用逗号分隔
# 获取方式: 将机器人加入群组后，使用 @username_to_id_bot 或类似工具获取群组ID
# 注意: 群组ID通常是负数
#
# 支持论坛群组(Forum Groups)的Topic功能:
# 格式1: 仅群组ID，发送到群组主区域
#   FORWARD_TARGET_GROUPS=-1001234567890
#
# 格式2: 群组ID:Topic ID，发送到指定topic
#   FORWARD_TARGET_GROUPS=-1001234567890:123
#
# 格式3: 混合使用，支持多个群组和topic
#   FORWARD_TARGET_GROUPS=-1001234567890:123,-1009876543210,-1005555555555:456
#   第一个群组的topic 123，第二个群组的主区域，第三个群组的topic 456
#
# 用户自定义转发目标:
#   配置多个目标后，用户可以使用 /settopic 命令选择要转发到哪些目标
#   默认会转发到所有配置的目标
FORWARD_TARGET_GROUPS=-1002488739133,-1002488739133:1182,-1002488739133:51783,-1002488739133:87911,-1002488739133:1176,-1002488739133:1186=优化建议

# 目标群组名称映射 (可选)
# 为每个群组/topic设置友好的中文名称
# 格式: 群组ID=名称 或 群组ID:TopicID=名称
# 多个映射用逗号分隔
# 例如:
#   FORWARD_TARGET_NAMES=-1001234567890=技术讨论群,-1001234567890:100=Bug反馈,-1001234567890:200=功能建议
# 如果不配置，会显示原始ID
FORWARD_TARGET_NAMES=-1002488739133=主群,-1002488739133:1182=晒单区,-1002488739133:51783=经验分享,-1002488739133:87911=行情分享,-1002488739133:1176=问题反馈,-1002488739133:1186=优化建议


# ------------------
# 可选配置项
# ------------------

# 授权用户ID列表 (可选)
# 只有列表中的用户可以使用机器人
# 用逗号分隔多个用户ID
# 获取用户ID: 使用 @username_to_id_bot 或类似工具
# 留空则需要开启公开模式
FORWARD_ALLOWED_USERS=123456789,987654321

# 管理员用户ID列表 (可选)
# 管理员可以使用 /adduser、/removeuser、/listusers 等命令
# 用逗号分隔多个管理员ID
FORWARD_ADMIN_USERS=123456789

# 公开模式 (可选，默认: false)
# true: 所有用户都可以使用机器人
# false: 只有授权用户和管理员可以使用
FORWARD_PUBLIC_MODE=false

# 发送者署名 (可选，默认: true)
# true: 转发消息时添加发送者信息和时间戳
# false: 不添加署名，仅转发原始内容
FORWARD_ADD_SENDER=true


# ------------------
# 配置说明
# ------------------

# 如何获取 Bot Token:
# 1. 在 Telegram 中找到 @BotFather
# 2. 发送 /newbot 创建新机器人
# 3. 按提示设置机器人名称和用户名
# 4. 复制获得的 Token

# 如何获取群组ID:
# 1. 将机器人添加到目标群组
# 2. 使用 @username_to_id_bot 或 @getidsbot
# 3. 将这些bot添加到群组，它们会显示群组ID
# 或者使用以下方法:
# 1. 将 @RawDataBot 加入群组
# 2. 发送任意消息，bot会返回包含chat.id的JSON数据

# 如何获取Topic ID (论坛群组):
# 1. 在群组设置中启用"Topics"功能
# 2. 创建需要的topic
# 3. 在topic中发送消息，使用 @RawDataBot 查看
# 4. 查找 message_thread_id 字段，这就是 Topic ID
# 5. 或者在网页版Telegram中，topic的URL包含topic ID
#    例如: https://t.me/c/1234567890/123
#    其中 123 就是 topic ID

# 如何获取用户ID:
# 1. 使用 @username_to_id_bot
# 2. 或使用 @userinfobot
# 3. 发送消息给这些bot即可获取自己的ID

# 权限模式选择:
# - 私有模式 (FORWARD_PUBLIC_MODE=false):
#   需要在 FORWARD_ALLOWED_USERS 中添加用户ID
# - 公开模式 (FORWARD_PUBLIC_MODE=true):
#   任何人都可以使用，适合公开服务


# ------------------
# 使用示例
# ------------------

# 示例1: 单个群组，私有模式
# FORWARD_BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
# FORWARD_TARGET_GROUPS=-1001234567890
# FORWARD_ALLOWED_USERS=123456789,987654321
# FORWARD_ADMIN_USERS=123456789
# FORWARD_PUBLIC_MODE=false
# FORWARD_ADD_SENDER=true

# 示例2: 多个群组，公开模式
# FORWARD_BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
# FORWARD_TARGET_GROUPS=-1001234567890,-1009876543210,-1005555555555
# FORWARD_PUBLIC_MODE=true
# FORWARD_ADD_SENDER=false

# 示例3: 使用论坛群组的topic功能（带中文名称）
# FORWARD_BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
# FORWARD_TARGET_GROUPS=-1001234567890:123,-1001234567890:456
# FORWARD_TARGET_NAMES=-1001234567890:123=Bug反馈,-1001234567890:456=功能建议
# 消息会分别发送到"Bug反馈"和"功能建议"两个topic

# 示例4: 混合使用普通群组和论坛topic（带中文名称）
# FORWARD_BOT_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
# FORWARD_TARGET_GROUPS=-1001234567890,-1009876543210:100,-1009876543210:200
# FORWARD_TARGET_NAMES=-1001234567890=技术讨论群,-1009876543210:100=产品反馈,-1009876543210:200=客服咨询
# 第一个是普通群组"技术讨论群"，后两个是论坛topic