用途:把主题变成 Substack 草稿或已发布文章,输出到 mphinance.substack.com。默认 draft 模式只生成草稿;publish 模式会调用发布接口并触发订阅者邮件,不可撤销,必须得到明确确认后才执行。
主要能力:按 mph-substack-writer 的结构生成正文(标题、副标题、开场、背景、正文数据与配图、转折段、可选付费墙预告、固定结尾);读取语音语料与硬性规则;生成 slug(YYYY-MM-DD_kebab-case-title)与工作区 ~/.mph-substack-cache/<slug>/;用 mph-figure 把表格、对比卡片等 HTML 渲染为图片;推送时处理图片上传、ProseMirror 转换与封面图。
文章分类:builder(默认,构建类,不要 NFA)、trade(具体持仓,必须加 NFA 免责声明)、paid_tease(免费文加付费预告段)、recovery(个人反思,无 NFA)。
用法:草稿模式运行 python <pusher> <workspace>/post.md;发布模式加 --publish。pusher 脚本 create_draft_from_md.py 位于 mphinance 仓库,路径随机器不同(Windows 与 Coolify/Linux 各有指定位置,也可用 git rev-parse 或 find 定位)。脚本自动读取同仓库 secrets.env 以解析 SUBSTACK_SID。渲染命令为 node ~/.claude/skills/mph-figure/scripts/render.mjs --in <workspace>/foo.html --out <workspace>/foo.png --html。
硬性规则:署名固定为“— Michael”,订阅 CTA 仅放结尾并斜体;builder 文章不加 NFA;已发布草稿为唯一事实源,本地 markdown 不提交 git,不写入 docs/substack/drafts/。
已知问题:图片 400 多为过大或格式不支持,PNG 建议 2MB 以下;编辑器崩溃可能因不支持的 ProseMirror 节点;SUBSTACK_SID 过期需重新登录并更新 secrets.env。其他细节资料未提供。