X Manager 是一款面向 X（原 Twitter）账号的管理工具，主要用途是帮助用户完成账号运营中的常见操作，包括内容发布、互动、信息获取与数据分析。
主要能力
-
发帖：通过脚本发布推文，支持附带图片。单条推文最多 280 个字符，对于 Premium/Enterprise 账号，较长的推文会自动拆分。
-
互动：支持点赞、回复和转推指定推文。
-
数据检索：可获取指定用户的推文、查看时间线，以及按关键词搜索推文，并可通过参数控制返回数量。
-
自动互动工作流：可在 state/{USER_ID}.json 中配置自动回复功能，包括启用开关、关键词列表和回复模板，模板中可使用 {username} 和 {keyword} 等占位符。
使用方式
该工具采用多用户架构，每个用户的凭据存储在 credentials/{USER_ID}.json 文件中，结构包含 twitter 对象下的 api_key、api_secret、access_token、access_token_secret 和 bearer_token 字段。如果用户尚未配置 Twitter 凭据，工具会提示其先绑定 X 账号。也可以通过环境变量设置：TWITTER_API_KEY、TWITTER_API_SECRET、TWITTER_ACCESS_TOKEN、TWITTER_ACCESS_TOKEN_SECRET、TWITTER_BEARER_TOKEN。
各项操作通过命令行脚本完成，例如：
发帖：python3 {baseDir}/scripts/post_tweet.py <USER_ID> "<tweet content>" [--media <image_path>]
点赞：python3 {baseDir}/scripts/like_tweet.py <USER_ID> <tweet_id>
回复：python3 {baseDir}/scripts/reply_tweet.py <USER_ID> <tweet_id> "<reply content>"
转推：python3 {baseDir}/scripts/retweet.py <USER_ID> <tweet_id>
获取用户推文：python3 {baseDir}/scripts/get_user_tweets.py <USER_ID> <twitter_handle> [--count <n>]
获取时间线：python3 {baseDir}/scripts/get_timeline.py <USER_ID> [--count <n>]
搜索推文：python3 {baseDir}/scripts/search_tweets.py <USER_ID> "<keywords>" [--count <n>]
适用场景
适合需要批量或自动化管理 X 账号的用户，例如内容发布、日常互动维护、关键词监控与自动回复、以及账号数据分析等场景。
限制与注意事项
工具涉及 Twitter API 的层级限制：Free 层级仅支持读取，不能发帖；Premium 层级（每月 100 美元）支持发帖和数据分析；Enterprise 层级提供更高的限额。错误处理方面，遇到 API 速率限制时会提示用户等待后重试；认证失败时会提示用户重新绑定 X 账号；推文过长时会自动拆分或提示用户缩短。