ig-caption
此資料夾中只有一個工具，執行方式如下：
python3 caption.py caption.txt
python3 caption.py caption.py --keywords "client proposals,agency pricing"
它會按照動態牆的顯示方式輸出說明：前 125 個字元放在一個方框中，其餘內容則放在點擊「更多」之後。在閱讀你寫的其他內容之前，先讀那個方框。
第一步：決定這則說明的任務
這個決定若被跳過，往往會毀掉整則說明。
任務 A：影片已經鉤住觀眾。 Reel 本身在前兩秒就靠語音和畫面提供了鉤子。說明不是第二個鉤子，和影片競爭只會兩頭落空。它的任務是行動呼籲、讓行動呼籲合理的背景說明，以及人們會搜尋的詞語。
任務 B：說明本身就是內容。 一張照片、單圖、或一個開啟懸念的輪播封面。此時第一行就是鉤子，其運作方式與 Reel 鉤子完全相同：具體、簡短，並且在懸崖邊切斷，而非在句子中間。
先確定你正在寫哪一種。如果使用者有附帶強鉤子的 Reel，就選擇任務 A 並說明原因。
結構
第一行 125 個字元的可見空間。任務 A：直接寫出行動呼籲。
任務 B：寫下鉤子。
絕對不是問候語、不是主題標籤、也不是以表情符號開頭。
正文 短段落，段落之間留一行空白。兩到六段。搜尋關鍵詞放在這裡。
行動呼籲 一個。留言關鍵字、儲存、或傳送私訊。只能有一個。
主題標籤 最多五個，放在最後一行，獨立成行，或者完全不加。
字數上限為 2,200 個字元，但幾乎沒有任何說明需要 2,200 字。一篇值得點擊「更多」、然後用 600 字內容兌現承諾的說明，勝過一篇 1,800 字卻無聊的說明。
關於主題標籤：老實說
主題標籤已不再是觸及槓桿，平台也透過產品更新明確說明了。Instagram 於 2025 年 12 月 18 日將每篇貼文的主題標籤上限從三十個縮減為五個，並告訴創作者「使用較少（最多五個）更精準的主題標籤，而非大量通用標籤」能獲得更好表現。Adam Mosseri 早在 2025 年 2 月就說過，主題標籤無法增加觸及，它們是標籤，而非分發槓桿。
因此：最多五個、具體、作為主題標籤。如果使用者的備忘錄裡還存著二十個標籤的區塊，那塊內容現在已是累贅，語法檢查工具會將它標記為失敗。
#viral、#fyp、#explorepage、#foryou 無法描述任何內容。刪掉它們。
搜尋關鍵詞現在比主題標籤更重要
Instagram 搜尋會讀取說明文字。因此，使用者希望被找到的詞語，應該以一般人會輸入的短語形式，放在一個讀起來自然的句子中。例如「client proposals」作為第三行的文字，而不是「#clientproposals」放在底部的標籤區塊。
要求使用者提供兩三個這類關鍵詞，然後將它們傳給語法檢查工具：
python3 caption.py draft.txt --keywords "client proposals,agency pricing"
規則
- 說明中不要放連結。 說明無法點擊。正文中的網址只是無效文字，顯示「我不會使用這個平台」。請放在個人檔案或要求傳送私訊。
- 一個行動呼籲。 兩個行動呼籲等於沒有。
caption.py會計算數量。 - 關鍵字類的行動呼籲需要一個使用者能打出的關鍵字。 一個單字、無空格、無表情符號，並在影片中也大聲說出來。
留言 CONTRACT有效。留言「合約指南」則無效。 - 如果有連結，請另外撰寫第一則留言。 並在收據中說明。
- 表情符號作為標點，而非裝飾。 語法檢查工具會標記任何每 100 字元超過 4 個表情符號的情況。
- 替代文字值得花 20 秒撰寫。 對於輪播和照片，請撰寫替代文字。螢幕閱讀器和 Instagram 都會讀取它。
流程
- 決定任務 A 或任務 B，並說明選擇。
- 草擬內容。
- 執行
/ig-human檢查。說明很短，因此垃圾文字在這裡比包裝中任何其他地方都更刺眼。 - 使用使用者的搜尋關鍵詞執行
caption.py。修正所有標記為 FAIL 的項目。對於所有標記為 WARN 的項目，請大聲決定處理方式，而不是默默放過。 - 輸出可複製的完整區塊，接著輸出收據：
說明已準備就緒
工作： A - Reel 提供鉤子
可見字元： 125 字元中使用 118 字元後截斷
行動呼籲： 一個，留言 CONTRACT
主題標籤： 3 個
搜尋： "client proposals" 位於第 3 行，"agency pricing" 位於第 5 行
語法檢查： 已通過
不會進行發布。由使用者自行貼上。