feat: Upload a sample photo via the client. Validate successful posting to Twitter.

[kwanRoshi]

Relates to

No issue linked (ensure to link related issues or tickets in future PRs).
Risks
Risk Level: Medium
Potential Risks: Misconfiguration of environment variables could cause API authentication failure.
Affected Areas: Twitter functionality, including posting photos, retweets, and likes.
Background
What does this PR do?
This PR adds functionality for a Twitter client, including:

Support for posting photos to Twitter.
Automatic retweets and likes based on keywords.
API authentication integration.
Configuration documentation.
Templates for environment variables.
Character file configuration for Twitter client.
What kind of change is this?
Feature: Non-breaking changes that add functionality.
Documentation changes needed?
Status: Documentation changes are required.
Actions Taken: Documentation for configuration and environment variables has been updated accordingly.
Testing
Where should a reviewer start?
Verify the Twitter client configuration documentation.
Test the environment variable templates.
Detailed testing steps
API Authentication Test:

Initialize the client with the provided API keys and tokens.
Confirm successful login.
Photo Posting Test:

Upload a sample photo via the client.
Validate successful posting to Twitter.
Keyword-Based Interaction:

Set keywords for retweets and likes in the configuration.
Observe and verify automatic actions based on these keywords.
Character Configuration Validation:

Load a sample character configuration file.
Verify seamless integration with the Twitter client.
Deploy Notes
No special deployment instructions; standard deployment process suffices.
Ensure all environment variables are set correctly before deployment.
Additional Information
Discord username
N/A (Please add your Discord username if you have one).

[kwanRoshi]

Twitter Client Configuration Guide Twitter Client Configuration Guide
Basic Setup Basic Setup
Environment Variables Environment Variables
Copy .env.example to .env
Copy .env.example to .env
Required Credentials Required Credentials
TWITTER_USERNAME=your Twitter username (do not include the @ symbol)
TWITTER_PASSWORD=your Twitter password
TWITTER_EMAIL=your Twitter email
TWITTER_API_KEY=your API key
TWITTER_API_SECRET=your API key secret
TWITTER_ACCESS_TOKEN=your access token
TWITTER_ACCESS_SECRET=your access token secret
TWITTER_BEARER_TOKEN=your bearer token
Optional Settings Optional Settings
MAX_TWEET_LENGTH=280 # Maximum length of a tweet
TWITTER_DRY_RUN=false # Test mode
TWITTER_SEARCH_ENABLE=false # Enable search
TWITTER_TARGET_USERS= # Target users
POST_INTERVAL_MIN=90 # Minimum post interval (minutes)
POST_INTERVAL_MAX=180 # Maximum post interval (minutes)
Character Configuration Add the following to the character file (.character.json):
{
"clients": ["twitter"],
"topics": ["Topic 1", "Topic 2"]
}
Features
✅ Photo posting
✅ Keyword-based retweets
✅ Auto-liking
✅ User authentication
Testing
Start with dry run mode
TWITTER_DRY_RUN=true
Check logs for authentication
Test basic functionality
Enable full features

[odilitime]

please don't remove all our READMEs

[kwanRoshi]

Oh sorry my bed Odilitime ***@***.***> 于2025年1月11日周六 11:36写道：

…

***@***.**** requested changes on this pull request. please don't remove all our READMEs — Reply to this email directly, view it on GitHub <#2130 (review)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AJ34OOV6VJGN2RDTQGDHNZD2KBDNTAVCNFSM6AAAAABU7A4WSSVHI2DSMVQWIX3LMV43YUDVNRWFEZLROVSXG5CSMV3GSZLXHMZDKNBUGEZTINRVGE> . You are receiving this because you authored the thread.Message ID: ***@***.***>