Buhuaguo Post X

Script Reference

Post Type Selection

Unless the user says otherwise:

• Plain text content: use Regular Post
• Markdown file: use X Article
• Explicit tweet URL + comment: use Quote Tweet
• Explicit video file: use Video Post

Regular Posts

${BUN_X} {baseDir}/scripts/x-browser.ts "Hello!" --image ./photo.png

Behavior:

• Copies the post text to the clipboard
• Appends image placeholders like [Image: photo.png]
• Prints the absolute local image paths in the terminal output

Parameters:

• <text>: post content
• --image <path>: local image file, repeatable, max 4

Video Posts

${BUN_X} {baseDir}/scripts/x-video.ts --video ./clip.mp4 "Check this out!"

Behavior:

• Copies the post text to the clipboard
• Appends a video placeholder like [Video: clip.mp4]
• Prints the absolute local video path in the terminal output

Parameters:

• <text>: post content
• --video <path>: required local video file

Quote Tweets

${BUN_X} {baseDir}/scripts/x-quote.ts https://x.com/user/status/123 "Great insight!"

Behavior:

• Copies only the quote comment to the clipboard
• Prints the target tweet URL in the terminal output for manual quote-tweet flow

Parameters:

• <tweet-url>: target tweet URL
• <comment>: optional quote comment

X Articles

${BUN_X} {baseDir}/scripts/x-article.ts article.md
${BUN_X} {baseDir}/scripts/x-article.ts article.md --cover ./cover.jpg

Behavior:

• Parses the Markdown article
• Downloads remote article images into a local cache when needed
• Copies the article body to the clipboard
• Replaces inline images with filename placeholders like [Image: chart.png]
• Renders Markdown tables into local PNG images because X Articles do not preserve pasted HTML tables
• Writes an ordered image manifest so x-article-image.ts can copy the next image for insertion
• Generates short helper commands next to the article, such as ./xa-next and ./xa-cover
• Prints the resolved article title, cover image, and local content-image paths in the terminal output

Image helper:

${BUN_X} {baseDir}/scripts/x-article-image.ts article.md --next
${BUN_X} {baseDir}/scripts/x-article-image.ts article.md --copy-cover
cd /path/to/article-dir && ./xa-next
cd /path/to/article-dir && ./xa-cover

Behavior:

• Copies the cover image to the clipboard with --copy-cover
• Copies the next pending article image to the clipboard
• Advances the pointer automatically
• Supports --peek, --prev, --status, --reset, --index <n>, and --open-folder

Parameters:

• <markdown>: Markdown file
• --cover <path>: override cover image with a local file
• --title <text>: override title

Frontmatter supported:

• title
• cover_image
• cover
• image

Local Media Requirement

• Regular posts and video posts still expect explicit local files.
• X Articles may contain remote image URLs; the script will download them into a local .buhuaguo-post-x-assets/ cache next to the Markdown file before generating placeholders.
• Missing local files should still fail fast.

Notes

• The clipboard draft is the primary output
• The user is responsible for opening X, pasting the draft, and inserting the actual media files
• Deprecated flags like --submit and --profile may still appear in old habits; scripts should ignore them with a warning instead of automating anything

References

• See references/regular-posts.md for the manual posting workflow
• See references/articles.md for the Markdown article workflow