ig-caption 是做什么的？
该文件夹中只有一个工具，运行：
python3 caption.py caption.txt
python3 caption.py caption.txt --keywords "client proposals,agency pricing"
它输出文案的方式与 Instagram 信息流展示方式一致：前 125 个字符显示在一个框中，其余内容需要点击展开才能查看。在阅读你写的其他内容之前，先读那个框。
首先，确定这条文案的工作类型
这一步如果跳过，会毁掉很多文案。
工作 A：视频本身已抓住观众。 Reel 在前两秒内已经通过语音和画面传递了钩子。文案不是第二个钩子，与视频争夺注意力会让两者皆输。它的任务是行动号召、让行动号召顺理成章的背景，以及用户会搜索的关键词。
工作 B：文案本身就是内容。 对于照片、单张图片或轮播图封面，文案需要先抛出钩子。这里第一行是钩子，它的工作方式与 Reel 钩子完全一样：具体、简短，并在悬念处戛然而止，而不是在句子中间。
判断你正在写哪种。如果用户有一个钩子很强的 Reel，就选 A 并解释原因。
结构
第一行 125 个可见字符空间。工作 A：直接提出行动号召。
工作 B：钩子。
永远用问候语、标签或表情符号开头。
正文 短段落，每段之间留一个空行。两到六段。搜索词应放在这里。
行动号召 一次。评论关键词、保存帖子或发私信。只做一件事。
标签 最多五个，单独放在底部一行，或不放。
总字数限制为 2,200 个字符，但几乎没有内容需要用到 2,200 个字符。一篇能够吸引用户点击展开、然后提供 600 个字符的文案，胜过一篇提供 1,800 个字符但内容冗余的文案。
关于标签，实话实说
标签不再能用来扩大触达范围，平台已通过产品升级明确表明这一点。Instagram 于 2025 年 12 月 18 日将每篇帖子的标签数量上限从 30 个降至 5 个，并告诉创作者“使用更少（最多 5 个）、更具针对性的标签，而不是许多通用标签”效果更好。Adam Mosseri 早在 2025 年 2 月就已表示，标签不能用来扩大触达范围，它们只是标签，而不是分发杠杆。
所以：最多五个、具体的、作为话题标签。如果用户在他们笔记应用里保存了二十个标签，那现在这些标签就是累赘，检查工具会将其标记为不合规。
#viral、#fyp、#explorepage、#foryou 没有描述任何具体内容。删掉它们。
搜索词现在比标签更重要
Instagram 搜索会读取文案正文。因此，用户希望被找到的短语，应该作为人类会键入的短语，自然地出现在文案的句子中。例如，“客户提案” 这个词组写在第三行，而不是把 “#客户提案” 放在底部的标签块里。
要求提供两到三个这样的搜索词，然后将它们传递给检查工具：
python3 caption.py draft.txt --keywords "client proposals,agency pricing"
规则
- 文案中不要放链接。 文案中的链接不可点击。正文里的 URL 是无效文字，它表明“我不会用这个平台”。链接应放在个人简介或通过私信发送。
- 一次行动号召。 两次行动号召等于没有。
caption.py会统计行动号召次数。 - 关键词行动号召需要一个用户可以输入的词。 一个词，没有空格，没有表情符号，同时在视频中大声说出来。
Comment CONTRACT有效。Comment "the contract guide"无效。 - 如果有链接，单独写第一条评论。 并在确认报告中说明。
- 表情符号作标点用，不要作装饰。 检查工具会标记出每 100 个字符中超过 4 个表情符号的情况。
- 替代文本值得花 20 秒。 对于轮播图和照片，写替代文本。屏幕阅读器和 Instagram 都会读取它。
工作流程
- 判断是工作 A 还是工作 B，并告知用户。
- 草拟文案。
- 对文案运行
/ig-human。文案很短，所以低质量内容在文案中的影响比在包中其他任何地方都大。 - 使用用户的搜索词运行
caption.py。修复每一个 FAIL。对于每个 WARN，都要明确做出判断，而不是保持沉默。 - 输出可直接复制的文案块，然后是确认报告：
文案就绪
工作类型： A - Reel 承载钩子
可见字符数： 125 个字符中有 118 个在截断前显示
行动号召： 一次，评论 CONTRACT
标签： 3 个
搜索词： 第 3 行中的 “client proposals”，第 5 行中的 “agency pricing”
检查状态： 就绪
不会自动发布任何内容。用户负责粘贴文案。