ig-caption 是做什麼的？
此資料夾中有一個工具，執行方式如下：
python3 caption.py caption.txt
python3 caption.py caption.txt --keywords "client proposals,agency pricing"
它會按照 Instagram 的顯示方式輸出說明：前 125 個字元放在一個框內，其餘內容在點擊「更多」後顯示。在閱讀你撰寫的其他內容之前，先閱讀那個框。
首先，決定這個說明的任務
這是許多說明失敗的關鍵——跳過此步驟往往會導致失敗。
任務 A：影片本身已經抓住觀眾。Reels 的前兩秒就透過語音和畫面提供了鉤子。說明不是第二個鉤子，與影片競爭只會兩敗俱傷。它的任務是行動呼籲、讓行動呼籲合理的上下文，以及人們會搜尋的關鍵字。
任務 B：說明本身就是內容。一張照片、單一圖片、或打開一個敘事圈的輪播封面。此時第一行就是鉤子，其作用方式與 Reels 鉤子完全相同：具體、簡短，並在懸念處戛然而止，而非句中。
確認你正在撰寫哪一種。如果使用者有附帶強烈鉤子的 Reels，請選擇 A 並說明原因。
結構
Line 1 125 個字元的可見空間。任務 A：直接提出行動呼籲。
任務 B：鉤子。
永遠不要用問候、標籤或表情符號作為第一個字元。
Body 短段落，每段之間留一行空白。二到六段。
這是放置搜尋詞的地方。
The ask 一個行動呼籲：留言關鍵字、儲存或私訊。
Hashtags 最多五個，放在最後獨立一行，或是完全不放。
字數上限為 2,200 字元，但幾乎沒有內容需要用到 2,200。一篇值得點擊、且內容紮實的 600 字說明，遠勝過一篇 1,800 字的說明。
關於標籤，老實說
標籤已不再是推廣觸及率的工具，Instagram 也透過產品改動證實了這點。Instagram 於 2025 年 12 月 18 日將每篇貼文的標籤上限從三十個縮減為五個，並告訴創作者「使用更少（最多五個）、更具針對性的標籤，而非大量通用標籤，表現會更好」。Adam Mosseri 早在 2025 年 2 月就表示，標籤無法提升觸及率，它只是標籤而非分發工具。
因此：最多五個、具體的主題標籤。如果使用者在筆記應用程式中存了二十個標籤，那整段現在都是無效資訊，語法檢查器會將它標記為失敗。
#viral、#fyp、#explorepage、#foryou 這些標籤無法描述任何內容。刪掉它們。
搜尋詞現在比標籤更重要
Instagram 搜尋會讀取說明文字。因此，使用者希望被搜尋到的詞語，應以人類會輸入的方式、在自然流暢的句子中出現在說明裡。例如「客戶提案」寫在第三行的文字中，而不是在底部寫成 #clientproposals。
詢問使用者兩個或三個搜尋詞，然後將它們傳遞給語法檢查器：
python3 caption.py draft.txt --keywords "client proposals,agency pricing"
規則
- 說明內不可放連結。 說明無法點擊。內文中的 URL 只是死文字，顯示「我不會用這個平台」。請放個人檔案或引導私訊。
- 一個行動呼籲。 兩個行動呼籲等於沒有。
caption.py會計算數量。 - 關鍵字型行動呼籲需要一個可輸入的關鍵字。 一個詞、無空格、無表情符號，並且在影片中也說出來。
留言 CONTRACT有效；留言 "the contract guide"無效。 - 如果有連結，請另外撰寫第一則留言。 並在收據中說明。
- 表情符號作為標點，而非裝飾。 語法檢查器會標記每 100 個字元超過 4 個表情符號的情況。
- 替代文字值得花 20 秒。 對於輪播圖和照片，請撰寫替代文字。它會被螢幕閱讀器和 Instagram 本身讀取。
流程
- 決定任務 A 或任務 B，並說明選擇。
- 草擬說明。
- 對它執行
/ig-human。說明篇幅短，因此內容空洞在這裡比其他任何地方都更明顯。 - 使用使用者的搜尋詞執行
caption.py。修正所有 FAIL。對每個 WARN 做出明確決定，而不是默默忽略。 - 輸出可直接複製的文字區塊，然後是收據：
說明已準備就緒
任務： A - Reels 作為鉤子
可見字數： 118 / 125 個字元（截斷前）
行動呼籲： 一個，留言 CONTRACT
標籤： 3 個
搜尋詞： 第 3 行「客戶提案」、第 5 行「代理商定價」
語法檢查： 已通過
不會自動發佈。使用者會自行貼上。