配置说明

配置文件支持 yaml、json、toml 格式，按顺序查找 config.yaml > config.yml > config.toml > config.json。

顶层字段

字段	类型	说明
users	UserConfig[]	监控的 Twitter 用户列表
discord	DiscordConfig	Discord 机器人配置
telegram	TelegramConfig	Telegram 机器人配置
twitter	TwitterConfig	Twitter API 认证配置
webui	WebUIConfig	Web 管理界面配置
enableApproval	boolean	是否启用审批机制
sendAsImage	boolean	是否将推文渲染为图片发送
xToImageApiUrl	string	推文转图片 API 地址
xToImageApiToken	string	推文转图片 API Token
xToImageApiTheme	string	图片主题: light / dim / dark
imageCacheTtlMinutes	number	图片缓存时间（分钟）
pollIntervalMinutes	number	轮询间隔（分钟）
maxPostsPerFetch	number	每次获取最大推文数
maxTweetAgeMinutes	number	推文最大时效（分钟）
groups	GroupConfig[]	推送群组配置
plugins	PluginConfigEntry[]	插件配置
pluginsDir	string | string[]	外部插件目录

users - 监控用户

users:
  - username: elonmusk          # Twitter 用户名（不含 @）
    displayName: Elon            # 显示名称（可选）
    filters:
      keywords:
        include: [tesla, spacex]  # 包含关键词
        exclude: [ad]             # 排除关键词
      media:
        requireMedia: true        # 要求推文包含媒体
      excludeRetweets: true       # 排除转推
      excludeReplies: true        # 排除回复

discord - Discord 机器人

discord:
  enabled: true
  token: YOUR_DISCORD_BOT_TOKEN
  embedColor: "#1DA1F2"

telegram - Telegram 机器人

telegram:
  enabled: true
  token: YOUR_TELEGRAM_BOT_TOKEN
  parseMode: HTML
  apiRoot: ""                     # 自定义 API 地址（可选）

twitter - Twitter 认证

支持两种认证方式，优先使用 Cookie：

# 方式一：Cookie 认证（推荐）
twitter:
  authToken: "your_auth_token"
  ct0: "your_ct0"

# 方式二：用户名/密码登录
twitter:
  username: "your_username"
  password: "your_password"
  email: "your_email"             # 可选，部分账号需要
  totpSecret: "your_totp_secret"  # 可选，双因素认证

webui - Web 管理界面

webui:
  enabled: true
  port: 3000
  host: "0.0.0.0"
  password: "your_password"       # 留空不设密码

groups - 推送群组

groups:
  - name: my-group
    users:
      - username: "*"              # * 表示所有顶层 users
      # 或指定具体用户
      - username: elonmusk
        displayName: Elon
        filters:
          media:
            requireMedia: true
    discord:
      channelId: "1234567890"
      r14ChannelId: "1234567891"   # R14 评级推送频道（可选）
    telegram:
      chatId: "-1001234567890"
      targets:
        r14:
          chatId: "-100_R14_CHAT_ID"
    approval:
      discordAdminChannelId: "1234567892"
      discordApproveRoleId: "1234567893"
      telegramAdminChatIds:
        - "111111111"
    blockedUsers: []               # 该群组拉黑的用户

用户展开规则

• 群组 users 中使用 username: "*" 会展开为顶层 users 列表中的所有用户
• 群组内也可以写具体用户名，覆盖该用户在群组内的过滤器
• 用户被推送到群组的前提是满足群组过滤器和用户自身过滤器

环境变量覆盖

以下环境变量可覆盖配置文件中的敏感字段：

环境变量	对应配置
AI_API_URL	plugins[].options.apiUrl
AI_API_KEY	plugins[].options.apiKey
AI_WEB_SEARCH_API_KEY	plugins[].options.webSearch.apiKey
TWITTER_AUTH_TOKEN	twitter.authToken
TWITTER_CT0	twitter.ct0
TWITTER_USERNAME	twitter.username
TWITTER_PASSWORD	twitter.password
TWITTER_EMAIL	twitter.email
TWITTER_TOTP_SECRET	twitter.totpSecret
X_TO_IMAGE_API_URL	xToImageApiUrl
X_TO_IMAGE_API_TOKEN	xToImageApiToken