用途:在 mphinance 仓库中,一条命令把一个主题变成完整的 Substack 文章包。从仓库根目录运行(如不在根目录,先 cd /home/mph/mphinance)。它本身没有独立脚本,而是读取仓库文件(VOICE.md、SUBSTACK.md、docs/...)并写入 docs/articles/<slug>/。
主要能力:生成 README.md 文章正文,遵循 SUBSTACK.md 的结构骨架(标题、Tags 行、主图占位、粗体开场、背景、数据主体、教学转折、付费点、订阅 CTA、结尾与分节线);生成 generate_images.py(matplotlib 深色终端风格图,至少 hero_banner.png 与 2 张信息图),运行后产出图片;生成 notes_teaser.md、subject_lines.md 与含 7 种格式的 promo_notes.csv(列:day_offset、time_et、format、note_text)。
必要用法:先阅读 VOICE.md、SUBSTACK.md、docs/api/daily-picks.json、landing/blog/blog_entries.json(最近 5 条)、substack_social/prompts/sam_notes_step3.md;若主题与轮动或交易相关,还要读 docs/backtesting/track_record.json 及同类文章样例。步骤为:Slug 化并建目录、写文章、写并运行图片脚本、生成三个小文件、自检与摘要。完成后可运行 python3 draft_to_substack.py <slug> 上传为 Substack 草稿。
限制:禁止使用长破折号(—),全文必须为 0;不用反问句、公司式开场、"Here's the truth" 等套话;数据句必须引用真实数字,不得编造盈亏;不能写 markdown 表格(改用信息图);不能省略图片生成;不能输出到仓库根目录平铺文件;涉及实盘或推荐链接的文章必须在签名上方加斜体免责声明与披露。主题含糊时只问一次角度。